PHP Conference Japan 2024

    array_merge

    (PHP 4, PHP 5, PHP 7, PHP 8)

    array_merge — 合併一個或多個陣列

    說明

    array_merge(陣列 ...$arrays): 陣列

    合併一個或多個陣列的元素，將後一個陣列的值附加到前一個陣列的末尾。它會返回結果陣列。

    如果輸入的陣列具有相同的字串鍵，則後面的值會覆蓋前面的值。但是，如果陣列包含數字鍵，則後面的值**不會**覆蓋原始值，而是會被附加。

    輸入陣列中具有數字鍵的值，在結果陣列中將會重新編號，從零開始遞增。

    參數

    arrays

    要合併的陣列的可變列表。

    返回值

    返回結果陣列。如果沒有任何參數，則返回一個空的 陣列。

    更新日誌

    版本 說明
    7.4.0 此函式現在可以在沒有任何參數的情況下被呼叫。以前，至少需要一個參數。

    範例

    範例 #1 array_merge() 範例

    <?php
    $array1     = array("color" => "red", 2, 4);
    $array2 = array("a", "b", "color" => "green", "shape" => "trapezoid", 4);
    $result = array_merge($array1, $array2);
    print_r($result);
    ?>

    上述範例將輸出：

    Array
(
    [color] => green
    [0] => 2
    [1] => 4
    [2] => a
    [3] => b
    [shape] => trapezoid
    [4] => 4
)

    範例 #2 簡單的 array_merge() 範例

    <?php
    $array1     = array();
    $array2 = array(1 => "data");
    $result = array_merge($array1, $array2);
    ?>

    別忘了數字鍵會被重新編號！

    Array
(
    [0] => data
)

    如果您想將第二個陣列的元素附加到第一個陣列，但不覆蓋第一個陣列的元素，也不重新索引，請使用 + 陣列聯集運算子。

    <?php
    $array1     = array(0 => 'zero_a', 2 => 'two_a', 3 => 'three_a');
    $array2 = array(1 => 'one_b', 3 => 'three_b', 4 => 'four_b');
    $result = $array1 + $array2;
    var_dump($result);
    ?>

    第一個陣列的鍵值將會被保留。如果兩個陣列都存在相同的鍵值，則會使用第一個陣列的元素，而第二個陣列中相同鍵值的元素將會被忽略。

    array(5) {
  [0]=>
  string(6) "zero_a"
  [2]=>
  string(5) "two_a"
  [3]=>
  string(7) "three_a"
  [1]=>
  string(5) "one_b"
  [4]=>
  string(6) "four_b"
}

    範例 #3 使用非陣列型別的 array_merge()

    <?php
    $beginning     = 'foo';
    $end = array(1 => 'bar');
    $result = array_merge((array) $beginning, (array) $end);
    print_r($result);
    ?>

    上述範例將輸出：

    Array
    (
        [0] => foo
        [1] => bar
    )

    參見

    發現問題了嗎？

    學習如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增註釋

    使用者貢獻的註釋 4 則註釋

    311
    Julian Egelstaff
    15 年前
    在某些情況下，聯集運算子 ( + ) 可能比 array_merge 更實用。 array_merge 函式不會保留數字鍵值。如果您需要保留數字鍵，那麼使用 + 可以做到這一點。

    例如

    <?php

    $array1    [0] = "zero";
    $array1[1] = "one";

    $array2[1] = "one";
    $array2[2] = "two";
    $array2[3] = "three";

    $array3 = $array1 + $array2;

    // 執行結果如下：

    $array3 = array(0=>"zero", 1=>"one", 2=>"two", 3=>"three");

    ?>

    請注意，這裡隱含地應用了類似 `array_unique` 的效果。在某些情況下，如果你的數字鍵值很重要，這種行為可能很有用，而且比 `array_merge` 更好。

    --Julian
    53
    ChrisM
    2 年前
    我想指出的是，雖然其他評論指出展開運算符應該比 `array_merge` 更快，但我實際上發現對於一般陣列來說情況恰恰相反。在 PHP 7.4 和 PHP 8.0 中都是如此。對於大多數應用程式來說，差異應該可以忽略不計，但我還是想指出這一點，以確保準確性。

    以下是測試用的程式碼以及結果

    <?php
    $before     = microtime(true);

    for (    $i=0 ; $i<10000000 ; $i++) {
    $array1 = ['apple','orange','banana'];
    $array2 = ['carrot','lettuce','broccoli'];

    $array1 = [...$array1,...$array2];
    }

    $after = microtime(true);
    echo (    $after-$before) . " sec for spread\n";

    $before = microtime(true);

    for (    $i=0 ; $i<10000000 ; $i++) {
    $array1 = ['apple','orange','banana'];
    $array2 = ['carrot','lettuce','broccoli'];

    $array1 = array_merge($array1,$array2);
    }

    $after = microtime(true);
    echo (    $after-$before) . " sec for array_merge\n";
    ?>

    PHP 7.4
    1.2135608196259 秒，使用展開運算符
    1.1402177810669 秒，使用 array_merge

    PHP 8.0
    1.1952061653137 秒，使用展開運算符
    1.099925994873 秒，使用 array_merge
    15
    Andreas Hofmann
    3 年前
    除了 Julian Egelstaffs 的評論中提到的使用 + 運算符保留鍵值之外，還補充說明如下：
    當他們說「具有數字鍵值的輸入陣列將被重新編號」時，他們是認真的。如果您認為自己很聰明，將編號鍵值放入字串中，這將無濟於事。包含整數的字串也將被重新編號！我在合併兩個以書籍 ISBN 作為鍵值的陣列時就掉入了這個陷阱。讓我們來看這個例子

    <?php
    $test1    ['24'] = 'Mary';
    $test1['17'] = 'John';

    $test2['67'] = 'Phil';
    $test2['33'] = 'Brandon';

    $result1 = array_merge($test1, $test2);
    var_dump($result1);

    $result2 = [...$test1, ...$test2]; // fsb 提到的
    var_dump($result2);
    ?>

    你會得到兩個

    陣列(4) {
    [0]=>
    字串(4) "Mary"
    [1]=>
    字串(4) "John"
    [2]=>
    字串(4) "Phil"
    [3]=>
    字串(7) "Brandon"
    }

    使用 + 運算子或 array_replace，這樣會在某種程度上保留鍵值

    <?php
    $result1     = array_replace($test1, $test2);
    var_dump($result1);

    $result2 = $test1 + $test2;
    var_dump($result2);
    ?>

    你會得到兩個

    陣列(4) {
    [24]=>
    字串(4) "Mary"
    [17]=>
    字串(4) "John"
    [67]=>
    字串(4) "Phil"
    [33]=>
    字串(7) "Brandon"
    }

    鍵值會保持不變，順序也會保持不變，但有一點需要注意：鍵值會被轉換為整數。
    1
    fsb at thefsb dot org
    4 年前
    從 PHP 7.4 開始，我們不再需要 array_merge()。

    [...$a, ...$b]

    與

    array_merge($a, $b)

    作用相同，而且速度可能更快。

    https://wiki.php.net/rfc/spread_operator_for_array#advantages_over_array_merge
    ＋新增註釋
    To Top