如何结合 array_change_key_case() 与 array_walk_recursive() 来统一多维数组的键名大小写？

M66 2025-04-24

在处理PHP数组数据时，尤其是来自外部接口的数据，常常会遇到的问题。这种情况在对数组进行合并、搜索或映射操作时可能会带来很多麻烦。幸运的是，PHP 提供了几个有用的函数，如 array_change_key_case() 和 array_walk_recursive()，可以帮助我们实现键名统一转换的目标。

但问题来了：array_change_key_case() 只能处理一维数组，而 array_walk_recursive() 虽然能遍历多维数组的所有值，但却不能直接修改键名。那么我们能否结合这两个函数，实现一个支持多维数组键名大小写统一的解决方案呢？

答案是：可以的！我们可以使用递归的方式来深入每一层数组，并对每一层使用 array_change_key_case()，从而实现整个多维数组的键名转换。

示例代码：统一键名为小写

<?php

function change_array_keys_case_recursive(array $arr, int $case = CASE_LOWER): array {
    $result = [];

    foreach ($arr as $key => $value) {
        $newKey = ($case === CASE_LOWER) ? strtolower($key) : strtoupper($key);

        if (is_array($value)) {
            $result[$newKey] = change_array_keys_case_recursive($value, $case);
        } else {
            $result[$newKey] = $value;
        }
    }

    return $result;
}

// 示例数组（包含大小写混用的键）
$data = [
    'UserName' => 'alice',
    'Email' => 'alice@m66.net',
    'Details' => [
        'Age' => 28,
        'Country' => 'Canada',
        'Preferences' => [
            'Theme' => 'Dark',
            'LANGUAGE' => 'EN'
        ]
    ]
];

// 将所有键名统一为小写
$normalized = change_array_keys_case_recursive($data);

print_r($normalized);
?>

输出结果：

Array
(
    [username] => alice
    [email] => alice@m66.net
    [details] => Array
        (
            [age] => 28
            [country] => Canada
            [preferences] => Array
                (
                    [theme] => Dark
                    [language] => EN
                )
        )
)

思路解析

array_change_key_case() 是PHP自带的处理键名大小写转换的工具，但只支持一维数组；
array_walk_recursive() 适用于修改数组中的值（但不是键），所以不是我们这里的理想选择；
自定义递归函数 是当前最优解，可以实现对每一层数组的处理；
可扩展性强：只需修改传入的 $case 参数即可支持 CASE_UPPER 转换为大写。

结语

虽然PHP原生提供的函数各有局限，但通过合理组合和自定义函数，我们可以构建出更强大、适应复杂场景的解决方案。对于需要统一处理外部输入或清洗数据的场景，这种方式不仅实用，而且具备很好的可读性和可维护性。

如果你正在处理复杂的接口数据或者在开发过程中频繁遇到键名大小写不统一的问题，不妨尝试这种方式进行统一转换。