ThinkPHP如何做请求参数结构扁平化反向映射_ThinkPHP一维键名还原为嵌套路径【方法】-ThinkPHP-PHP中文网

thinkphp 默认将表单嵌套名如 userprofile 扁平化为 user_profile_avatar，导致 param('user.profile.avatar') 失败；可通过关闭 app.convert_input_name 配置、手写 undot 函数还原或改用 json 请求体解决。

thinkphp如何做请求参数结构扁平化反向映射_thinkphp一维键名还原为嵌套路径【方法】

为什么 `input()` 返回的数组和表单嵌套名对不上

ThinkPHP 默认把 name="user[profile][avatar]" 这种 HTML 表单字段解析成一维键名 user_profile_avatar，而不是你预期的嵌套数组 ['user' => ['profile' => ['avatar' => 'xxx']]]。这是为了兼容早期 PHP $_POST 自动扁平化行为，但现代接口开发里反而成了障碍。

常见错误现象：$this->request->param('user.profile.avatar') 返回 null，但 $this->request->param('user_profile_avatar') 能取到值；用 validate() 校验嵌套规则时字段找不到。

根本原因是 Request 类在初始化时调用了 buildParam()，默认启用 convertName() 扁平化逻辑
该行为由配置项 app.convert_input_name 控制（默认为 true）
不改配置的话，所有 param()、post()、get() 都走扁平路径，无法还原原始嵌套结构

关闭自动扁平化：修改 `app.convert_input_name` 配置

最直接的办法是关掉这个开关，让 ThinkPHP 原样保留点号/中括号语法的嵌套结构。注意这不是“修复”，而是切换解析策略。

在 config/app.php 中设置：

'convert_input_name' => false,

之后 $this->request->param() 就会返回真实嵌套数组，$this->request->param('user.profile.avatar') 也能正常取值。

该配置影响全局所有请求参数（GET、POST、PUT 等），不可按路由或控制器单独关闭
如果项目已存在大量用 user_profile_avatar 方式取值的代码，关掉后会直接报错，必须同步重构
PHP 版本 ≥ 7.4 且使用 Swoole 或 Hyperf 兼容模式时，该配置仍生效，但要注意 Swoole 的 $_POST 本身不支持原生嵌套，需确保前端发的是 JSON 或正确编码的表单

不改配置时手动还原嵌套结构：用 `think\helper\Arr::dot()` 反向展开

如果你不能动全局配置（比如维护老项目），又需要某次请求里拿到嵌套结构，就得自己把扁平键名“翻译”回去。ThinkPHP 自带的 Arr::dot() 是正向打平，没有内置反向方法，得手写一个轻量还原函数。

示例：把 ['user_profile_avatar' => '/1.png', 'user_profile_name' => 'Tom'] 变成 ['user' => ['profile' => ['avatar' => '/1.png', 'name' => 'Tom']]]：

function unDot(array $flat): array
{
    $result = [];
    foreach ($flat as $key => $value) {
        $keys = explode('_', $key);
        $ref =& $result;
        while (count($keys) > 1) {
            $k = array_shift($keys);
            if (!isset($ref[$k])) $ref[$k] = [];
            $ref =& $ref[$k];
        }
        $ref[array_shift($keys)] = $value;
    }
    return $result;
}