Читабельные ссылки (ЧПУ)

Читабельные ссылки — адреса вида /wiki/Статья вместо /index.php?title=Статья. Для них нужны две строки в LocalSettings.php и правило перезаписи адресов в настройках веб-сервера.

Как выглядят адреса до и после

Сразу после установки адрес статьи выглядит так: /w/index.php?title=Заглавная_страница. После настройки он станет таким: /wiki/Заглавная_страница.

Короткий адрес легче прочитать, запомнить и передать другому человеку. Сам движок работает так же.

Какую схему выбрать?

Обычно файлы движка лежат в папке /w, а статьи открываются по адресу /wiki/…. Так устроена и Википедия. Дальше в примерах — эта схема.

Важно. Не делайте адрес статей таким же, как папка с файлами движка, например /w/Статья при файлах в /w. Адреса статей в корне сайта, вида /Статья, тоже не советуют: они путаются с настоящими файлами и папками на сервере.

1. Пропишите пути в LocalSettings.php

LocalSettings.php
$wgScriptPath = "/w";
$wgArticlePath = "/wiki/$1";

$wgScriptPath установщик уже записал: это папка с файлами движка. Добавьте строку $wgArticlePath. Вместо $1 движок подставит название статьи.

2. Настройте веб-сервер

Сервер должен отдавать все адреса /wiki/… движку, файлу /w/index.php. Сам адрес в браузере при этом не меняется.

Apache

Нужен модуль mod_rewrite. Правила кладут в настройки сайта или в файл .htaccess в корне сайта — в этом случае Apache должен разрешать .htaccess для этой папки.

.htaccess
RewriteEngine On
RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L]
RewriteRule ^/*$ %{DOCUMENT_ROOT}/w/index.php [L]

Первое правило передаёт движку адреса статей. Второе открывает заглавную страницу по адресу корня сайта.

nginx

В блок server добавьте:

nginx
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.

Что-то не сработало или устарело? Напишите в чат или предложите исправление.