萬盛學電腦網

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

PHP 陣列合併大揭密:+ 號 vs array_merge() 深度解析與陷阱避坑

PHP 合併陣列有兩種主要語法:$a + $b (聯集運算子) 與 array_merge($a, $b)。兩者行為迥異,搞混會導致資料遺失、索引重置、效能問題。本文深度解析兩者差異、內部機制、適用場景與進階技巧。

核心差異一覽表

特性$a + $b (聯集運算子)array_merge($a, $b)
數值索引處理保留原鍵值,不重新索引重新索引 (0,1,2...)
字串鍵衝突左側優先,右側同鍵被忽略右側覆蓋,後者勝出
多陣列合併僅支援兩個運算元支援任意多個陣列參數
回傳類型陣列陣列
NULL 處理視為空陣列PHP 7.4+ 拋 TypeError,需確保皆為陣列
效能極快 (內建運算子)稍慢 (函數呼叫、重新索引)

實戰演示:複雜巢狀陣列合併

<?php
$arr1 = [
    10 => 'valueof10',
    11 => 'valueof11',
    'key1' => 'dataofkey1',
    'key2' => 'dataofkey2',
    'array' => [
        'key1' => 1,
        'key2' => 'abc',
        'key3' => [1, 2, 'name' => 'peter'],
    ],
];

$arr2 = [
    10 => 'newvalueof10',
    11 => 'newvalueof11',
    'key1' => 'newdataofkey1',
    'key3' => 'newdataofkey3',
    'array' => [
        'key1' => 2,
        'key2' => 'defg',
        'key3' => [1, 2, 'name' => 'jonathan', 'gender' => 'male'],
    ],
];

// 1. 聯集運算子 +
$union = $arr1 + $arr2;
/*
結果:
- 數值鍵 10, 11:保留 $arr1 的值 (左側優先)
- 字串鍵 key1, key2:保留 $arr1 的值
- key3:$arr1 無此鍵,採用 $arr2 的值
- array:整個子陣列保留 $arr1 (不遞迴合併!)
*/

// 2. array_merge()
$merged = array_merge($arr1, $arr2);
/*
結果:
- 數值鍵 10, 11:重新索引為 0, 1, 2, 3...
- 字串鍵 key1, key2, key3:$arr2 覆蓋 $arr1
- array:$arr2 覆蓋 $arr1 (不遞迴!)
- 最後附加 $arr2 獨有的數值鍵 (重新索引)
*/

輸出結果詳細對比

$arr1 + $arr2 結果 (保留鍵值、左側優先)

Array
(
    [10] => valueof10          // 保留 arr1
    [11] => valueof11          // 保留 arr1
    [key1] => dataofkey1       // 保留 arr1
    [key2] => dataofkey2       // 保留 arr1
    [array] => Array           // 整個子陣列保留 arr1
        (
            [key1] => 1
            [key2] => abc
            [key3] => Array
                (
                    [0] => 1
                    [1] => 2
                    [name] => peter
                )
        )
    [key3] => newdataofkey3    // arr1 無此鍵,取 arr2
)

array_merge($arr1, $arr2) 結果 (重新索引、右側覆蓋)

Array
(
    [0] => valueof10           // 數值鍵重新索引從 0 開始
    [1] => valueof11
    [key1] => newdataofkey1    // 字串鍵:arr2 覆蓋
    [key2] => dataofkey2       // arr2 無 key2,保留 arr1
    [array] => Array           // 整個子陣列被 arr2 覆蓋
        (
            [key1] => 2
            [key2] => defg
            [key3] => Array
                (
                    [0] => 1
                    [1] => 2
                    [name] => jonathan
                    [gender] => male
                )
        )
    [2] => newvalueof10        // arr2 的數值鍵接著索引
    [3] => newvalueof11
    [key3] => newdataofkey3
)

遞迴合併:array_merge_recursive()

<?php
$a = ['a' => 1, 'b' => 2, 'items' => ['x', 'y']];
$b = ['a' => 10, 'c' => 3, 'items' => ['z']];

// array_merge: 完全覆蓋
print_r(array_merge($a, $b));
/*
Array
(
    [a] => 10
    [b] => 2
    [items] => Array ( [0] => z )  // 整個 items 被覆蓋
    [c] => 3
)
*/

// array_merge_recursive: 同鍵遞迴合併成陣列
print_r(array_merge_recursive($a, $b));
/*
Array
(
    [a] => Array ( [0] => 1, [1] => 10 )  // 同鍵值包成陣列
    [b] => 2
    [items] => Array ( [0] => x, [1] => y, [2] => z ) // 數值索引合併
    [c] => 3
)
*/

注意:array_merge_recursive 會將同鍵標量值包成陣列,導致結構改變,使用時需謹慎。

深度合併 (遞迴合併陣列值而非包成陣列)

<?php
function array_merge_deep(array ...$arrays): array {
    $result = [];
    foreach ($arrays as $arr) {
        foreach ($arr as $key => $value) {
            if (isset($result[$key]) && is_array($result[$key]) && is_array($value)) {
                $result[$key] = array_merge_deep($result[$key], $value);
            } else {
                $result[$key] = $value;
            }
        }
    }
    return $result;
}

$config1 = ['db' => ['host' => 'localhost', 'port' => 3306], 'debug' => true];
$config2 = ['db' => ['port' => 3307, 'charset' => 'utf8mb4'], 'cache' => true];

print_r(array_merge_deep($config1, $config2));
/*
Array
(
    [db] => Array
        (
            [host] => localhost
            [port] => 3307        // 被覆蓋
            [charset] => utf8mb4  // 新增
        )
    [debug] => true
    [cache] => true
)
*/

效能基準測試 (PHP 8.2, 10萬次迭代)

<?php
$a = range(1, 100);
$b = range(101, 200);

$start = hrtime(true);
for ($i=0; $i<100000; $i++) $c = $a + $b;
echo "+ 運算子: ", (hrtime(true)-$start)/1e6, " ms\n";

$start = hrtime(true);
for ($i=0; $i<100000; $i++) $c = array_merge($a, $b);
echo "array_merge: ", (hrtime(true)-$start)/1e6, " ms\n";

// 典型結果:
// + 運算子: ~15 ms
// array_merge: ~45 ms (約 3 倍慢,因重新索引)

選擇指南:何時用哪個?

使用 $a + $b 當:
  • 陣列代表「鍵值對應」 (字典/關聯陣列),鍵有業務含義 (如 ID、代碼)。
  • 需要保留原始數值索引 (如資料庫 ID 當鍵)。
  • 想要「預設值 + 覆蓋」模式:$defaults + $userInput (用戶輸入覆蓋預設,但不新增預設無的鍵)。
  • 效能敏感熱路徑。
使用 array_merge() 當:
  • 陣列代表「列表/序列」,索引無業務含義 (如分頁資料、日誌條目)。
  • 需要重新索引 (合併兩個列表)。
  • 合併多個陣列 (array_merge($a, $b, $c, $d))。
  • 字串鍵需「後者勝出」語意 (如配置覆蓋:array_merge($defaultConfig, $envConfig, $localConfig))。
使用 array_merge_recursive() 當:
極少數場景:需收集同鍵所有值 (如合併多來源的標籤陣列)。
使用 array_merge_deep() (自訂) 當:
配置檔案多層覆蓋、巢狀資料結構合併。

現代 PHP 8.1+ 解構運算子替代方案

<?php
// 陣列解構 (PHP 7.4+)
$merged = [...$arr1, ...$arr2]; // 相當於 array_merge(),重新索引

// 關聯陣列解構 (PHP 8.1+)
$merged = ['key' => 'from arr1'] + ['key' => 'from arr2', 'new' => 'value'];
// 等同 $arr1 + $arr2 (左側優先)

// 合併多個關聯陣列且右側優先 (PHP 8.1+)
$merged = $arr1 + $arr2 + $arr3; // 左側優先
// 沒有內建右側優先解構語法,仍需 array_merge()

理解 + 與 array_merge() 的語意差異,是寫出正確、高效 PHP 代碼的關鍵。記住核心口訣:+ 保鍵左優,merge 重索引右勝。根據資料語意選擇正確工具,避免生產環境驚魂時刻!

copyright © 萬盛學電腦網 all rights reserved