Настройка ЧПУ и модуля преобразования адресов в 1С-Битрикс

ЧПУ (человекопонятные URL) превращают технические адреса вида /catalog/index.php?SECTION_ID=25&ELEMENT_ID=140 в понятные /catalog/smartfony/iphone-15/. В 1С-Битрикс за это отвечают модуль преобразования адресов и файл правил urlrewrite.php в корне сайта, работающие в связке с mod_rewrite (Apache) или try_files (nginx). Этот материал — практическое руководство: как включить ЧПУ, настроить их для комплексных компонентов каталога и новостей, разобраться в порядке правил и не получить массовые 404 после переключения.

Как устроено ЧПУ в 1С-Битрикс

Система работает в два уровня. Когда пользователь запрашивает красивый адрес, которого нет как физического файла, веб-сервер передаёт запрос скрипту urlrewrite.php. Тот перебирает правила (регулярные выражения) и находит, какому реальному скрипту и с какими параметрами отдать запрос. Второй уровень — сами комплексные компоненты (каталог, новости, блог): в их настройках задаются шаблоны путей, по которым компонент и строит, и разбирает ЧПУ. При включении ЧПУ в компоненте Битрикс автоматически дописывает нужное правило в urlrewrite.php.

Шаг 1. Проверяем веб-сервер: mod_rewrite и nginx

Без обработки правил на уровне веб-сервера ЧПУ не заработают. Что проверить:

Веб-сервер	Что должно быть включено
Apache	модуль mod_rewrite активен, в .htaccess присутствует блок RewriteEngine On и правило, направляющее несуществующие пути на urlrewrite.php
nginx + Apache	в конфиге сайта есть try_files $uri $uri/ /bitrix/urlrewrite.php либо fallback на бэкенд Apache
nginx (php-fpm)	директива try_files направляет запрос на /urlrewrite.php при отсутствии файла

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

Шаг 2. Включаем модуль преобразования адресов

1. Откройте Настройки → Настройки продукта → Настройки модулей.
2. Выберите модуль Преобразование адресов.
3. Включите преобразование адресов и, при необходимости, автоматическую генерацию таблицы правил.
4. Сохраните настройки.

После включения модуля страница управления правилами становится доступна в разделе Настройки → Настройки продукта → Преобразование адресов. Здесь виден весь список правил, их можно редактировать, менять порядок и пересобирать по компонентам сайта.

Шаг 3. Настраиваем ЧПУ в компоненте каталога

Основную часть ЧПУ задаёт сам комплексный компонент. На примере каталога:

1. Перейдите в публичный раздел с каталогом и включите режим правки.
2. Откройте настройки комплексного компонента «Каталог» (bitrix:catalog).
3. Найдите группу параметров «Настройки ЧПУ» / «Управление адресами» и включите ЧПУ.
4. Задайте корневую папку раздела (например /catalog/) и шаблоны путей: раздел — #SECTION_CODE_PATH#/, элемент — #SECTION_CODE_PATH#/#ELEMENT_CODE#/.
5. Сохраните. Битрикс предложит создать правило в таблице преобразования адресов — согласитесь.

Аналогично ЧПУ настраиваются для новостей (bitrix:news), блога и других комплексных компонентов. Если требуется доработать структуру URL под SEO-стратегию нетривиально, эту задачу лучше поручить специалистам по доработке ЧПУ.

Файл urlrewrite.php: как читать и править

Файл /urlrewrite.php в корне сайта — это массив правил. Каждое правило описывает:

• CONDITION — регулярное выражение, которому должен соответствовать входящий адрес;
• RULE — как преобразовать совпавшие группы в GET-параметры;
• PATH — физический скрипт, которому передаётся запрос;
• ID — идентификатор компонента, чьё это правило.

Пересобрать таблицу правил без ручного редактирования можно кнопкой пересоздания на странице модуля преобразования адресов — Битрикс просканирует компоненты сайта и восстановит корректный набор правил.

Символьные коды разделов и элементов

ЧПУ строятся из символьных кодов (полей CODE) разделов и элементов инфоблока. Если код не заполнен, красивый адрес построить не из чего — будет либо технический URL, либо 404.

• Включите автогенерацию символьного кода в настройках инфоблока → вкладка «ЧПУ»: транслитерация из названия, уникальность, нижний регистр.
• Для уже созданных элементов без кода запустите массовую генерацию кодов (транслитерацию названий).
• Проверьте, что коды уникальны в пределах раздела — дубли ломают адресацию.

Редиректы со старых адресов

Если сайт уже работал на технических адресах, после перехода на ЧПУ настройте 301-редиректы, чтобы сохранить позиции и внешние ссылки:

• постраничные редиректы со старых адресов на новые — через модуль SEO, .htaccess или обработчик в urlrewrite.php;
• обновите sitemap.xml и внутренние ссылки на новые адреса;
• проверьте, что старый адрес отдаёт именно 301, а не 302 и не 404.

Комплексная перестройка URL-структуры под требования продвижения — это отдельная работа; при необходимости мы дорабатываем SEO-структуру на Битрикс целиком, вместе с редиректами и картой сайта.

Частые ошибки и их решение

• Все ЧПУ отдают 404. Не включён mod_rewrite / try_files, либо повреждён .htaccess или urlrewrite.php. Восстановите стандартные файлы из дистрибутива и пересоздайте таблицу правил.
• Открывается не тот раздел. Нарушен порядок правил в urlrewrite.php — общее правило перехватывает запрос раньше частного. Пересоберите таблицу автоматически.
• Элемент недоступен по ЧПУ. У элемента или раздела не заполнен символьный код. Включите автогенерацию и запустите массовую транслитерацию.
• Работает главная, но не работают вложенные разделы. Не задан шаблон пути раздела #SECTION_CODE_PATH# в настройках компонента.
• Кириллица в адресе. Символьные коды должны генерироваться латиницей (транслитерация); кириллические коды приводят к некорректным и неудобным URL.

Если ЧПУ ведут себя нестабильно после переезда сайта, проверьте также конфигурацию нового сервера — часть проблем связана именно с ним, см. инструкцию по переносу сайта.

Итог

ЧПУ в 1С-Битрикс — это связка трёх уровней: обработка правил на веб-сервере (mod_rewrite / try_files), модуль преобразования адресов с файлом urlrewrite.php и настройки ЧПУ в самих комплексных компонентах. Чтобы всё работало стабильно, нужны включённый rewrite, корректный порядок правил и заполненные символьные коды разделов и элементов. При переходе со старых адресов обязательны 301-редиректы и обновлённая карта сайта. Если структура URL сложная или переезд рискует уронить трафик, эту работу стоит доверить специалистам.