答案：必须用parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)提取路径，urldecode()解码，并rtrim()去尾部斜杠；否则中文、query_string或/重复会导致404或参数丢失。
2026年PHP路由的落地重点不是“支持多少种写法”，而是「匹配是否稳定」「参数是否干净」「上线后会不会丢 query_string」——这三点踩错一个，就可能让接口在Nginx上返回404或参数为空。
怎么安全地从 $_SERVER['REQUEST_URI'] 提取路径
直接用 $_SERVER['REQUEST_URI'] 做匹配，90%的线上问题都出在这一步。它带 query 和 fragment，还未经解码，%E4%B8%AD%E6%96%87 这类编码根本不会被 strpos() 或简单正则识别为中文路径。
- 必须先
urldecode()，否则带中文、空格、斜杠编码的路由全失效 - 必须用
parse_url($uri, PHP_URL_PATH)取 path，不能靠explode('?', ...)截断——fragment（#xxx）也会混进来 - 统一
rtrim($path, '/')，否则/user和/user/被当两个路由，缓存和中间件逻辑容易错乱 - 别在匹配前做
basename()或dirname()——动态路由如/post/123/edit会直接崩
闭包路由注册时为什么参数总拿不到
闭包函数签名和路径占位符名称不一致，是 ThinkPHP、Laravel 风格框架里最常被忽略的隐性约定。框架不会报错，但参数值永远是 null 或空字符串。
- 路径写
/user/:id，闭包必须声明function($id) { ... }，不能写function($uid)或function($a) - 多个参数顺序必须严格对应：路径
/blog/:year/:month/:slug→ 闭包function($year, $month, $slug) - ThinkPHP6 中若用了
->pattern(['id' => '\d+'])，但闭包没声明$id，参数不会自动注入，也不会触发验证 - FastRoute 等编译型路由库更严格：参数名不匹配 = 匹配失败，直接 fallback 到 404
Apache/Nginx 转发到 index.php 时 query_string 丢失
本地测试一切正常，一上生产就发现 ?page=2&sort=name 消失了——这不是代码问题，是服务器配置漏了 QSA 或 $query_string。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- Apache 的
.htaccess必须带[QSA,L]：RewriteRule ^ index.php [QSA,L]—— 少QSA，所有 GET 参数清零 - Nginx 的
try_files必须显式拼接：try_files $uri $uri/ /index.php?$query_string;—— 写成/index.php或/index.php?都会丢参 - PHP-FPM 场景下，还要检查
fastcgi_param QUERY_STRING $query_string;是否存在，某些精简镜像会默认删掉这行 - 用
var_dump($_GET, $_REQUEST, $_SERVER['QUERY_STRING'])在index.php开头快速验证是否真丢了
为什么 FastRoute 比手写正则匹配快得多
不是因为它用了更高级的算法，而是它把「路由编译」和「请求匹配」彻底分离：编译只做一次（启动或部署时），匹配阶段完全跳过正则解析和数组遍历。
- 手写循环 +
preg_match()：每次请求都要重编译全部正则，100 条路由 ≈ 100 次 PCRE 编译开销 - FastRoute 把所有规则预编译成静态路由树（trie），匹配时仅做 O(k) 字符比较（k 是路径长度）
- 实际压测中，1000+ 路由下，FastRoute 的匹配耗时稳定在 0.02ms 内；手写方式在高并发下可能飙到 0.5ms 以上
- 注意：FastRoute 的
Dispatcher实例必须复用，不能每次请求 new 一个——否则编译开销又回来了
真正难的从来不是写出能跑的路由，而是确保它在 Nginx 的 try_files、PHP-FPM 的 fastcgi_param、以及前端带 hash 的 SPA 路由之间，始终把原始路径和 query string 完整、无损地交到你的闭包或控制器手里。
