ThinkPHP默认路由参数不支持斜杠，因内置正则[a-zA-Z0-9_-]+和\d+均未包含/且无u修饰符；需显式用\S+或中文正则配合completeMatch(true)并做安全过滤。
ThinkPHP 默认不支持路由参数里带斜杠，:id、:name 这类变量规则会遇到第一个 / 就截断，后面全丢掉。想让参数完整接收（比如 Base64 token、文件路径、多级标识符），必须显式改写匹配规则，不能依赖默认行为。
为什么默认参数不认斜杠
ThinkPHP 的内置变量规则底层用的是 PCRE 正则，:name 对应 [a-zA-Z0-9_-]+，:id 对应 \d+，都不包含 /；而且默认没加 u 修饰符，中文、点号、斜杠统统被拦在外面。
- 现象：访问
/api/download/2026/file/a/b/c.txt，控制器收到的$name只是2026，后面全没了 - 原因：路由解析器在第一个
/处就认为当前段结束，开始匹配下一段 - 关键点：不是 URL 重写或 Nginx 的问题，是 ThinkPHP 路由层自己截断的
用 \S+ 替代 .* 定义参数 pattern
\S+ 表示“一个或多个非空白字符”，比 .* 更安全——它不会跨段吞掉后续路由路径，也不会因贪婪匹配导致意外截断。
- 错误写法：
Route::get('api/file/:path', 'Api/File/download')->pattern(['path' => '.*']);→ 可能吃掉整个 URL 剩余部分 - 正确写法：
Route::get('api/file/:path', 'Api/File/download')->pattern(['path' => '\S+']); - 如果还要支持中文：
->pattern(['path' => '[\x{4e00}-\x{9fa5}\S]+'])，并确保 PHP 正则启用u模式（ThinkPHP 默认已开）
带斜杠参数必须配合 completeMatch(true)
当参数值含斜杠时，ThinkPHP 默认按“分段匹配”处理，容易和子路由冲突。启用 completeMatch(true) 强制整段 URL 一次性匹配，避免被中间的 / 拆开。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 不加这个：路由
api/log/:date+pattern(['date' => '\d{4}-\d{2}-\d{2}'])无法匹配/api/log/2026/09/01 - 加了之后：
Route::get('api/log/:date', 'Log/index')->pattern(['date' => '\S+'])->completeMatch(true);才能真正把2026/09/01当成一个整体传进去 - 注意：开启后该路由不再兼容传统分段式参数，要确保没有其他同前缀的更细粒度路由干扰
接收后务必做安全过滤
允许斜杠进来等于开放了路径遍历风险，$path = input('path') 直接拼文件系统路径是危险的。
- 先清理：
$clean = preg_replace('#\.{2,}|//+#', '', trim($path, '/')); - 再校验白名单（如只允许字母、数字、短横线、下划线、点号）：
if (!preg_match('/^[a-zA-Z0-9._\-\/]+$/', $clean)) { throw new HttpException(400); } - 最后拼路径时用
str_replace('../', '', $clean)防止绕过 - 别忘了：Nginx/Apache 配置里也得确认没对含斜杠的 URL 做额外拦截（比如某些安全模块会拒掉
//或../）
最常被忽略的是 completeMatch(true) 和安全过滤这两步——光改 pattern 不开完全匹配，参数还是会被切；开了匹配却不清理输入，等于给攻击者开了后门。
