正则必须加^和$锚定首尾,否则仅检查子串匹配;排除路径需用全程否定的负向先行断言;验证必须用router:match命令而非profiler;可选参数仍受正则约束,空值需显式允许。

requirements 里正则不加 ^ 和 $ 就等于没写
很多人写 requirements={"slug": "[a-z0-9\-_]+"},以为能拦住 /admin 或 /123abc,结果发现都匹配上了——因为没锚定首尾,正则只检查“是否包含一段合法字符”,而不是“整个字符串是否合法”。
必须显式加上 ^ 和 $:requirements={"slug": "^[a-z0-9\-_]+$"}。
常见错误:
-
"slug": "(?!admin).+"→ 只检查开头,/myadmin仍会过 -
"slug": "^((?!admin).)*"→ 缺少$,末尾多出字符也不报错 -
"id": "\d+"在 YAML 里没用单引号包裹 →\d被 YAML 当转义解析,实际变成字面量d+
排除特定路径要用负向先行断言,不是简单写个黑名单
想让 /{slug} 匹配所有页面,但跳过 /login、/register、/admin,不能靠 "slug": "^(?!login|register|admin)$"——这只会匹配空字符串。
正确写法是全程否定:requirements={"slug": "^((?!login|register|admin).)*$"}。
这个正则的意思是:“从头到尾,每个位置之后都不能紧跟着 login/register/admin”。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
/foo✅ 匹配 -
/mylogin❌ 不匹配(my后紧接login) -
/login❌ 不匹配(开头就撞上) - 多个排除项用竖线连接,不要加空格:
"^(?!login|admin|api).*$"
router:match 是唯一能验证正则是否生效的工具
Symfony Web Profiler 的 Router 标签页只罗列路由定义,不运行匹配逻辑。它不会告诉你为什么 /admin 没走 subpages 路由——哪怕你写了 requirements={"slug": "^((?!admin).)*$"}。
真正要确认效果,必须跑命令:
-
php bin/console router:match /admin→ 输出No route found that matches "/admin",说明被正则拦了 -
php bin/console router:match /admin --verbose→ 明确提示Route 'subpages' rejected due to requirements (slug does not match regex) - 测试方法限制加
--method=POST;测试 host 加--header="Host: example.com" - 每次改完
requirements,不跑一遍router:match就上线,等于埋静默 404
可选参数 + 正则约束必须同时满足
路径写成 /{slug?},控制器参数设默认值 string $slug = 'home',不代表正则可以松懈。requirements 依然会对实际传入的值校验,包括空字符串或默认值本身。
-
requirements={"slug": "^[a-z]{2,20}$"}+/{slug?}→/会匹配($slug得到'home'),但/123会 404 - 如果想允许空值,得把正则改成
^$|^[a-z]{2,20}$,或拆成两个路由:一个无参数,一个带约束参数 - YAML 中写
defaults: { slug: 'home' }和requirements: { slug: '^[a-z]{2,20}$' }必须在同一级缩进,否则会被忽略
router:match 走一遍——它不报错,但请求就掉进 404 黑洞。










