SuperAPI AI 工具集

bitrix-routing

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:为 Bitrix D7 项目配置路由,把请求映射到控制器或闭包,并支持用控制器渲染公开页面。基线 main 23.0+,已验证 main 26.800.0。

主要能力与规则:用户路由只能放在 /local/routes/*.php,并在 routing.config 中按 basename 列出;模块路由文件也从该处 require。web.php 支持动词、参数、名称、分组与闭包处理器。处理器保持轻量,涉及鉴权、CSRF 或稳定契约时使用 [Controller::class, 'action']。路由控制器用过滤器(bitrix-controllers)保护,不要用 ->middleware()。路由控制器运行在 SCOPE_AJAX 下,默认 Authentication 与 Csrf 对 GET 页面同样生效;公开只读页面可按 action 去掉。状态变更路由需显式动词(get/post/…),每个参数都要 ->where()。

使用方式:按任务查阅对应规则文件——rules/setup.md(Web 服务器规则、路由配置、模块路由文件)、rules/routes-handlers.md(web.php、动词、参数、名称、分组、闭包)、rules/public-pages.md(控制器上的公开页面、PublicPageController)、rules/matching-legacy.md(匹配顺序、编译缓存、site-guard、urlrewrite.php 迁移)。

限制:同一路径存在物理文件时优先于路由,Web 服务器会在 routing_index.php 之前直接提供该文件。资料未提供安装命令、收费与平台信息。