PHP中利用映射数组重命名数组键名，嵌套数组处理遇阻求助

我懂你现在的处境——一维数组的键名替换用映射数组搞定毫无压力，但碰到嵌套数组直接就懵了，根本不知道怎么深入到每一层处理对吧？别担心，核心解法就是递归遍历，不管数组嵌套多少层，都能把每个层级的键名按映射关系替换掉。

下面一步步给你拆解解决方案：

1. 先定义你的键名映射数组 #

首先把所有需要替换的旧键和新键对应好，比如：

$keyMapping = [
    'old_user_id' => 'user_id',
    'old_user_name' => 'username',
    'old_contact' => 'contact_info',
    'old_phone' => 'phone_number',
    'old_street' => 'street'
];

2. 你的原始嵌套数组示例 #

假设你要处理的数组是这样的（包含多层嵌套）：

$originalData = [
    'old_user_id' => 1001,
    'old_user_name' => 'John Doe',
    'old_contact' => [
        'old_phone' => '123-456-7890',
        'email' => 'john@example.com', // 这个键不需要替换，保留原名称
        'address' => [
            'old_street' => '123 Main St',
            'city' => 'New York'
        ]
    ]
];

3. 期望的输出结果 #

就是所有层级的旧键都被替换成新键后的数组：

$expectedResult = [
    'user_id' => 1001,
    'username' => 'John Doe',
    'contact_info' => [
        'phone_number' => '123-456-7890',
        'email' => 'john@example.com',
        'address' => [
            'street' => '123 Main St',
            'city' => 'New York'
        ]
    ]
];

4. 核心递归处理函数 #

这个函数会自动遍历数组的每一层，处理键名替换：

function renameNestedArrayKeys(array $inputArray, array $keyMap): array {
    $outputArray = [];

    foreach ($inputArray as $oldKey => $value) {
        // 优先使用映射里的新键，没有则保留原键名
        $newKey = $keyMap[$oldKey] ?? $oldKey;

        // 如果当前值是数组，递归调用函数处理嵌套层
        if (is_array($value)) {
            $outputArray[$newKey] = renameNestedArrayKeys($value, $keyMap);
        } else {
            $outputArray[$newKey] = $value;
        }
    }

    return $outputArray;
}

5. 调用函数并验证结果 #

直接用你的原始数组和映射数组调用函数就行：

$transformedData = renameNestedArrayKeys($originalData, $keyMapping);

// 打印结果查看是否符合预期
print_r($transformedData);

关键逻辑说明 #

• 递归遍历：当遇到值为数组的元素时，函数会自己调用自己，深入到下一层处理，直到所有嵌套层级都被遍历完
• 键名替换规则：使用PHP7+的??空合并运算符，优先取映射数组里的新键，没有匹配的键名就直接保留原键，不会破坏原数组的结构
• 兼容性：不管是字符串还是整数类型的键名，这个函数都能正常处理，和你之前处理一维数组的逻辑一致，只是多了递归处理嵌套的环节

额外提示 #

如果你的数组里混合了对象（比如stdClass），可以在函数里加个is_object()的判断，把对象转成数组再处理，但如果只是纯数组的话，上面的代码完全够用。

内容的提问来源于stack exchange，提问作者Bastin Robin