bitrix-routing

Bitrix 路由

基准：main 23.0+ · 已验证：main 26.800.0

任务	阅读
Web 服务器规则、routing 配置、模块路由文件	rules/setup.md
web.php、请求方法、参数、名称、分组、闭包处理程序	rules/routes-handlers.md
控制器上的公开页面、PublicPageController	rules/public-pages.md
匹配顺序、编译缓存、站点保护、urlrewrite.php 迁移	rules/matching-legacy.md

不变量

• 用户路由只能放在 /local/routes/*.php 中，并在 routing.config 中按基本名称列出。模块路由文件通过 require 从此处引入。
• 处理程序应保持精简：对于任何涉及身份验证、CSRF 或稳定契约的内容，都使用 [Controller::class, 'action']。使用筛选器保护路由控制器（bitrix-controllers），绝不要使用 ->middleware()。
• 路由控制器在 SCOPE_AJAX 中运行：默认的 Authentication + Csrf 也会应用于 GET 页面。对于公开的只读页面，按操作移除这些筛选器。
• 对会更改状态的路由显式指定请求方法（get/post/…），并对每个参数使用 ->where()。
• 同一路径下的物理文件优先于路由：Web 服务器会先于 routing_index.php 提供该文件。