PHP合并数组需据场景选函数:array_merge()重排数字键并覆盖关联键;+运算符保留左侧键不重排;array_replace()顶层替换,array_replace_recursive()递归合并。

PHP 合并数组最常用的是 array_merge(),但它不是万能的;用错函数或忽略键类型,会导致数据被覆盖、顺序错乱、甚至丢失值。
array_merge() 会重置数字键,关联键冲突时后覆盖前
这是最常踩的坑:只要数组里有 int 键(哪怕没显式写),array_merge() 就会把所有数字键重新编号,从 0 开始连续递增。
$a = [10, 20]; $b = ['x' => 'foo', 30, 'y' => 'bar']; $result = array_merge($a, $b); // 结果:[0=>10, 1=>20, 2=>'foo', 3=>30, 'y'=>'bar'] // 注意:'x' 键没了,30 被重编号为 3,原数字键 0/1 已消失
- 只适合「纯索引数组」拼接,或你明确需要重排数字键
- 遇到
string键冲突(如两个数组都有'id'),后者值直接覆盖前者 - 空数组传入不影响结果,但
null或非数组会报Warning: array_merge(): Expected parameter X to be an array
+ 运算符保留键名,不重排也不覆盖(仅左侧优先)
它不是“加法”,而是「左侧数组 + 右侧数组」的键合并操作:相同字符串键,左侧值保留;相同数字键,右侧值被忽略(不是覆盖,是跳过)。
$a = ['id' => 1, 'name' => 'Alice', 0 => 'first']; $b = ['id' => 999, 'age' => 30, 0 => 'second', 1 => 'third']; $result = $a + $b; // 结果:['id'=>1, 'name'=>'Alice', 0=>'first', 'age'=>30, 1=>'third']
-
+不修改原数组,返回新数组 - 数字键不会被重编号,但重复数字键(如都含
0)右侧直接丢弃 - 不能用于多于两个数组——
$a + $b + $c是合法语法,但等价于($a + $b) + $c,仍只保左
array_replace() 和 array_replace_recursive() 处理嵌套更可控
当数组含多层结构(比如配置项、API 响应),array_replace() 比 array_merge() 更安全:它只替换顶层键,不重排数字键;而 array_replace_recursive() 会逐层递归合并。
立即学习“PHP免费学习笔记(深入)”;
$base = ['host' => 'localhost', 'port' => 3306, 'options' => ['timeout' => 5]]; $override = ['port' => 5432, 'options' => ['charset' => 'utf8']]; $result = array_replace($base, $override); // 结果:['host'=>'localhost', 'port'=>5432, 'options'=>['charset'=>'utf8']] // 注意:'options' 被整个替换了,原 'timeout' 消失
$result2 = array_replace_recursive($base, $override); // 结果:['host'=>'localhost', 'port'=>5432, 'options'=>['timeout'=>5, 'charset'=>'utf8']] // 'options' 数组被递归合并,不是替换
-
array_replace()对数字键行为同+:重复键时右侧覆盖左侧 -
array_replace_recursive()遇到两个都是数组才递归,否则直接覆盖(哪怕一个是string,一个是array) - 两者都要求参数必须是数组,传
null或string会警告
合并多个数组时,别硬套单函数,先想清楚键要不要保留
没有“最优函数”,只有“最适合场景”的选择。比如合并用户提交的表单数据(含 $_POST 和默认配置),通常用 array_replace_recursive();但合并日志条目列表(每个是索引数组),array_merge(...$logs) 更自然。
- 用
...展开运算符配合array_merge()支持动态多数组:array_merge(...$arrays) - 若需保留所有键且避免覆盖,考虑手动循环 +
isset()判断,或用array_merge_recursive()(注意它会把同名值转成数组,可能造成['name' => ['old', 'new']]) - PHP 8.1+ 新增
array_merge_first(),类似array_replace()但语义更清晰——目前使用率低,兼容性差,暂不建议生产环境强依赖
真正容易被忽略的,是混合键类型数组的隐式行为:一个 [0=>'a', 'k'=>'v'] 和另一个 [0=>'b', 'k'=>'w'] 合并时,array_merge() 会重排 0 键,+ 会丢掉第二个 0,array_replace() 会覆盖 0 —— 看似一样,结果全不同。











