Компоненты 2.0: настройка поддержки ЧПУ
Настройка поддержки ЧПУ производится для работающих проектов (вы должны установить обновление главного модуля до версии 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):
После этих настроек будет работать штатный механизм поддержки ЧПУ для новых компонент. Простой тест для проверки проведенной настройки:
Примеры: 1. Если в системе обработки адресов зарегистрировано правило:
2. Если в системе обработки адресов зарегистрировано правило:
3. Если в системе обработки адресов зарегистрировано правило:
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
Если ЧПУ работает, то вы должны увидеть содержимое страницы, указанной в поле Файл в правиле переопределения.
Условие = #^/gallery/#
Файл = /max/images/index.php
и пользователем запрошена страница /gallery/38.php, которая физически не существует, то система обработки адресов подключит скрипт /max/images/index.php.
Условие = #^/index/([0-9]+)/([0-9]+)/#
Правило = mode=read&CID=$1&GID=$2
Файл = /newforum/index.php
и пользователем запрошена страница /index/5/48/, то будет подключен скрипт /newforum/index.php?mode=read&CID=5&GID=48.
Условие = #(.+?)\\.html(.*)#
Правило = $1.php$2
и пользователем запрошена страница /about/company.html?show, то будет подключен скрипт /about/company.php?show.