<?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 對鍵類型分支處理:
設計初衷:模擬數組合並 ($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() 或 手動遍歷賦值。代碼審查時務必檢查合併邏輯,避免數據靜默錯位。