| 方式 | 適用維度 | 數值鍵衝突 | 字串鍵衝突 | 索引重排 | 回傳值 |
|---|---|---|---|---|---|
$a + $b | 一維 | 保留第一個 (左側優先) | 保留第一個 (左側優先) | 否 (保留原鍵) | 新陣列 |
array_merge() | 一維 | 重新索引 (0 開始) | 後者覆蓋前者 | 是 (數值鍵重新索引) | 新陣列 |
array_merge_recursive() | 多維 | 遞歸合併為陣列 | 遞歸合併為陣列 | 部分重排 | 新陣列 |
<?php
// 數值鍵:左側優先,不重新索引
$a = [0 => 'a'];
$b = [0 => 'u', 1 => 'v'];
var_dump($a + $b);
// [0 => 'a', 1 => 'v'] (b[0] 被忽略,b[1] 保留原鍵 1)
// 字串鍵:左側優先
$a = ['x' => 'A'];
$b = ['x' => 'B', 'y' => 'C'];
var_dump($a + $b);
// ['x' => 'A', 'y' => 'C']
// 混合鍵
$a = [1 => 'a', 'k' => 'val'];
$b = [1 => 'b', 'k' => 'new', 2 => 'c'];
var_dump($a + $b);
// [1 => 'a', 'k' => 'val', 2 => 'c']
?>
<?php
// 數值鍵:重新索引 0,1,2...
$a = [0 => 'a', 1 => 'b'];
$b = [0 => 'u', 1 => 'v'];
var_dump(array_merge($a, $b));
// [0 => 'a', 1 => 'b', 2 => 'u', 3 => 'v']
// 字串鍵:後者覆蓋
$a = ['x' => 'A'];
$b = ['x' => 'B', 'y' => 'C'];
var_dump(array_merge($a, $b));
// ['x' => 'B', 'y' => 'C']
// 單一數值索引陣列:重新索引
$single = [5 => 'a', 8 => 'b'];
var_dump(array_merge($single));
// [0 => 'a', 1 => 'b']
?>
<?php
$a = ['color' => 'red', 0 => 'a'];
$b = ['color' => 'blue', 1 => 'b', 'size' => 'M'];
var_dump(array_merge_recursive($a, $b));
/*
array(4) {
'color' => array(2) { [0]=>'red', [1]=>'blue' } // 衝突鍵變陣列
0 => 'a'
1 => 'b'
'size' => 'M'
}
*/
// 多維陣列遞歸合併
$config1 = ['db' => ['host' => 'localhost', 'port' => 3306]];
$config2 = ['db' => ['user' => 'root', 'pass' => 'secret'], 'cache' => true];
var_dump(array_merge_recursive($config1, $config2));
/*
array(2) {
'db' => array(4) { 'host','port','user','pass' } // 遞歸合併子陣列
'cache' => true
}
*/
?>
$a + $b (如配置檔覆蓋、路由表合併)。array_merge() (最常用,如分頁資料合併、多來源列表合併)。array_merge_recursive() (如配置檔層層覆蓋、表單資料合併)。+ 運算子最快 (語言構造),但功能最少。array_merge() 為 C 實作,效能優異。array_merge_recursive() 遞歸處理,大型深層陣列較慢。array_splice()、foreach 參考賦值或分批處理。<?php
// 陷阱 1:array_merge 若參數非陣列會報警告 (PHP 7.4+ 棄用,8.0+ TypeError)
array_merge([1,2], null); // Warning/Error
// 陷阱 2:+ 運算子要求兩側皆為陣列
[1,2] + null; // Fatal Error
// 防禦寫法
$result = array_merge((array)$a, (array)$b);
$result = (array)$a + (array)$b;
?>
PHP 陣列合併三大工具各有定位:+ 為「保留鍵名的聯集」、array_merge() 為「重新索引的疊加」、array_merge_recursive() 為「遞歸深度合併」。根據鍵名類型、衝突策略、維度需求選擇正確工具,是資料處理的基本功。