用递归函数重命名PHP多维数组字段最可靠，核心是判断is_array($value)后递归处理，配合映射表避免硬编码；array_walk_recursive会丢失层级结构，不可用于此场景。
PHP多维数组重命名字段：用 array_map + 匿名函数最直接
直接改键名不能靠 str_replace 或遍历赋值再 unset，容易漏掉嵌套层级或破坏结构。核心思路是递归映射，而 array_map 配合匿名函数能干净地处理每一层的键映射逻辑。
常见错误是只处理第一层，比如对 $data[0]['user_name'] 改名，但忽略 $data[0]['profile']['first_name']；或者用引用遍历却没判断是否为数组，导致警告。
- 必须先判断当前元素是否为数组，否则对字符串或数字调用
array_keys会报Warning: array_keys() expects parameter 1 to be array - 键名映射规则建议用关联数组定义，例如
['user_name' => 'username', 'created_at' => 'createdAt']，避免硬编码散落在循环里 - 不要在回调里直接修改原数组键（PHP 不允许动态改键），而是构造新数组并返回
遇到深层嵌套时，必须递归处理
非递归方案（如两层 foreach）只能覆盖固定深度，一旦接口返回结构变动（比如从 2 层变 3 层），代码就失效。递归函数能自然适配任意嵌套层级，且不增加额外依赖。
示例中用到的递归函数长这样：
立即学习“PHP免费学习笔记（深入）”；
function renameKeys(array $arr, array $map): array
{
$result = [];
foreach ($arr as $key => $value) {
$newKey = $map[$key] ?? $key;
$result[$newKey] = is_array($value) ? renameKeys($value, $map) : $value;
}
return $result;
}
注意：is_array($value) 是关键守门员——跳过字符串、整数、null 等类型，防止无限递归或类型错误。
性能敏感场景下慎用 array_walk_recursive
array_walk_recursive 看似省事，但它会扁平化所有嵌套，丢失原始层级结构，无法区分 ['data' => ['id' => 1]] 和 ['data' => ['meta' => ['id' => 1]]] 中两个 id 的上下文，导致重命名失控。
- 它只传入值和“扁平后”的键，拿不到父级路径，没法做条件映射（比如只改
user.*.name，不改post.name） - 返回值是 void，必须靠引用修改原数组，容易引发意外副作用
- 如果字段名本身含点号（如
'user.name'），更会彻底乱套
字段名冲突或重复时 PHP 不报错，但结果不可控
PHP 数组键天然去重，如果映射表里有 ['old_a' => 'id', 'old_b' => 'id']，最终只有一个 id 被保留，后出现的值覆盖前一个——这个过程静默发生，没有任何 warning 或 notice。
调试时建议加一层校验：
$inverted = array_flip($map);
if (count($inverted) !== count($map)) {
throw new InvalidArgumentException('Duplicate target key detected in rename map');
}
真正麻烦的是那些没被映射、又不想保留的字段——它们会原样留下。如果你要的是“精确白名单式重命名”，就得在递归函数里加过滤逻辑，而不是依赖映射表兜底。
