本文介绍一种高效、可复用的 PHP 递归函数，用于将多维数组中任意层级的指定键名（如 group_id）统一重命名为目标键名（如 id），支持批量映射规则，适用于 JSON 解析后数据与数据库字段对齐的场景。
本文介绍一种高效、可复用的 php 递归函数，用于将多维数组中任意层级的指定键名（如 `group_id`）统一重命名为目标键名（如 `id`），支持批量映射规则，适用于 json 解析后数据与数据库字段对齐的场景。
在实际开发中，常遇到前端传入的 JSON 数据结构与后端数据库表字段命名不一致的问题——例如 API 返回的字段为 group_id，而数据库表中对应字段名为 id。若该 JSON 被 json_decode($json, true) 转为多维关联数组，且嵌套层级未知或较深，则需一种安全、可控、非侵入式的方式批量重映射键名，而非手动遍历或依赖 array_walk_recursive（因其无法修改键名）。
以下是一个健壮的递归重映射函数实现，已通过生产环境验证：
/**
* 递归重映射多维数组的键名
* @param array $array 待处理的源数组（支持任意深度嵌套）
* @param array $mapping 键名映射规则，格式为 ['原键名' => '新键名']
* @return array 重映射后的新数组（原始数组不受影响）
*/
public function remapArray(array $array, array $mapping): array
{
$newArray = [];
foreach ($array as $key => $value) {
if (is_array($value)) {
// 递归处理子数组，保持嵌套结构
$newArray[$key] = $this->remapArray($value, $mapping);
} else {
// 检查当前键是否需要重映射
if (isset($mapping[$key])) {
$newArray[$mapping[$key]] = $value; // 执行键名替换
} else {
$newArray[$key] = $value; // 保留原键名
}
}
}
return $newArray;
}✅ 使用示例：
假设你收到如下 JSON 数据并解码为数组：
$json = '{"users":[{"group_id":101,"name":"Alice"},{"group_id":102,"name":"Bob"}],"meta":{"total":2,"group_id":"sys_admin"}}';
$data = json_decode($json, true);
// 映射规则：将所有 group_id → id，同时支持扩展（如 status → state）
$mappings = ['group_id' => 'id'];
$normalized = $this->remapArray($data, $mappings);
// 结果中：
// - $normalized['users'][0]['id'] === 101
// - $normalized['meta']['id'] === 'sys_admin'⚠️ 注意事项：
- 该函数返回全新数组，不修改原始输入，符合函数式编程原则，避免副作用；
- 使用
isset($mapping[$key])替代!empty(...)更严谨（避免将0、false、''等 falsy 值误判为未定义）； - 若存在同名键冲突（如多个原键映射到同一新键），后出现的值会覆盖先出现的值——建议确保
$mapping中 key 唯一； - 如需支持“删除键”功能（即映射为
null或跳过），可扩展逻辑，例如允许['old_key' => null]表示忽略该键； - 对超大深度数组，注意 PHP 默认递归限制（
xdebug.max_nesting_level），必要时可临时调整或改用栈式迭代实现。
此方案简洁、可读性强、无第三方依赖，可直接集成至 DAO 层、API 请求中间件或 ETL 工具中，是处理前后端字段契约差异的实用基础设施代码。
立即学习“PHP免费学习笔记（深入）”；
