PHP数组合并函数使用方法详解

PHP数组合并看似简单，实则暗藏关键细节：`array_merge()`在关联数组中同名键会后值覆盖前值、数字索引强制重排，且严格要求所有参数为数组，否则触发警告；而`+`运算符则左优先覆盖、不重排索引、性能更高，但无法收集重复键的全部值。真正决定用法的不是函数本身，而是你明确的需求——是“覆盖旧配置”还是“收集所有数据”？是否需处理非数组输入？是否在意索引连续性？避开踩坑的关键，在于理解行为差异、做好类型校验，并根据场景理性选择而非盲目套用。

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学习网公众号，带你了解更多关于的知识点！