Manual:LocalSettings.php/ru

Содержит специфические для каждой конкретной вики настройки (основан на файле ). Настоятельно рекомендуется ознакомиться с перечнем настроек, содержащихся в этом файле. Хотя сразу же после установки файл содержит работоспособную конфигурацию, довольно часто приходится вносить в него исправления вручную, главным образом связанные с работой веб-сервера Apache.

Изменения вносятся путём изменения значений переменных PHP. Перед тем как править LocalSettings.php полезно ознакомиться с особенностями синтаксиса PHP. Главные заключаются в том, что для чтения значения из переменной PHP к её имени добавляется префикс "$"; В логическом контексте значение всякой строки не равной     or.

Все изменения вступают в силу сразу же после сохранения - ничего перезапускать не нужно. В отдельных случаях требуется обновить кэш браузера.

Значения, установленные по умолчанию содержаться в includes/DefaultSettings.php (редактировать этот файл категорически запрещается - все изменения вносите в LocalSettings.php). Если интересующая вас переменная отсутствует в LocalSettings.php, скопируйте содержащую её строчку из DefaultSettings и далее правьте по своему усмотрению. Новые строки вставляйте после строчки 'require_once( "includes/DefaultSettings.php" );'.

Строки вида 'require_once( "расширение/расширение.php" );' представляют собой ссылки на расширения. Эти расширения могут потребовать запись новых переменных в файл LocalSettings.php;, прочитайте документацию по расширениям для получения дальнейших инструкций. Список расширений можно найти в «Матрице расширений.»


 * Не помещайте расширения перед строкой require_once( "includes/DefaultSettings.php" );; поскольку расширение установит массив функции, не вызывая никаких расширений для установки, и, тем самым, может сделать вики-сайт недоступным.
 * Не помещайте расширения перед строкой require_once( "includes/DefaultSettings.php" );</tt>; поскольку расширение установит массив функции, не вызывая никаких расширений для установки, и, тем самым, может сделать вики-сайт недоступным.

Ваша версия файла LocalSettings.php</tt> может не содержать в конце закрывающий PHP-тег ?&gt;</tt>. Это сделано специально, так как он мешает добавлять новeю информацию, после этого тега. PHP будет работать нормально без закрывающегося тэга.

Путь
Переменная $IP (include path) содержит полный путь к установленному программному обеспечению вики. В конце строки не должна стоять косая черта (слеш).

Программа ищет файл DefaultSettings.php в каталоге, указанном в переменной IP.

Название сайта
Переменная $wgSitename содержит имя Вашей вики. Эта переменная довольно часто используется. Например в строчке  "'Материал из Википедии, свободной энциклопедии."'.

Язык
Переменная $wgLanguageCode определяет используемый по умолчанию язык интерфейса движка Mediawiki. Зарегестрированные пользователи могут задавать язык в личных настройках.

Склонения названия сайта
Для флективных языков очень полезна возможность задать различные формы названия. Это можно сделать с помощью специальных переменнных. См.$wgGrammarForms.

Путь к программе
$wgScriptPath представляет собой URL, указывающий на основной скрипт MediaWiki. Должна соответствовать настройкам Apache, особеннно если используются rewrite rules.

Имя сервера
Переменная $wgServer представляет собой URL-префикс (например, 'http://www.mediawiki.org') позволяет обойти автоматическое определение имя сервера. В зависимости от того, откуда (из локальной сети, с того же самого компьютера или из интернета) получен запрос, e-mail notifications и некоторые другие автоматически генерируемые сообщения отправляются с различными URLs. Using  устанавливает неизменное имя сервера.

Для сервера с доменным именем www.example.com соответствующая строка имеет вид:

В синтаксисе Mediawiki предусмтрена переменная, с помощью которой можно подставлять значение переменной   на вики-страницу.

Имя скрипта
Переменная $wgScript содержит имя основного скрипта Mediawiki, по умолчанию index.php</tt>t. Изменение этой переменной не является необходимым действием. Если Вы не уверены, нужно ли это Вам, не изменяйте значение этой переменной.

Имя скрипта перенаправлений
Переменная $wgRedirectScript содержит URL, указывающий на скрипт перенаправлений redirect script реализующий перенаправления в Mediawiki. Переменная очень похожа по сути на предыдущую. Если Вы не уверены нужно ли менять значение этой переменной, оставьте всё как есть.

Путь к статьям
Переменная $wgArticlePath содержит путь, используемый для доступа к статьям MediaWiki. Обычно этот путь содержит путь к основныму скрипту (добавляется подстановкой переменной ) и  переменную $1</tt> для имени статьи. Если вы активировали Apache rewrite rules для генерации коротких удобочитаемых URL, скорей всего Вам понадобится подкорректировать   чтобы она соответствовала применяемым URL. Обратите внимание на то, что wgArticlePath применяется для генерации внутренних адресов URLs MediaWiki. Если  содержит ошибки, внутренние ссылки будут отображаться некорректно. Тем не менее получить доступ к главной странице будет можно, указав правильный URL вручную. Подробности касательно конфигурации URL содержатся здесь.

Типичные значения:

Расположение таблиц стилей
Переменная $wgStylePath содержит URL к местоположению каскадных таблиц стилей (CSS). Переменная $wgStyleDirectory должна указывать на тот же каталог, но иметь вид локального пути (не URL). Используется в локальных скриптах.

Каталог для загружаемых файлов
К этом каталоге хранятся медиафайлы, загружаемые пользователями. Переменная $wgUploadPath содержит URL, переменная $wgUploadDirectory - локальный путь.

Логотип
Переменная $wgLogo указывает на логотип, отображаемый в левом верхнем углу страницы. Размер логотипа определён в таблицах стилей и не должен превышать 135Х135 пикселей.

Чтобы изменить  (под строчками "require"):

Если указать  в каталог для загружаемых файлов, можно прменять в качестве логотипа загружаемый файлы.

обычно содержит.

Контактная информация
Переменная $wgEmergencyContact содержит адрес электронной почты для срочной связи в случае неполадок, а также для сообщений об (внутренних) ошибках. Обычно почтовый адрес администратора.

Переменная $wgPasswordSender адрес, с которого отправляются письма с восстановленными паролями. Желательно указать действительный адрес, чтобы полоьзователи могли обратиться по нему за помощью.

Настройки БД
Движок MediaWiki хранит информацию (страницы, метаданные, информацию о пользователях и т.д) в сторонней базе данных (MySQL либо PostgreSQL).

Переменная $wgDBserver содержит название хоста на котором находится база данных. В подавляющем большинстве случаев, это просто "localhost".

Переменная $wgDBname содержит имя, которой MediaWiki хранит всю необходимую информацию. Сервер MySQL или PostgreSQL может обслуживать несколько баз данных, на одном хосте может быть установленно несколько сайтов, основанных на MediaWiki. Удостоверьтесь, что в переменной указана правильная база данных, и что разные вики используют разные базы данных.

Переменные $wgDBuser и $wgDBpassword содержат логин и пароль, необходимые для доступа к базе данных. Удостоверьтесь, что Mediawiki обладает всеми необходимыми (SELECT, INSERT, UPDATE and DELETE) правами.

Настройки безопасности
Права доступа к файлу LocalSettings.php permissions нужно настроить таким образом, чтобы другие пользователи не имели возмоджности просматривать его содержимое, так как он содержит важные с точки зрения безопасности данные. В юникс-подобных ситемах, назначте права доступа 700. Кроме того, пользователю БД достаточно обладать правами SELECT, INSERT, UPDATE and DELETE.

Права участников
Права участников содержатся в хэше (ассоциативном массиве) $wgGroupPermissions. Существует возможность создавать собственные уровни доступа и назначать группам разные права. Более подробно этот вопрос освещён Здесь.

Заглавные буквы в ссылках
По умолчанию, имена страниц не могут начинаться со строчных букв. Поэтому первая буква каждой новой статьи автоматически преобразуется в заглавную. Ссылка на статью, изображение, шаблон или другой объект, начинающаяся со строчной буквы на самом деле указывает на объект, имя которого начинается с соответствующей заглавной буквы.

Тем не менее можно разрешить использование букв нижнего регистра в начале имени строки. Для этого нужно установить значение переменной $wgCapitalLinksравной false. (Значение true установлено по умолчанию)

Разрешение подстраниц
Создание подстраниц разрешается для каждого пространства имён отдельно с помощью переменной $wgNamespacesWithSubpages. Например, чтобы разрешить создание подстраниц в пространстве статей нужно указать:

Загрузка медиафайлов
По умолчанию загрузка файлов отключена. Перед её включением проверьте имеет ли веб сервер необходимые права доступа в каталог для загрузок. Затем установите значение переменной $wgEnableUploads равным true.

Типичные настройки из файла содержатся в файле includes/DefaultSettings.php. Для того, чтобы движок Mediawiki мог создавать миниатюры изображений, необходима программа ImageMagick. Установите значение переменных $wgUseImageResize и $wgUseImageMagick равным true (ImageMagick уже должна быть установлена). Удостоверьтесь, что $wgImageMagickConvertCommand указывает на расположение программы convert</tt> и что веб-сервер имеет право запускать её.

Возможно, Вам понадопится отредактировать перечень разрешённых для загрузки типов файлов. Они перечислены в массиве $wgFileExtensions:

Если ImageMagick выдаёт сообщение об ошибке следующего вида:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506</tt>

добавление следующей строки в файл LocalSettings.php может решить проблему: $wgMimeDetectorCommand = "file -bi";

'''См. также:''' Настройка загрузок, Manual:Mime type detection, and Создание миниатюр изображений

Поддержка LaTeX
Чтобы обеспечить отображение формул, заданных на языке разметки in LaTeX, необходимо иметь установленную систему Tex на компьютере. Установите значение переменной $wgUseTeX равным true. Удостоверьтесь, что переменные$wgMathPath, $wgMathDirectory и $wgTmpDirectory содержат корректные значения.

Поддержка интервик
Поддержка ссылок между языковыми разделами встроена в движок MediaWiki. Необходимо установить префикс для внутренних ссылок с помощью переменной $wgLocalInterwiki. Обычно этот префикс идентичен имени проекта.

Язык интерфейса
Можно задать с помощью переменной $wgLanguageCode. Принимаемые значения - языковые коды (для русского - "ru" )

Темы оформления (скины)
Используемый по умолчанию скин может быть изменён с помощью переменной $wgDefaultSkin. Некоторые расширения требуют установики дополнительных параметров, подробности, касающиеся каждого конкретного случая, содержатся в документации. Список доступных для скачивания расширений можно посмотреть здесь.

См. также

 * Extension:Configure предоставляет возможность править настройки вики-сайта через веб-интерфейс.