Читабельные ссылки (ЧПУ)
Читабельные ссылки — адреса вида /wiki/Статья вместо /index.php?title=Статья. Для них нужны две строки в LocalSettings.php и правило перезаписи адресов в настройках веб-сервера.
Как выглядят адреса до и после
Сразу после установки адрес статьи выглядит так: /w/index.php?title=Заглавная_страница. После настройки он станет таким: /wiki/Заглавная_страница.
Короткий адрес легче прочитать, запомнить и передать другому человеку. Сам движок работает так же.
Какую схему выбрать?
Обычно файлы движка лежат в папке /w, а статьи открываются по адресу /wiki/…. Так устроена и Википедия. Дальше в примерах — эта схема.
Важно. Не делайте адрес статей таким же, как папка с файлами движка, например /w/Статья при файлах в /w. Адреса статей в корне сайта, вида /Статья, тоже не советуют: они путаются с настоящими файлами и папками на сервере.
1. Пропишите пути в LocalSettings.php
$wgScriptPath = "/w";
$wgArticlePath = "/wiki/$1";$wgScriptPath установщик уже записал: это папка с файлами движка. Добавьте строку $wgArticlePath. Вместо $1 движок подставит название статьи.
2. Настройте веб-сервер
Сервер должен отдавать все адреса /wiki/… движку, файлу /w/index.php. Сам адрес в браузере при этом не меняется.
Apache
Нужен модуль mod_rewrite. Правила кладут в настройки сайта или в файл .htaccess в корне сайта — в этом случае Apache должен разрешать .htaccess для этой папки.
RewriteEngine On
RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L]
RewriteRule ^/*$ %{DOCUMENT_ROOT}/w/index.php [L]Первое правило передаёт движку адреса статей. Второе открывает заглавную страницу по адресу корня сайта.
nginx
В блок server добавьте:
location /wiki/ {
rewrite ^/wiki/(?<pagename>.*)$ /w/index.php;
}Обработку PHP для папки /w настраивают как обычно для вашего сервера. После правки перезагрузите nginx.
Как проверить, что всё работает?
Откройте /wiki/Заглавная_страница. Должна открыться заглавная страница вики, а ссылки в меню должны вести на адреса вида /wiki/….
Если вместо статьи пришла ошибка 404, сервер не применил правило: проверьте, включён ли mod_rewrite и читает ли Apache файл .htaccess. Путь в $wgArticlePath и путь в правиле сервера должны совпадать.
Где найти другие варианты
Правила для других серверов и схем адресов — на странице Manual:Short URL и в её подстраницах для Apache и nginx.
Если вики ещё не установлена, начните со статьи Установка MediaWiki.
Что-то не сработало или устарело? Напишите в чат или предложите исправление.