ThinkPHP默认不将路由参数a_b_c自动转为a.b.c，需在中间件中手动将$_GET下划线键名转换为嵌套数组结构，使$request->param('a.b.c')可正常读取，否则返回null。
ThinkPHP 路由参数自动把 a_b_c 转成 a.b.c 怎么配
默认不支持，必须手动干预。ThinkPHP 的路由变量解析是按字面匹配的，a_b_c 就是字符串 a_b_c，不会自动替换成点号结构 —— 这不是 bug，是设计使然。
常见错误现象：你在 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 访问。
- 不要动
Request类源码，也不要用setParam()直接塞扁平键 —— 它不支持点号解析，只会当字面 key 存 - 正确做法：在全局中间件中重写
$request->get()返回值，把['a_b_c' => 'x']转成['a' => ['b' => ['c' => 'x']]] - 注意兼容性：如果同时有
a_b_c和a_b，转换后后者会覆盖前者的一部分结构，得加冲突检测
// 示例：中间件 handle() 中
$params = $request->get();
$nested = [];
foreach ($params as $key => $val) {
$keys = explode('_', $key);
$ref = &$nested;
foreach ($keys as $k) {
if (!isset($ref[$k])) $ref[$k] = [];
$ref = &$ref[$k];
}
$ref = $val;
}
$request = $request->setGetParams($nested);
$request->param() 能否直接读取点号路径？哪些情况会失效
可以，但仅限于它能识别的嵌套来源：表单数组名（user[name]）、JSON body、以及你上面手动注入的嵌套 get 数组。原始 $_GET 里的 a_b_c 永远不会被 param('a.b.c') 命中。
容易踩的坑：
- 调用
$request->param('a.b.c')前没确保a是数组，否则报 PHP notice（访问数组偏移量） - 用了
$request->only(['a.b.c'])却没提前扁平化，结果返回空数组 ——only()不做键名转换 - POST 表单含
data[filter][field]，但 URL 同时带?filter_field=x，两者不会合并，param('filter.field')只取前者
要不要在验证器里也做下划线转点号适配
要，而且必须和参数预处理保持一致。验证器的 rule 键名（如 'filter.field' => 'require|alpha'）依赖 param() 返回结构，如果参数没提前嵌套，验证永远过不了。
性能影响几乎为零，但要注意两点：
- 验证器字段名写
filter.field，就别再写filter_field—— 混用会导致部分规则不触发 - 如果用了
scene，且不同场景依赖不同结构，得确认预处理是否覆盖全部入口（比如 CLI 命令行调用时$_GET为空，不能只处理 GET） - 别在验证器里写逻辑去“修复”键名，那会让数据流不可控；统一收口到中间件或
common.php初始化逻辑里
真正麻烦的不是怎么转，而是转完之后整个请求生命周期里所有地方（验证、赋值、日志、调试输出）都得按新结构理解参数 —— 一旦漏掉一处，问题就藏得特别深。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
