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