Что произошло: роутинг становится стандартом
В 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 — это не революция, а эволюция, которая уже произошла технически. Осталось только явно включить её в проектах, где это имеет смысл. Если вы хотите разобраться, как это сделать без риска для работающего сайта, или спланировать миграцию — напишите мне. Я посмотрю на текущую маршрутизацию и предложу план перехода.
Комментарии
Оставить комментарийКомментариев пока нет. Будьте первым.
Оставить комментарий
Комментарий появится после проверки модератором.