Правила обработки адресов - РАСПП
Настройка поддержки ЧПУ производится для работающих проектов (вы должны установить обновление главного модуля до версии 5.1.8 и выше, поскольку в обновление ядра 5.1.8 включен механизм переопределения адресов для поддержки ЧПУ). Все, кто будет ставить новый дистрибутив, получат уже настроенную поддержку.
Понятие обработки адресов
Обработка адресов (UrlRewrite) применяется для того, чтобы скрипт мог отвечать не только по своему физическому, но и по любому другому указанному адресу. Например, можно задать такие настройки обработки адресов, что скрипт, лежащий в файле /fld/c.php и отвечающий по адресу:
/fld/c.php?id=15
будет отвечать также по адресу:
/catalog/15.php
Адрес, по которому будет отвечать скрипт, не должен физически существовать на сервере. Если такой адрес физически существует, то будет вызван скрипт по этому адресу. Система обработки адресов запущена в этом случае не будет.
Управление правилами преобразования адресов производится в панели управления на странице "Настройки - Обработка адресов": /bitrix/admin/urlrewrite_list.php.
Механизм переопределения адресов создан в основном для компонентов 2.0, поддерживающих режим ЧПУ. В то же время, данный обработчик можно использовать для переопределения любых URL, а не только связанных с компонентами.
При добавлении на страницу компонента с поддержкой ЧПУ (если файл сохраняется с помощью API), автоматически создается правило переопределения адреса. Если страница создается не с помощью API, а, например, записывается через FTP, то необходимо выполнить пересоздание правил (кнопка на панели инструментов на странице управления правилами).
Подключение механизма обработки адресов:
1. Если у вас на веб-сервере настроена обработка ошибки 404, например, для Apache установлена опция ErrorDocument или аналогичная инструкция прописана в файле .htaccess:
2. Если вы для Apache используете модуль mod_rewrite, то в его настройках вы можете указать (например, в файле .htaccess):
После этих настроек будет работать штатный механизм поддержки ЧПУ для новых компонент. Простой тест для проверки проведенной настройки:
Для динамических страниц, содержащих в адресе параметр ID, можно создать правило, по которому адрес
страницы для каждой новости будет включать значение ID в имени страницы, например, 234.html В некоторых случаях необходимо использовать адреса страниц с расширением .html, соответствующее правило будет выглядеть следующим образом: При переносе информации со старого сайта на новый, часто необходимо сохранить
в рабочем состоянии старые ссылки на некоторые материалы сайта. Например, страница может быть занесена в Избранное у посетителя,
или проиндексирована поисковыми системами. Для таких ссылок необходимо задать условия, которые описывают соответствие
страниц старого и нового сайта. Например, так задается соответствие для старой страницы: about.html
ErrorDocument 404 /404.php
то вы должны изменить файл /404.php, вставив в самое начало файла команду:
include_once( $_SERVER['DOCUMENT_ROOT']. '/bitrix/modules/main/include/urlrewrite.php' );
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !/bitrix/urlrewrite.php$
RewriteRule ^(.*)$ /bitrix/urlrewrite.php [L]
</IfModule>
1. Зайти на страницу "Настройки" - "Настройки продукта" - "Обработка адресов"
2. Выбирать пункт "Новая запись" и добавить:
Условие: #^/sef_test/#
Компонент: ничего не указываем
Файл: /index.php (нужно указать файл, который фактически будет работать)
Правило: ничего не указываем.
Сохранить изменения.
3. Перейти по адресу в разделе /sef_test/
Например, http://localhost/sef_test/test.html
Если ЧПУ работает, то вы должны увидеть содержимое страницы, указанной в поле Файл в правиле переопределения. Условие: #^/news/([0-9]+)\.html(\?.*)?$
Пример настройки адресов страниц .html вместо .php
Правило: /about/news/detail.php?ID=$1
Условие: #^(.+)\.html(\?.*)?$#
Обработка старых ссылок
Правило: $1.php
Условие: #^/about.html(\?.*)?$#
Правило: /about/index.php