symfony中加路由约束的核心是用requirements配合正则表达式限定参数格式，防止非法值进入控制器，保障匹配准确性与应用安全；支持多参数分别约束、结合defaults实现可选但受控的参数，并需注意yaml单引号包裹、锚定首尾等细节。
在 Symfony 中加路由约束，核心是用 requirements 限定参数格式，防止非法值进入控制器。它不是可选项，而是保障路由匹配准确性和应用安全的关键一步。
用正则表达式限制单个参数
最常用也最直接的方式：在注解或 YAML 中为每个占位符指定正则规则。
- 注解写法：`@Route("/user/{id}", requirements={"id": "\d+"})` —— 只匹配纯数字，
/user/abc直接 404 - YAML 写法：`requirements: { id: '\d+' }` —— 注意单引号包裹正则，避免 YAML 解析错误
- 精确长度控制（比如短链接）：`requirements={"shorturl": "^[a-zA-Z0-9]{8}$"}` ——
^和$锚定首尾，确保严格 8 位
多个参数分别约束
不同参数常需不同规则，requirements 支持键值对数组，互不干扰。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 例如博客归档页：`@Route("/blog/{year}/{month}", requirements={"year": "\d{4}", "month": "0[1-9]|1[0-2]"})`
- 用户名 + ID 组合：`requirements={"username": "[a-zA-Z0-9_]+", "id": "\d+"}`
- 注意大小写：正则中
[a-zA-Z]包含大小写字母，[a-z]则只认小写
结合默认值让参数可选但仍有约束
defaults 让参数可省略，requirements 仍对其实际值生效——两者不冲突，可共存。
-
`@Route("/search/{q}", defaults={"q": ""}, requirements={"q": ".{2,50}"})` ——
q可不填（空字符串），但填了就得 2–50 字符 -
`defaults={"page": 1}, requirements={"page": "\d+"}` ——
/search和/search/1都合法，/search/abc不匹配 - YAML 示例：`defaults: { page: 1 }` 和 `requirements: { page: '\d+' }` 分行写在同一路由下即可
避开常见陷阱
有些写法看似合理，实则失效或引发意外行为。
- 别在路径里写
{_controller}—— 这是 Symfony 内部参数，不是 URL 段，写了会导致路由匹配失败或误导向服务查找 - host 匹配不用 requirements 控制域名，而要用 `host="{domain}"` + 单独的 host-level requirements
- 开发时若想临时绕过正则报错，可设 `strict_requirements: false`（
config/packages/dev/routing.yaml），上线前务必关掉
