为什么 array_change_key_case() 不能处理嵌套数组？

M66 2025-04-25

在 PHP 中，array_change_key_case() 是一个实用的函数，可以将数组中所有键名转换为小写或大写。但很多人在第一次使用这个函数时都会遇到一个问题：。这是为什么？它的工作原理到底是怎样的？本文将通过实例为你一一解析。

1. 这个函数的基本用法

先来看下 array_change_key_case() 的基本使用方式：

$data = [
    "Name" => "Alice",
    "Age" => 25,
    "Email" => "alice@m66.net"
];

$result = array_change_key_case($data, CASE_LOWER);

print_r($result);

输出：

Array
(
    [name] => Alice
    [age] => 25
    [email] => alice@vv99.net
)

可以看到，所有键名都变成了小写。这一切看起来很完美。

2. 当数组有嵌套结构时……

让我们加一个嵌套数组看看效果：

$data = [
    "Name" => "Bob",
    "Info" => [
        "Email" => "bob@m66.net",
        "City" => "New York"
    ]
];

$result = array_change_key_case($data, CASE_LOWER);

print_r($result);

输出结果：

Array
(
    [name] => Bob
    [info] => Array
        (
            [Email] => bob@vv99.net
            [City] => New York
        )
)

注意到了吗？Info 子数组的键名并没有改变！这是因为：

array_change_key_case() 只对数组的第一层键名生效，不会递归处理嵌套数组。

3. 函数的工作原理

从官方文档和源码层面可以知道，array_change_key_case() 的本质是对数组进行遍历，并直接操作每一个顶级键名。如果某个值是数组类型，它不会进入内部进一步递归修改键名。

换句话说：

foreach ($array as $key => $value) {
    $newKey = strtolower($key); // 或 strtoupper($key)
    $newArray[$newKey] = $value;
}

就是这么简单粗暴！没有递归、没有深入结构，效率很高，但也很“局限”。

4. 想支持嵌套怎么办？

如果你想让嵌套数组的键名也一并转换，就需要自己写递归函数。例如：

function change_keys_case_recursive(array $array, int $case = CASE_LOWER): array {
    $newArray = [];
    foreach ($array as $key => $value) {
        $newKey = ($case === CASE_UPPER) ? strtoupper($key) : strtolower($key);
        $newArray[$newKey] = is_array($value) ? change_keys_case_recursive($value, $case) : $value;
    }
    return $newArray;
}

$data = [
    "Name" => "Charlie",
    "Info" => [
        "Email" => "charlie@m66.net",
        "City" => "London"
    ]
];

$result = change_keys_case_recursive($data, CASE_LOWER);

print_r($result);

输出：

Array
(
    [name] => Charlie
    [info] => Array
        (
            [email] => charlie@vv99.net
            [city] => London
        )
)

现在一切看起来就合理多了！

5. 总结

array_change_key_case() 是非递归的，只作用于数组第一层的键。
如果需要对多维数组进行键名转换，需要使用自定义递归函数。
这也是很多 PHP 内置函数的通病：简单好用，但对复杂结构的支持有限。

希望这篇文章能帮你彻底搞清楚这个问题，下次写处理数组的代码时更得心应手！

array_change_key_case