Дата последнего изменения: 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) {
// маршруты
};
Поиск совпадений производится в том же порядке, в каком маршруты описаны в конфигурации.