PHP提供多種數組合併方式,行為差異巨大。本文深度對比array_merge、+運算符、array_merge_recursive、array_replace、array_replace_recursive在數字鍵、字符串鍵、嵌套數組、非數組參數下的行為,並給出選型指南。
| 特性 | array_merge | + 運算符 | array_merge_recursive | array_replace | array_replace_recursive |
|---|---|---|---|---|---|
| 數字鍵 | 重新索引(0,1,2...) | 保留原鍵,先出現者優先 | 重新索引 | 保留原鍵,後出現者覆蓋 | 保留原鍵,遞歸覆蓋 |
| 字符串鍵 | 後者覆蓋前者 | 先出現者優先 | 值合併為數組 | 後者覆蓋前者 | 遞歸覆蓋 |
| 嵌套數組 | 不遞歸(覆蓋) | 不遞歸(覆蓋) | 遞歸合併值為數組 | 不遞歸(覆蓋) | 遞歸覆蓋 |
| 非數組參數 | 報Warning並跳過 | 拋出TypeError (PHP 8+) | 報Warning | 報Warning | 報Warning |
| 返回類型 | 數組 | 數組 | 數組 | 數組 | 數組 |
$a = ['a' => 1, 0 => 'x', 'nested' => ['k' => 10]];
$b = ['b' => 2, 1 => 'y', 'nested' => ['k' => 20, 'm' => 30]];
// array_merge
print_r(array_merge($a, $b));
/*
Array
(
[a] => 1
[0] => x
[nested] => Array ([k] => 20, [m] => 30) // 覆蓋
[b] => 2
[1] => y
)
*/
// + 運算符
print_r($a + $b);
/*
Array
(
[a] => 1
[0] => x
[nested] => Array ([k] => 10) // 保留第一個
[b] => 2
[1] => y // 數字鍵1已存在於$a,故保留$a的'x'
)
*/
// array_merge_recursive
print_r(array_merge_recursive($a, $b));
/*
Array
(
[a] => 1
[0] => x
[nested] => Array ([k] => Array (0 => 10, 1 => 20), [m] => 30) // 值合併為數組
[b] => 2
[1] => y
)
*/
// array_replace (PHP 5.3+)
print_r(array_replace($a, $b)); // 同array_merge字符串鍵行為,但數字鍵保留
// array_replace_recursive
print_r(array_replace_recursive($a, $b)); // 遞歸覆蓋 nested.k=20, 新增nested.m=30
function safe_merge(array ...$arrays): array {
$result = [];
foreach ($arrays as $arr) {
if (!is_array($arr)) continue; // 靜默忽略非數組
foreach ($arr as $k => $v) {
if (is_int($k)) {
$result[] = $v; // 數字鍵重新索引
} else {
$result[$k] = $v; // 字符串鍵覆蓋
}
}
}
return $result;
}
// 遞歸版本(深度合併,後者覆蓋前者)
function deep_merge(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] = deep_merge($result[$k], $v);
} else {
$result[$k] = $v;
}
}
}
return $result;
}
array_merge或[...$a, ...$b](PHP 7.4+)。array_replace或deep_merge(需遞歸)。$config + $defaults。array_merge_recursive(罕用)。safe_merge。理解各函數語義差異,避免「以為合併了實際覆蓋」或「以為覆蓋了實際合併」的隱性Bug。