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 페이지에서 다룹니다.