使用 array_change_key_case() 处理包含相同键的数组时的风险

M66 2025-04-25

在 PHP 中，array_change_key_case() 是一个非常实用的函数，用于将数组中的键名全部转换为小写或大写。但在实际开发中，有时我们处理的数组中可能已经存在键名大小写不同但内容相同的情况，例如 'Name' 和 'name'。这时我们使用 array_change_key_case() 会发生什么呢？

函数简介

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

这个函数接受两个参数：

$array：需要处理的数组；
$case：转换的目标大小写类型，默认是 CASE_LOWER（小写），可以改为 CASE_UPPER（大写）。

返回值是一个键名已转换的新数组，原数组不会被修改。

键名冲突时的行为

如果原始数组中存在键名大小写不同但内容相同的多个键，例如：

$array = [
    "Name" => "Alice",
    "name" => "Bob"
];

当我们执行：

$result = array_change_key_case($array, CASE_LOWER);
print_r($result);

输出将是：

Array
(
    [name] => Bob
)

可以看到，"Name" 和 "name" 在转换为小写后都变成了 "name"，此时后面的键值会覆盖前面的值，因此最终保留下来的是 "name" => "Bob"。

换句话说，键名冲突时，后一个键值会覆盖前一个。

应用场景提醒

这种行为在你处理来自不同来源的数据合并时尤其需要注意。例如：

$userData = [
    "Email" => "alice@m66.net",
    "email" => "duplicate@m66.net"
];

$cleanedData = array_change_key_case($userData, CASE_LOWER);
print_r($cleanedData);

结果将是：

Array
(
    [email] => duplicate@vv99.net
)

这可能导致数据被无意覆盖，因此如果你担心这种情况，建议在转换前先检查是否存在键名冲突，或者使用更细致的处理方式（例如遍历并手动检测）。

总结

使用 array_change_key_case() 可以统一键名的大小写，提升代码一致性。但如果数组中存在大小写不同但内容相同的键名，它们会在转换后产生冲突，后面的值会覆盖前面的值。在使用此函数时应当谨慎处理这类情况，特别是在涉及数据整合或用户输入的数据结构中。

array_change_key_case