1С-Битрикс закрепляет новый роутинг: routing_index.php официально заменяет urlrewrite.php

В 2026 году 1С-Битрикс официально закрепляет переход на современный роутинг. Механизм routing_index.php, доступный с версии main 21.400.0, становится целевым стандартом, а urlrewrite.php — устаревшим legacy-решением. Разбираю, что именно изменилось и почему это важно для сайтов на Битрикс.

1С-Битрикс закрепляет новый роутинг: routing_index.php официально заменяет urlrewrite.php

Что произошло: роутинг становится стандартом

В 2026 году 1С-Битрикс официально закрепила новый механизм маршрутизации. Речь идёт о системе на базе routing_index.php, которая появилась в главном модуле ещё в версии 21.400.0, но теперь становится целевым стандартом, а привычный urlrewrite.php — устаревшим решением.

Это не внезапное изменение, а закономерный этап развития фреймворка. Ещё в январском обновлении 2026 года было зафиксировано: urlrewrite.php теперь подключает routing_index.php. Иными словами, новый роутинг уже работает «под капотом» даже там, где разработчик явно его не включал. Документация прямо указывает: для запуска современной маршрутизации достаточно перенаправить обработку несуществующих файлов на routing_index.php.

Почему это новость, а не просто инструкция

Новость заключается в смене парадигмы. Раньше urlrewrite.php был основным инструментом для ЧПУ и маршрутов. Теперь 1С-Битрикс предлагает отдельный уровень абстракции: маршруты описываются в файлах конфигурации (web.php, api.php), а обработчики привязываются к контроллерам и замыканиям. Это ближе к современным фреймворкам вроде Laravel и Symfony.

Для разработчиков это означает:

  • Возможность описывать API-эндпоинты без создания физических страниц.
  • Явное управление HTTP-методами (GET, POST, PUT, DELETE).
  • Группировку маршрутов с общими префиксами и параметрами.
  • Постепенную миграцию: старые правила из urlrewrite.php продолжают работать, но новый код рекомендуется писать уже с использованием D7-роутинга.

Для владельцев сайтов это в перспективе — более предсказуемая архитектура и упрощение поддержки, особенно если проект активно развивается.

Ключевые факты, подтверждённые документацией

  • Версия main 21.400.0 — минимальная для поддержки роутинга.
  • Версия 23.500.0 — роутер доступен через \Bitrix\Main\Application::getRouter().
  • Версия 24.100.0 — можно выносить настройки роутинга в /local/.settings_extra.php, не трогая ядро.
  • Январь 2026 — в обновлении зафиксировано, что urlrewrite.php подключает routing_index.php для обратной совместимости.
  • Файлы маршрутов размещаются в /local/routes/ или /bitrix/routes/.

Что это значит для проектов на Битрикс

Срочно переписывать всё не нужно. Старый механизм продолжает работать, и ЧПУ каталога, новостей и других разделов, настроенные через urlrewrite.php, остаются функциональными. Однако если вы планируете доработку или запуск нового функционала (особенно API, вебхуков, JSON-эндпоинтов), документация рекомендует сразу использовать D7-роутинг.

Это особенно актуально для проектов, которые развиваются: новый роутинг позволяет отделить публичные страницы от API и делает код более модульным. В долгосрочной перспективе это снижает стоимость поддержки и упрощает передачу проекта другому разработчику.

Итог

Переход на routing_index.php — это не революция, а эволюция, которая уже произошла технически. Осталось только явно включить её в проектах, где это имеет смысл. Если вы хотите разобраться, как это сделать без риска для работающего сайта, или спланировать миграцию — напишите мне. Я посмотрю на текущую маршрутизацию и предложу план перехода.

АН
Автор

Алексей Нестеров

Веб-разработчик. Пишу о PHP, 1С-Битрикс, интеграциях и инструментах разработки.

Обо мне

Комментариев пока нет. Будьте первым.

Оставить комментарий

Комментарий появится после проверки модератором.