Дата последнего изменения: 07.11.2023
Доступно в модуле main начиная с версии 21.400.0. Для пользовательских модулей использование собственных роутов в папке модуля на данный момент не предусмотрено.
Для запуска новой системы роутинга нужно перенаправить обработку 404 ошибок на файл routing_index.php в файле .htaccess:
#RewriteCond %{REQUEST_FILENAME} !/bitrix/urlrewrite.php$ #RewriteRule ^(.*)$ /bitrix/urlrewrite.php [L] RewriteCond %{REQUEST_FILENAME} !/bitrix/routing_index.php$ RewriteRule ^(.*)$ /bitrix/routing_index.php [L]
\Bitrix\Main\Application::getRouter()
.Файлы с конфигурацией маршрутов располагаются в папках /bitrix/routes/
и /local/routes/
. Для подключения файла следует описать его в файле
.settings.php
Bitrix Framework имеет ряд специфичных настроек ядра, которые не имеют визуального интерфейса редактирования. Этот подход вызван тем, что изменение настроек или ошибка в них легко могут привести к неработоспособности системы (настройки подключения к базе данных, настройки кеширования и т.д.).
Подробнее ...
в секции routing:
'routing' => ['value' => [ 'config' => ['web.php', 'api.php'] ]], // подключатся файлы: // /bitrix/routes/web.php, /local/routes/web.php, // /bitrix/routes/api.php, /local/routes/api.php
Формат файла предполагает возврат замыкания, в которое передается объект конфигурации маршрутов:
<?php use Bitrix\Main\Routing\RoutingConfigurator; return function (RoutingConfigurator $routes) { // маршруты };
Поиск совпадений производится в том же порядке, в каком маршруты описаны в конфигурации.