如何将ThinkPHP请求参数路径扁平化，实现a_b_c转a.b.c格式映射？

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

ThinkPHP的路由变量解析是基于字符串匹配的，例如：

常见错误现象：你在 URL 里写 /api/user?sort_field=created_at&sort_order=desc，控制器里想用 $request->param('sort.field') 取值，结果返回 null；或者用 $request->param('sort') 拿到的是空数组。

• 核心原因：ThinkPHP 的 param() 方法只对显式传入的嵌套结构（如 JSON body、表单数组名 sort[field]）做点号解析，对下划线命名的查询参数不做任何转换
• 解决路径只有两个：改请求格式（前端配合），或后端预处理（推荐）
• 别指望在 route.php 里加个正则就能让 a_b_c 自动变 a.b.c —— 路由层根本没机会介入参数键名标准化

在 app/common.php 或中间件里统一扁平化 $_GET 参数

最稳妥的做法是在请求进入控制器前，把所有下划线参数键名转成点号结构，并挂载为可被 param() 识别的嵌套数组。这不是“魔法”，而是手动构造 ThinkPHP 认可的嵌套形态。

使用场景：API 接口大量使用 filter_name、page_size 这类命名，但业务逻辑希望统一走 filter.name、page.size 访问。