ThinkPHP需手动将user[name]等一维表单键名解析为嵌套数组，推荐用Request::param()配合自定义flattenToNested函数实现，遍历键名按方括号切分路径逐级构建，适用于5.1+版本，验证器需先还原再传参。
ThinkPHP 接收前端一维参数自动转嵌套结构
ThinkPHP 默认不支持把 user[name]、user[age] 这类一维表单键名自动还原成 ['user' => ['name' => 'xxx', 'age' => 18]] 的嵌套数组。这不是 bug，是设计使然 —— 框架原生只做基础解析，嵌套逻辑需手动介入。
用 Request::param() + 自定义解析函数最稳妥
别依赖 input() 或直接取 $_POST，它们返回的仍是扁平键名。必须在获取原始参数后，自己写一层解析逻辑。核心思路：遍历所有键名，按方括号 [ 和 ] 切分路径，逐级构建嵌套数组。
- 常见错误现象：
Request::param('user.name')返回 null，因为实际键是user[name]，不是点号路径 - 使用场景：表单含多层级字段（如用户信息、地址、订单项），前端为简化序列化用
name="profile[avatar][url]" - 性能影响极小，一次遍历，无递归，100 个字段也毫秒级
- 兼容性好，5.1/6.0/6.1/6.2 全适用，不依赖模型或验证器
示例函数：
function flattenToNested($data) {
$result = [];
foreach ($data as $key => $value) {
if (false === strpos($key, '[')) {
$result[$key] = $value;
continue;
}
$keys = preg_split('/\[|\]/', $key, -1, PREG_SPLIT_NO_EMPTY);
$ref =& $result;
foreach ($keys as $k) {
if (!isset($ref[$k])) $ref[$k] = [];
$ref =& $ref[$k];
}
$ref = $value;
}
return $result;
}
在控制器中调用：$params = flattenToNested(Request::param());
立即学习“PHP免费学习笔记（深入）”；
别在验证规则里硬写点号路径
有人试图在 validate 规则里写 'user.name'=>'require'，这会失败。ThinkPHP 验证器默认只认一级键名，不解析嵌套。除非你先用上面的方法把参数转好，再传给验证器。
- 容易踩的坑：直接对原始
Request::param()结果调用validate($data, $rule)，规则里的点号路径全失效 - 正确做法：先执行
flattenToNested()，再把结果交给验证器；或改用scene+ 数组规则（如'user' => ['name' => 'require']） - 注意：如果用了
scene，且字段本身是嵌套结构，验证器能识别，但前提是数据已经是嵌套格式，不是扁平字符串键
Form 表单提交时注意 enctype 和 method
这个还原逻辑只对 application/x-www-form-urlencoded 和 multipart/form-data 有效。如果是 JSON 请求体（Content-Type: application/json），前端本就该发嵌套对象，后端直接 Request::param() 就是嵌套结构，无需额外处理。
- 常见错误现象：AJAX 发 JSON，却还套用
user[name]键名，导致后端收到的是字符串而非数组 - 区分清楚：表单提交走传统编码，API 调用建议走 JSON —— 两者参数结构生成机制完全不同
- 兼容旧系统时，可在中间件里统一拦截
Content-Type: application/x-www-form-urlencoded请求，自动执行flattenToNested
真正麻烦的不是写几行解析代码，而是前后端对“参数结构由谁负责”没对齐。一旦约定好前端传 JSON，后端就不用扁平化；若必须用表单编码，那后端就得扛起还原责任 —— 没有银弹，只有明确分工。
