誤用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