Manual:Short URL/Apache/ru

Эти инструкции помогают настроить короткие URL-ссылки на Apache. Веб-сервер LiteSpeed совместим с Apache и может быть настроен относительно одинаково. Для получения информации о том, что такое короткие URL-адреса, или получить инструкции по настройке для других серверов см. . Если Вы не знаете, какой веб-сервер вы используете, так как вы используете какой-то веб-хостинг, очень вероятно, что ваш хост использует Apache.

Настройка
Перед началом работы необходимо определиться с именем виртуального пути "короткий url".

В этом руководстве мы рекомендуем/предполагаем следующее. Не забудьте использовать свои собственные пути, если они отличаются.


 * Каталог MediaWiki находится по адресу:
 * Требуемый формат короткого URL:



Настройка сервера


Найдите нужный файл
Рекомендуется настроить короткие URL-адреса в Apache путем редактирования конфигурационных файлов Apache. Для этого требуется доступ к конфигурации сервера. Если вы находитесь на общем хосте, вы, скорее всего, не и нужно будет использовать файл  вместо этого. Использование файлов  менее эффективно и не дает вам столько контроля, когда дело доходит до причудливых настроек с несколькими доменами, но они достаточно мощны, чтобы настроить большинство коротких конфигураций url. Пользователи LiteSpeed должны использовать метод.

Используйте инструкции в одном из следующих двух разделов, в зависимости от того, есть ли у вас root-доступ или нужно использовать  вместо этого.



Найдите файл конфигурации Apache (root-доступ)
Корректный файл конфигурации для редактирования для корневых конфигураций может находиться в одном из нескольких мест.

Правильный конфигурационный файл для редактирования - это тот, который находится в, где была настроена конфигурация для вашей вики. Большинство дистрибутивов linux настраивают Apache с набором папок  и.

Правильный конфигурационный файл для редактирования находится в $code3, где была настроена конфигурация для вашей Вики. Если Вы не настроили его и используете  по умолчанию для настройки Вики, то вы можете отредактировать.

Не забудьте включить переопределения с помощью  в. Он отключен по умолчанию в Ubuntu 12.04 и Ubuntu 12.10.

Если в вашем дистрибутиве нет этих каталогов, вы должны отредактировать файл конфигурации Apache напрямую. Этот файл должен быть в. Обратите внимание, что это используется, чтобы быть названным, если у вас есть   и не   в   является тот, который вы хотите редактировать.

Если ваш Apache config не находится ни в одном из этих мест, вы должны обратиться к документации для любой системы, которую Вы использовали для установки Apache, и найти расположение файла конфигурации Apache.

Если вы находитесь на виртуальном хостинге без доступа к файлам конфигурации Apache вы должны использовать файл .htaccess вместо этого.

В конфигурационном файле Apache у вас, скорее всего, будет блок VirtualHost, содержащий вашу wiki. Если он у вас есть, то это то место, куда будут отправляться ваши правила перезаписи. Конфигурация RewriteRule не наследуется, поэтому не помещайте эти параметры конфигурации в глобальную конфигурацию, если вы используете VirtualHost.

После того, как вы настроили конфигурацию, как указано выше, внутри Apache, вам нужно будет перезапустить Apache, чтобы заставить его применить новую конфигурацию.


 * Если вы используете Plesk или cPanel, у него должен быть способ перезапуска сервера.
 * Из командной строки команда обычно выглядит примерно так:,  ,   или, как в последних версиях Fedora,  . Эти команды должны выполняться от имени пользователя root, обычно с префиксом.



Куда девать .htaccess
Если вы используете файл, вам нужно будет отредактировать или создать этот файл. Найдите путь, который содержит как ваш путь к скрипту, так и ваш виртуальный путь. Обычно это означает верхний каталог вашего сайта, но давайте рассмотрим несколько примеров:

Обратите внимание, что если вы хотите сделать перенаправление с основного домена на главную страницу вашей вики (например, http://example.org/ http://example.org/wiki/Main_Page ). Тогда вам всегда нужно настраивать файл .htaccess на верхнем уровне, даже если другие каталоги вложены глубже.



Настройка правил перезаписи
Остальную часть этого раздела легче понять после краткого ознакомления с синтаксисом Apache, но этот краткий обзор не заменяет полную документацию Apache:

Директива  определяет условие, которое должно быть true, прежде чем может быть применен следующий за ним RewriteRule. Одна или несколько директив RewriteCond могут предшествовать директиве RewriteRule, и все директивы RewriteCond, которые предшествуют RewriteRule, должны быть истинными, прежде чем это правило может быть применено к URI. В следующих примерах  принимает форму ссылки на переменные сервера, например. Хотя существует много, в следующих примерах используются   (true, когда testString является обычным файлом) и   (true, когда testString является каталогом), и им предшествует символ отрицания,.

Директива  может быть вызвана как в файле , так и в любом файле  , но когда правило перезаписи появляется в файлах .htaccess, неявный контекст для каждого каталога влияет на шаблон  , поскольку правила относятся к текущему каталогу. В файлах  шаблоны являются не по отношению к полному исходному URI. Для файлов  шаблоны никогда не должны начинаться с косой черты, , потому что вложенная строка URI никогда не будет начинаться с. В следующих примерах используется флаг, значение которого Немедленно остановите процесс перезаписи и больше не применяйте никаких правил.

Первое правило, которое вам понадобится в вашей конфигурации, - это включить механизм перезаписи:

Теперь нам нужно правило, чтобы сделать ваш путь к статье виртуальным путем, указывающим на index.php. Обязательно замените  и   путями, которые вы выбрали в начале (если они отличаются).

Если вы используете корневой URL-адрес вместо обычного короткого URL-адреса, вам нужно будет вместо этого использовать следующее (чтобы убедиться, что существующие файлы и каталоги не отображаются как статьи, например " ", " " и т.д.):

Иногда приведенный выше пример не работает. Вместо этого может сработать следующее (вы не можете установить это в, для этого вам нужен root-доступ!):

При желании вы можете включить правило для отображения Главной страницы на самом пути, чтобы упростить навигацию, когда люди посещают URL-адреса без указанного заголовка страницы:

Конечный результат должен выглядеть примерно так:

or, if you used the way with the "Alias" statement:

LocalSettings.php
Нам нужно сделать следующие конфигурации в :

Если после завершения настройки вы получите страницу "Внутренняя ошибка" с надписью "Обнаружен цикл перенаправления!", возможно, вы используете что-то другое, кроме. Если это так, вам нужно явно включить короткие URL-адреса, используя следующую строку в вашем файле "LocalSettings.php":

Если все еще существует "внутренняя ошибка", проверьте файлы журналов вашего сервера. Возможно, вам придется включить модуль.



Простые инструкции
Ниже приводится краткое описание того, что делать, если вы не делаете ничего отличного от того, что рекомендует MediaWiki. Если вы хотите сделать что-то еще, вам нужно прочитать все подробности выше.


 * https://example.com/wiki/Main_Page (расположение url-адреса)
 * /home/me/public_html/mediawiki/w/index.html (расположение index.html)
 * /home/me/public_html/mediawiki/.htaccess (расположение .htaccess)

Обратите внимание, что файл .htaccess находится не в каталоге "w", а в каталоге над ним.



Исходный код .htaccess


Online Wizard
It is possible that this wizard will help people generate the short URLs they need. (NOTE: This needs to be tested, or the section removed.)

An automated wizard (requires MediaWiki 1.17 or later) might help:


 * shorturls.redwerks.org

If you just want your wiki configured quickly or you find the guide confusing then you may want to try that tool first. If you do this, please note that you will need to edit or create a .htaccess file. If you create it anew, please read on to further in this article about where to place the .htaccess file, and please note that this file will likely be in a different folder than the other file that will need to be edited (LocalSettings.php), which is in the installation folder (/w if you have followed the MediaWiki recommendations). Please also note that using this wizard will not work on firewalled or private wikis. In this case, you can still try it out by making your wiki temporarily public by setting  to. Remember to change it back to once you are done.

