萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP array_merge 陷阱:數字鍵名不覆蓋反而重新索引

現象復現

<?php
$a1 = [1 => 'abc', 3 => 10];
$a2 = [1 => 'efg', 3 => 20];
print_r(array_merge($a1, $a2));
/* 輸出:
Array
(
    [0] => abc
    [1] => 10
    [2] => efg
    [3] => 20
)
*/
// 預期:[1 => 'efg', 3 => 20] 實際:數字鍵被重新連續索引,值未覆蓋!

官方文檔規則

「如果輸入數組具有相同的字符串鍵名,後面的值將覆蓋前面的值。然而,如果數組包含數字鍵名,後面的值將不會覆蓋,而是附加到後面。如果只給了一個數組並且該數組是數字索引的,則鍵名會以連續方式重新索引。」

底層邏輯

PHP 內核中 php_array_merge 對鍵類型分支處理:

  • 字符串鍵:直接覆蓋哈希表桶。
  • 數字鍵:視為「列表」,重新分配連續索引 0,1,2… 保留所有值。

設計初衷:模擬數組合並 ($a + $b 保留鍵,array_merge 重新索引)。

正確覆蓋合併方案

方案一:+ 運算符(保留第一個數組的鍵)

$result = $a1 + $a2; 
// [1 => 'abc', 3 => 10]  // $a2 的值被忽略,鍵衝突時保留左邊

方案二:array_replace()(後者覆蓋前者,保留鍵名)

$result = array_replace($a1, $a2);
// [1 => 'efg', 3 => 20]  // 完美符合預期!

array_replace 遞歸版 array_replace_recursive 同理。

方案三:手動遍歷(完全控制)

$result = $a1;
foreach ($a2 as $k => $v) {
    $result[$k] = $v; // 直接賦值,自然覆蓋
}

實戰建議

場景推薦函數/運算符行為
合併配置數組(字符串鍵)array_merge後覆蓋前
合併 ID 索引數據(數字鍵)array_replace後覆蓋前,保留鍵
合併列表(不關心鍵)array_merge重新索引 0..n
預設值 + 用戶配置$default + $user用戶值補充,不覆蓋預設

擴展:多維數組深度合併

function deepMerge(array ...$arrays): array {
    $result = [];
    foreach ($arrays as $arr) {
        foreach ($arr as $k => $v) {
            if (isset($result[$k]) && is_array($result[$k]) && is_array($v)) {
                $result[$k] = deepMerge($result[$k], $v);
            } else {
                $result[$k] = $v; // 直接覆蓋(含數字鍵)
            }
        }
    }
    return $result;
}

總結

array_merge 對數字鍵「重新索引而非覆蓋」是 PHP 歷史遺留設計。需要「鍵名保留 + 後覆蓋前」時,請毫不猶豫使用 array_replace() 或 手動遍歷賦值。代碼審查時務必檢查合併邏輯,避免數據靜默錯位。

copyright © 萬盛學電腦網 all rights reserved