应使用 array_merge() 而非 + 合并数组:前者重索引数字键、右侧覆盖字符串键,后者左优先且丢失重复数字键;需校验参数为数组,深层合并用 array_replace_recursive(),注意内存与类型安全。

用 array_merge() 而不是 + 合并数组
PHP 中数组合并最常踩的坑是误用 + 运算符。它不会递归合并,也不会重置数字键,而是简单“左优先覆盖”:右边数组的键若已存在左边,直接跳过。array_merge() 才是语义正确的合并函数——它会重索引数字键、保留字符串键,并对同名字符串键做右侧覆盖。
常见错误现象:[0 => 'a'] + [0 => 'b', 1 => 'c'] 结果是 [0 => 'a', 1 => 'c'],丢失了 'b';而 array_merge([0 => 'a'], [0 => 'b', 1 => 'c']) 得到 [0 => 'a', 1 => 'b', 2 => 'c']。
- 数字键必须用
array_merge(),否则键会断裂或丢失 - 字符串键合并时,
+和array_merge()行为不同:前者左侧优先,后者右侧优先 - 如果要保留左侧字符串键值,得手动处理,不能依赖运算符
合并前校验参数类型,避免 array_merge() 报 Warning
array_merge() 要求所有参数都是数组,传入 null、string 或 int 会触发 Warning: array_merge(): Expected parameter X to be an array。线上环境可能因此暴露错误或中断流程。
典型场景:从配置文件读取可选数组字段(如 $config['features']),该字段可能未定义或设为 false;或调用 API 返回结果不确定是否为数组。
- 用
is_array()显式判断,把非数组转为空数组:array_merge($a, is_array($b) ? $b : []) - PHP 7.4+ 可用空合并 + 类型断言:
array_merge($a, $b ?? []),但注意$b是false时仍不安全,需配合is_array() - 不要依赖
@array_merge()抑制警告——掩盖问题,且性能略差
深层嵌套数组合并要用 array_replace_recursive()
当需要合并多维配置(如数据库连接参数、前端组件 props)时,array_merge() 只做第一层合并,子数组会被整个替换掉。例如:array_merge(['db' => ['host' => 'a']], ['db' => ['port' => 3306]]) 结果是 ['db' => ['port' => 3306]],丢掉了 'host'。
array_replace_recursive() 才真正递归合并:同层级字符串键逐个替换,数字键仍按顺序追加,子数组继续向下合并。
- 它不重索引数字键(这点和
array_merge()不同),适合保持结构的配置合并 - 无法控制“合并策略”(比如某字段要合并而非覆盖),此时需手写递归逻辑或引入工具类
- 注意循环引用会导致无限递归——生产环境务必确保输入无引用环
合并大量数组时注意内存与性能边界
PHP 数组是写时复制(Copy-on-Write),但 array_merge() 每次都会创建新数组并拷贝全部元素。合并 10 个各含 1 万项的数组,中间可能产生数倍临时内存占用,GC 压力明显。
使用场景:日志聚合、批量导入映射、动态构建查询条件等。
- 能预知结构时,优先用单次循环拼接:
foreach ($arrays as $arr) { foreach ($arr as $k => $v) { $result[$k] = $v; } } - 若必须用
array_merge(),避免链式调用:array_merge(array_merge($a, $b), $c)比array_merge($a, $b, $c)多一次中间数组分配 - PHP 8.0+ 支持展开运算符:
array_merge(...$arrayList)更简洁,但同样有内存开销,且$arrayList为空时会报array_merge() expects at least 1 argument
json_decode() 忘加第二个参数 true,结果传给 array_merge() 的是个 stdClass 对象——这时连 warning 都不会触发,而是静默变成空数组。php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











