误用 array_change_key_case() 导致键名数据丢失的情况

M66 2025-04-28

在 PHP 开发中，array_change_key_case() 是一个非常方便的函数，它可以将数组中的所有键名统一转换为大写或小写。但你是否知道，

下面我们就来通过一个具体的例子看看这个问题到底是怎么发生的。

一、函数简介

array_change_key_case(array $array, int $case = CASE_LOWER): array

$array：输入的数组。
$case：可选参数，默认是 CASE_LOWER（小写），也可以设置为 CASE_UPPER（大写）。

二、危险示例：键名大小写冲突导致数据丢失

$data = [
    'Name' => 'Alice',
    'name' => 'Bob',
    'Age'  => 25,
];

$result = array_change_key_case($data, CASE_LOWER);

print_r($result);

输出结果：

Array
(
    [name] => Bob
    [age] => 25
)

你看到了吗？'Name' => 'Alice' 这一项已经不见了！
这是因为 'Name' 和 'name' 在转换为小写后都变成了 'name'，导致 'Alice' 被 'Bob' 覆盖了！

三、为什么会这样？

array_change_key_case() 并不会检测是否存在“大小写不同但实际相同”的键名，它只是简单粗暴地替换键名大小写。一旦有冲突，后面的键会覆盖前面的键，而你甚至不会收到任何警告或错误提示。

这在处理来自多个来源的数据时，尤其危险。比如你在做表单合并、API 合并时，如果没有意识到键名大小写冲突，数据就会在不知不觉中丢失。

四、如何避免这个坑？

? 方法一：手动检查冲突

在调用 array_change_key_case() 之前，可以先检测原数组中是否存在键名大小写冲突：

function hasKeyCaseConflict(array $array): bool {
    $lowerKeys = [];
    foreach ($array as $key => $value) {
        $lower = strtolower($key);
        if (isset($lowerKeys[$lower])) {
            return true;
        }
        $lowerKeys[$lower] = true;
    }
    return false;
}

$data = [
    'Name' => 'Alice',
    'name' => 'Bob',
];

if (hasKeyCaseConflict($data)) {
    echo "键名存在大小写冲突，请处理后再转换。";
} else {
    $result = array_change_key_case($data);
    print_r($result);
}

? 方法二：合并前规范化来源数据

如果你在处理外部数据，比如通过 API 拉取的内容，可以在合并前进行数据标准化，或者明确规定键名规则：

$apiData = json_decode(file_get_contents('https://m66.net/api/user'), true);

// 假设来源可靠，统一小写后再使用
$safeData = array_change_key_case($apiData, CASE_LOWER);

五、小结

虽然 array_change_key_case() 是一个简单实用的函数，但它的潜在破坏性不容忽视。当你处理的数据中可能存在键名大小写重复的情况时，请务必三思而后行！

?? 小贴士：

默认行为不会提示冲突！
数据可能在“悄悄地”被覆盖！
越是数据整合的场景，越要小心使用！

array_change_key_case