PHP数组合并函数使用详解

PHP数组合并看似简单，实则暗藏关键细节：`array_merge()`在关联数组中同名键会后值覆盖前值、数字索引必然重排，且严格要求所有参数为数组，否则触发警告；而`+`运算符则左优先覆盖、不重排索引、容忍非数组（静默跳过），性能还高出3–5倍；真正决定用哪个的不是语法习惯，而是你明确需要“覆盖”还是“收集”——配置合并常选`+`，数据聚合必用`array_merge()`，但无论哪种，都需前置`is_array()`校验以避免线上报错，否则一个未过滤的`null`就可能让整个合并逻辑悄然失效。

array_merge() 合并关联数组时键名冲突会覆盖

用 array_merge() 合并两个都有 'name' 键的关联数组，后一个数组的值会直接覆盖前一个——这不是 bug，是设计行为。比如 array_merge(['name' => 'A'], ['name' => 'B']) 结果是 ['name' => 'B']。

如果想保留所有同名键（比如合并配置项时不想丢数据），得换思路：

• 用 + 运算符：['name' => 'A'] + ['name' => 'B'] 结果是 ['name' => 'A']（左边优先）
• 手动遍历合并，对重复键做逻辑处理（如转为数组、拼接字符串）
• PHP 8.1+ 可考虑 array_merge_recursive()，但注意它会对**所有**同名键递归合并，可能把字符串也变成数组

array_merge() 处理数字索引会重排，不是简单拼接

合并带数字键的数组时，array_merge() 不保留原始下标，而是重新从 0 开始编号。比如 array_merge([0 => 'a', 2 => 'c'], [0 => 'x']) 结果是 [0 => 'a', 1 => 'c', 2 => 'x']，原键 2 消失了。

如果你需要保持索引连续性或不重排，考虑：

• 用 array_replace()：只替换存在键，不重排数字索引（但也不新增）
• 用 ...$arr 解构（PHP 7.4+）：[...$a, ...$b] 更接近“拼接”语义，保留数字键顺序（但同样会重排，只是行为更可预测）
• 明确需求：真要“拼接”，就别依赖键名，用 array_values() 先归一化再 array_merge()

空数组或非数组参数传给 array_merge() 会报 Warning

array_merge() 要求所有参数都必须是数组，传 null、false、字符串甚至未定义变量，都会触发 Warning: array_merge(): Expected parameter X to be an array。

常见踩坑场景：从 API 或表单取值，没做类型校验就直接合并。

• 加 is_array() 判断：array_merge(is_array($a) ? $a : [], is_array($b) ? $b : [])
• PHP 7.4+ 可用空合并 + 类型断言：array_merge($a ?? [], $b ?? [])，但注意 $a 是 false 时仍会报错，所以还是得 is_array()
• 封装成安全函数，避免重复写判断

性能差异：大数组合并时 array_merge() 比 + 慢不少

当合并两个各含 10 万元素的数组时，array_merge() 平均耗时约是 + 运算符的 3–5 倍。因为 array_merge() 内部要做键类型检测、重索引、内存分配；而 + 是浅层合并，遇到重复键直接跳过。

适用选择看需求：

• 要覆盖逻辑（后覆盖前）、且确定都是数组 → 用 +，快且简洁
• 要合并所有值（包括重复键的后值）、需重索引 → 必须用 array_merge()
• 不确定输入类型又怕警告 → 先 is_array() 再选操作，别图省事硬套

实际项目里，很多人卡在“为什么合并后少了几个元素”，最后发现是混进了 null 或用了 + 却期望后值生效——关键不在函数多强大，而在你清楚自己要的是“覆盖”还是“收集”。

以上就是《PHP数组合并函数使用详解》的详细内容，更多关于的资料请关注golang学习网公众号！