登录
首页 >  文章 >  php教程

PHP数组合并技巧:array_merge用法详解

时间:2026-05-13 19:48:36 275浏览 收藏

PHP 的 array_merge 函数看似简单,实则暗藏玄机:它对数字索引数组会强制重排键名,对字符串键关联数组则保留原键并后者覆盖前者,混合使用时行为更易引发数据错乱;若需保留原始数字键,应改用 + 运算符;传入非数组参数会触发警告,需主动类型校验;频繁调用还可能导致性能骤降,推荐用展开语法或批量合并替代循环合并——理解这些细节,才能避免线上事故、写出健壮高效的 PHP 数组操作代码。

PHP数组怎么合并两个数组_数组合并array_merge用法【指南】

array_merge 合并后键名被重排?用对场景才不会丢数据

PHP 的 array_merge 对索引数组(数字键)和关联数组(字符串键)行为完全不同:索引键会被重新编号,而字符串键会保留原值、冲突时后者覆盖前者。这不是 bug,是设计如此——但很多人没意识到自己传的是索引数组,结果发现 key 全变了。

  • 如果你合并的是 ['a', 'b']['c', 'd'],结果是 [0 => 'a', 1 => 'b', 2 => 'c', 3 => 'd'],不是 [0 => 'a', 1 => 'b', 0 => 'c', 1 => 'd']
  • 如果你合并的是 ['id' => 1, 'name' => 'A']['name' => 'B', 'age' => 25],结果是 ['id' => 1, 'name' => 'B', 'age' => 25]
  • 混合使用时更危险:比如 array_merge([1, 2], ['name' => 'x']),结果是 [0 => 1, 1 => 2, 'name' => 'x'] —— 数字键照常重排,字符串键独立存在

想保留数字键不重排?别用 array_merge,改用 + 运算符

当你要“叠加”两个索引数组且不想丢掉原始下标(比如批量收集日志条目、拼接分页结果),array_merge 就不合适。PHP 的数组加法 + 是按键合并,相同数字键不会覆盖,而是跳过后者;它只对「左侧不存在的键」生效。

  • [0 => 'a', 1 => 'b'] + [0 => 'x', 1 => 'y', 2 => 'z'][0 => 'a', 1 => 'b', 2 => 'z']
  • 注意:+ 不递归,也不处理嵌套;遇到同名字符串键,左边值永远胜出
  • 如果必须递归合并(比如配置数组),用 array_replace_recursive,不是 array_merge

空数组或非数组参数传给 array_merge 会警告

array_merge 要求所有参数都是数组。传 nullfalse、字符串或未定义变量,会直接触发 Warning: array_merge(): Expected parameter X to be an array。线上环境可能因此暴露错误,或让后续逻辑中断。

  • 常见写法:array_merge($a ?? [], $b ?? [])is_array($a) ? $a : []
  • 不要依赖 @array_merge(...) 抑制警告——掩盖问题比修复更危险
  • Laravel 等框架的 Arr::merge() 内部做了类型兜底,但原生 PHP 没这层保护

性能敏感场景慎用 array_merge 多次调用

每次 array_merge 都要复制全部元素。循环里反复合并小数组(比如逐条 push 到结果集),时间复杂度会从 O(n) 退化成 O(n²)。尤其在处理几百个以上数组时,差异明显。

  • 替代方案:先用 [] 初始化空数组,再用 [] = $itemarray_push 追加
  • 如果必须合并多个已知数组,把它们放进一个二维数组再 call_user_func_array('array_merge', $list),比循环调用高效
  • PHP 7.4+ 支持展开语法:[...$a, ...$b, ...$c],语义清晰、性能接近原生 C 实现,但只适用于一维

真正容易被忽略的,是键类型混用时的隐式转换:比如 '0'(字符串)和 0(整数)在 array_merge 中被视为不同键,但在 + 中会被当作相同键处理。这种差异在动态构造数组时特别致命,调试起来往往要翻半天文档。

到这里,我们也就讲完了《PHP数组合并技巧:array_merge用法详解》的内容了。个人认为,基础知识的学习和巩固,是为了更好的将其运用到项目中,欢迎关注golang学习网公众号,带你了解更多关于的知识点!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>