PHP array_merge(): объединение двух и более массивов

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']);

Последний пример в блоке это классическая ловушка +: ['a', 'b'] + ['x', 'y', 'z'] даёт a, b, z, потому что ключи 0 и 1 уже есть слева.

Распаковка: [...$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

Прочитайте три строки JSON сверху вниз: array_merge() заменила весь массив db и потеряла host, array_merge_recursive() превратила port и debug в списки из двух элементов, а array_replace_recursive() дала ту конфигурацию, которую вы имели в виду.

Частая ошибка: слияние ничего не удаляет

array_merge() сохраняет повторяющиеся значения, которые лежат под разными ключами. Объединив два списка тегов, вы получите каждый общий тег дважды. Пропустите результат через 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.