symfony 8.1 中路由参数必须加正则约束以防路径遍历，如 id: '\d+'；可选参数需路径标 ? 且方法设默认值；排除特定值用负向先行断言，如 '^(?!admin$).+$'；多语言路由须限制 locale 取值。
在 Symfony 8.1 中，路由参数的正则约束不是“可选优化”，而是安全底线。不加约束的 {id} 或 {slug} 会接受任意非斜杠字符，比如 /user/..%2f..%2fetc%2fshadow 这类路径遍历尝试可能绕过预期逻辑，直接抵达危险区域。
基础写法：requirements 必须显式声明
无论用 YAML 配置还是 PHP 属性（Attributes），requirements 都不能省略。它决定该路由是否匹配——不满足正则，直接返回 404，根本不会进控制器。
- YAML 示例（
config/routes.yaml）：
user_profile:
path: /user/{id}
controller: App\Controller\UserController::show
requirements:
id: '\d+' - PHP 属性示例（控制器内）：
#[Route('/user/{id}', requirements: ['id' => '\d+'])]
public function show(int $id): Response { ... } - ⚠️ 注意：正则必须用单引号包裹，否则 PHP 会把
\d当作转义序列解析失败；\d+比[0-9]+更可靠，能避免 Unicode 数字干扰类型判断。
可选参数：问号 + 默认值必须成对出现
当参数可省略（如 /blog 和 /blog/symfony-tips 共用一个路由），需同时满足两个条件，缺一不可。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 路径中加
?：写成/blog/{slug?} - 方法参数设默认值：写成
public function show(string $slug = 'home') - 若只做其一，Symfony 会报错或行为异常——例如没设默认值却传空 slug，会触发类型错误；反之路径没标
?却传空值，则根本无法匹配。
排除特定值：用负向先行断言精准拦截
有时你需要“匹配所有，但排除某几个”。比如 /api/{resource} 要放行 /api/users、/api/posts，但拒绝 /api/admin。
- 正则写法：
^(?!admin$).+$
解释：(?!admin$)是负向先行断言，“后面不能是 admin 且到结尾”；.+确保非空。 - 完整属性示例：
#[Route('/api/{resource}', requirements: ['resource' => '^(?!admin$).+$'])] - 扩展用法：排除多个词，用
^(?!admin$|debug$|test$).+$；排除含敏感词的路径，用^((?!password|token).)*$。
多语言路由中的 locale 约束
支持 /、/fr、/fr/about 这类 URL，关键不是写多条路由，而是用可选 _locale 加严格取值限制。
- 推荐写法：
#[Route('/{_locale}/{slug}',
name: 'page',
defaults: ['_locale' => 'en'],
requirements: ['_locale' => 'en|fr|es|de'])] - 这样
/about自动视为_locale=en，/fr/about明确走法语；没有requirements的话，空字符串或非法语言码（如/xx/foo）也会匹配，导致逻辑混乱。 - 注意：首页单独路由
/{_locale}应放在更靠前的位置，避免被泛匹配路由吞掉。
