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 页面介绍了如何从多行数据和嵌套数组中去除重复项。