PHP array_merge() 進階用法與陷阱避坑：類型轉換、鍵名重組、性能優化全解析

基礎行為回顧

<?php
$arr1 = ['a' => 'A', 'b' => 'B'];
$arr2 = ['c' => 'C', 'd' => 'D'];
print_r(array_merge($arr1, $arr2));
// Array ( [a] => A [b] => B [c] => C [d] => D )

核心陷阱：非陣列參數觸發警告

<?php
$arr1 = 'not an array';
$arr2 = ['b' => 'B'];

// ❌ 警告: array_merge(): Argument #1 is not an array
$result = array_merge($arr1, $arr2);

解決方案對比

方案一：強制類型轉換 (array)（推薦簡潔場景）

<?php
$arr1 = 'scalar';
$arr2 = ['b' => 'B'];

$result = array_merge((array)$arr1, (array)$arr2);
print_r($result);
// Array ( [0] => scalar [b] => B )
// 注意：標量值被重新索引為 0

方案二：is_array() 守衛（推薦嚴謹場景）

<?php
function safeMerge(...$arrays): array
{
    $result = [];
    foreach ($arrays as $arr) {
        if (is_array($arr)) {
            $result = array_merge($result, $arr);
        } // 非陣列靜默忽略或拋異常
    }
    return $result;
}

print_r(safeMerge('scalar', ['b' => 'B'], null, ['c' => 'C']));
// Array ( [b] => B [c] => C )

方案三：array_merge_recursive() 差異對比

<?php
$arr1 = ['colors' => ['red']];
$arr2 = ['colors' => ['blue']];

// array_merge: 後者覆蓋前者
print_r(array_merge($arr1, $arr2));
// Array ( [colors] => Array ( [0] => blue ) )

// array_merge_recursive: 同鍵合併為陣列
print_r(array_merge_recursive($arr1, $arr2));
// Array ( [colors] => Array ( [0] => red [1] => blue ) )

鍵名重組規則詳解

保留數值鍵的替代方案：+ 運算符

<?php
$arr1 = [0 => 'a', 1 => 'b'];
$arr2 = [2 => 'c', 3 => 'd'];

// + 運算符：鍵不衝突時保留原鍵，衝突時左邊優先
$result = $arr1 + $arr2; // [0=>'a', 1=>'b', 2=>'c', 3=>'d']

// 注意：鍵衝突時不覆蓋
$arr1 = [0 => 'a'];
$arr2 = [0 => 'b'];
$result = $arr1 + $arr2; // [0=>'a'] （保留左邊）

性能對比（100 萬次循環基準）

實戰最佳實踐

1. 配置合併（深度合併）

<?php
function deepMerge(array $base, array $override): array
{
    foreach ($override as $key => $value) {
        if (is_array($value) && isset($base[$key]) && is_array($base[$key])) {
            $base[$key] = deepMerge($base[$key], $value);
        } else {
            $base[$key] = $value;
        }
    }
    return $base;
}

$default = ['db' => ['host' => 'localhost', 'port' => 3306], 'debug' => false];
$custom  = ['db' => ['host' => '192.168.1.100'], 'debug' => true];
$config  = deepMerge($default, $custom);
// ['db' => ['host' => '192.168.1.100', 'port' => 3306], 'debug' => true]

2. 多源數據聚合（API 響應組裝）

<?php
function mergeResponses(iterable $sources): array
{
    $merged = [];
    foreach ($sources as $source) {
        if (is_array($source)) {
            // 字符串鍵覆蓋，數值鍵追加
            foreach ($source as $k => $v) {
                if (is_int($k)) {
                    $merged[] = $v; // 自動索引
                } else {
                    $merged[$k] = $v; // 覆蓋
                }
            }
        }
    }
    return $merged;
}

3. 避免大陣列合併記憶體峰值

<?php
// ❌ 一次性合併大陣列
$huge = array_merge($arr1, $arr2, $arr3, $arr4);

// ✅ 分批處理或生成器
function mergeChunks(Generator $chunks): Generator
{
    foreach ($chunks as $chunk) {
        foreach ($chunk as $item) {
            yield $item;
        }
    }
}

// 使用
foreach (mergeChunks(getDataChunks()) as $item) {
    // 流式處理
}

避坑清單

1. ⚠️ 參數必須是陣列，否則觸發 Warning（PHP 8.0+ 拋 TypeError）。
2. ⚠️ 數值鍵會重組，若依賴原鍵值請用 + 或 array_replace。
3. ⚠️ array_merge_recursive 會將同名字符串鍵值合併為陣列，非覆蓋。
4. ⚠️ null 不是陣列，array_merge([1], null) 會報錯。
5. ⚠️ 合併巨大陣列導致記憶體飆升，考慮流式處理或 + 運算符。

理解 array_merge 的鍵名重組語義與類型要求，配合 +、array_replace、深度合併等工具，能精準控制陣列合併行為，避免生產環境數據異常。