如何使用ThinkPHP对斜杠路由参数进行编码解码？

本文共计891个文字，预计阅读时间需要4分钟。

ThinkPHP默认将URL中的/作为路径分隔符，而不是参数的一部分。因此，在路由定义中，如果你写了/:id，框架在解析阶段就会提前截断，不会继续到你的控制器。

例如，如果你想要匹配类似user/123的URL，只需使用$id变量即可，而不是直接写参数名：

用 [:id] 方式捕获带斜杠的参数（5.1+ 推荐）

ThinkPHP 5.1 及以上支持「可选段」语法 [:id]，它会贪婪匹配直到下一个固定路径段或 URL 结尾，天然兼容斜杠。但要注意两点：必须确保该参数是路由末尾，且不能和后续固定路径冲突。

• 正确写法：route('article/[:path]', 'index/article/read')，访问 /article/user/123/edit 时，$path 值为 user/123/edit
• 错误写法：route('article/[:path]/detail', ...)，这种写法无法区分 /article/a/b/detail 中的 a/b 和 a，实际匹配不可靠
• 控制器接收时，$path 是原始字符串，无需额外解码，但需自行校验合法性（如防止路径穿越）

URL 编码不是万能解，%2F 在 ThinkPHP 中默认仍被截断

很多人尝试对斜杠做 encodeURIComponent('a/b') 得到 a%2Fb，再拼进 URL。但 ThinkPHP 内部在解析前会先进行 URL 解码，%2F 又变回 /，照样触发分隔逻辑。所以单纯编码无效。

• 绕过方法：改用其他占位符替代斜杠，比如 _ 或 .，控制器中再 str_replace('_', '/', $id)
• 更稳妥做法：用 base64_encode() 编码整个参数（注意替换 +、/、= 为 URL 安全字符），再在控制器里解码——但要留意长度限制和可读性损失
• 别依赖 urldecode() 手动处理请求字符串，ThinkPHP 的 input() 或路由变量已自动解码，重复解码会导致乱码

自定义正则路由强制捕获斜杠（5.0 兼容方案）

ThinkPHP 5.0 不支持 [:id]，必须用正则。关键点在于：正则要显式允许 /，且不能写成 [^/]+ 这类默认排除斜杠的模式。

立即学习“PHP免费学习笔记（深入）”；

• 推荐正则：[\s\S]* 或 .*（开启 U 单行模式），例如：route('file/<path>', 'index/file/view')->pattern(['path' => '.*']);</path>
• 注意：Apache 下需确认 AllowOverride All 且 .htaccess 没有二次截断；Nginx 则要确保 try_files 规则把整个 URI 传给 index.php，而不是只传前几段
• 安全提醒：这类宽泛匹配极易引入路径遍历风险，务必在控制器开头用 realpath() + strpos() 校验最终路径是否落在允许目录内

真正麻烦的不是怎么传过去，而是传过去之后怎么安全地用——斜杠参数几乎总意味着你要拼路径、读文件或查嵌套资源，每一步都得防住 ../、空字节、非法编码这些老问题。