PHPのarray_merge()：2つ以上の配列を結合する

array_merge($a, $b)は、$aの要素のあとに$bの要素が続く新しい配列を返します。数値キーは0から振り直され、両方の配列に同じ文字列キーがあるときは後の配列の値が優先されます。配列はいくつでも渡せます。

<?php
$fruits = ['apple', 'pear'];
$veg    = ['carrot', 'leek'];
print_r(array_merge($fruits, $veg));

$defaults = ['color' => 'blue', 'size' => 'M'];
$chosen   = ['size' => 'L'];
print_r(array_merge($defaults, $chosen));   // later value wins

array_merge()は引数を変更しません。結合した配列を返すので、結果を代入します：$all = array_merge($all, $more);。

数値キーは振り直される

array_merge()は整数キーを名前ではなく位置として扱います。整数キーを持つ要素はすべて追加され、配列が同じ番号や欠番を使っていても、0からの新しいキーが振られます。リストならそれが望みどおりですが、番号がIDのときは驚くことになります。

<?php
$a = [5 => 'Ada', 9 => 'Linus'];
$b = [5 => 'Grace'];

print_r(array_merge($a, $b));   // keys 0, 1, 2: the IDs are gone

$usersById = [101 => 'Ada', 102 => 'Linus'];
$more      = [103 => 'Grace'];
print_r($usersById + $more);    // + keeps the integer keys

整数に見える文字列キー（'101'）は整数として保存されるので、これも振り直されます。'id101'のようなキーはそのままです。

array_mergeと+演算子の違い

+演算子（配列の和）も配列を結合しますが、ルールが逆です。左の配列にすでにあるキーでは左の値が優先され、右の値は捨てられます。番号の振り直しはしません。そのため、既定値を埋めるには+が、上書きするにはarray_merge()が自然な方法です。

<?php
$defaults = ['theme' => 'light', 'lang' => 'en', 'per_page' => 20];
$user     = ['theme' => 'dark'];

print_r(array_merge($defaults, $user));   // user overrides defaults
print_r($user + $defaults);               // same result: user is on the left

// With lists, + compares positions and drops duplicates by key
print_r(['a', 'b'] + ['x', 'y', 'z']);

ブロックの最後の例は+の定番の罠です。キー0と1がすでに左にあるので、['a', 'b'] + ['x', 'y', 'z']はa, b, zになります。

スプレッド構文：[...$a, ...$b]

スプレッド演算子は、配列リテラルの中で配列を展開します。array_merge()と同じように動き、整数キーは振り直され、PHP 8.1以降は文字列キーも使えて後のものが優先されます。配列と単独の値を混ぜるときに読みやすくなります。

<?php
$first  = [1, 2];
$second = [3, 4];

print_r([...$first, ...$second, 5]);

$base  = ['host' => 'localhost', 'port' => 3306];
$local = ['port' => 3307];
print_r([...$base, ...$local]);

既存の配列にその場で配列を追加する方法は、スプレッド演算子を使ったarray_push()を参照してください。

配列の配列を結合する

結合したい配列自体がリストに入っているときは、そのリストをarray_merge()に展開します。これはループの中で結合する速い方法でもあります。部品を集めてから、一度だけ結合します。

<?php
$pages = [
    ['ada', 'linus'],
    ['grace'],
    ['margaret', 'alan'],
];

$all = array_merge(...$pages);
print_r($all);

$batches = [];
for ($page = 1; $page <= 3; $page++) {
    $batches[] = range($page * 10, $page * 10 + 2);   // pretend API page
}
echo implode(', ', array_merge(...$batches)), "\n";

var_dump(array_merge(...[]));   // an empty list gives []

ループの中で$all = array_merge($all, $batch);と書いても動きますが、毎回大きくなっていく配列全体をコピーするので、数千件になると遅くなります。

array_merge_recursiveとarray_replace

array_merge_recursive()はネストした配列も結合しますが、単純な値を持つ重複した文字列キーでは上書きせず、両方の値を新しい配列にまとめます。設定ではそれが望みであることはまれです。そこでは、すべての階層で値を上書きしキーを保つarray_replace_recursive()が、たいてい正しい道具です。

<?php
$defaults = ['db' => ['host' => 'localhost', 'port' => 3306], 'debug' => false];
$override = ['db' => ['port' => 3307], 'debug' => true];

echo json_encode(array_merge($defaults, $override)), "\n";
echo json_encode(array_merge_recursive($defaults, $override)), "\n";
echo json_encode(array_replace_recursive($defaults, $override)), "\n";

print_r(array_replace([5 => 'a', 9 => 'b'], [9 => 'B']));   // keeps integer keys

3行のJSONを上から読んでください。array_merge()はdbの配列全体を置き換えてhostを失い、array_merge_recursive()はportとdebugを2要素のリストにし、array_replace_recursive()は意図したとおりの設定を作りました。

よくあるミス：結合しても何も取り除かれない

array_merge()は、別々のキーの下にある重複した値をそのまま残します。2つのタグのリストを結合すると、共通のタグが2回ずつ入ります。結果をarray_unique()に通し、そのあとarray_values()で番号を振り直しましょう。

<?php
$postTags  = ['php', 'arrays', 'beginner'];
$extraTags = ['arrays', 'tutorial', 'php'];

$merged = array_merge($postTags, $extraTags);
echo implode(', ', $merged), "\n";

$unique = array_values(array_unique($merged));
echo implode(', ', $unique), "\n";

行やネストした配列から重複を取り除く方法は、array_uniqueのページで扱っています。