array_merge合并数值索引数组时自动重排键名,关联数组中后出现的同名字符串键覆盖前面的值,非数组参数会触发警告并返回null,混合键名时数字键重排、字符串键覆盖。

array_merge 是 PHP 中处理数组合并最常用的函数之一,面试中常被用来考察候选人对数组键名处理、类型安全、边界情况的理解。它看似简单,但细节决定成败。
数值索引数组:自动重排键名
当合并的数组都是纯数值索引(即索引为 0,1,2… 的连续整数)时,array_merge 会丢弃原有数字键,重新从 0 开始顺序编号。
- 例如:array_merge([1,2], [3,4]) 返回 [0=>1, 1=>2, 2=>3, 3=>4]
- 注意:[1,2] + [3,4] 是不同操作——+ 保留左边键名,结果是 [0=>1, 1=>2],右边被忽略
- 若原数组含“空洞”(如 [0=>'a', 2=>'c']),array_merge 仍会重排,变成 [0=>'a', 1=>'c']
关联数组:后出现的同名键覆盖前面的
遇到字符串键(即关联数组)时,array_merge 按参数顺序依次处理,后面数组中相同字符串键会直接覆盖前面的值。
- 例如:array_merge(['a'=>1, 'b'=>2], ['b'=>3, 'c'=>4]) 返回 ['a'=>1, 'b'=>3, 'c'=>4]
- 如果想保留所有值(不覆盖),需手动用 array_replace_recursive 或自定义逻辑
- 混合使用数字键和字符串键时,数字键仍重排,字符串键按覆盖规则处理
非数组参数:触发警告并返回 null
array_merge 要求所有参数都必须是数组。传入字符串、null、对象等非数组类型,PHP 会抛出 Warning: array_merge(): Expected parameter X to be an array,并返回 null(PHP 7.4+)或 false(旧版本)。
立即学习“PHP免费学习笔记(深入)”;
- 安全写法:合并前用 is_array() 校验,或用 array_merge(...array_filter($arrays, 'is_array'))
- 常见坑:从 API 或配置读取的数据可能为 null,直接传入会导致静默失败
- PHP 8.0+ 支持 array_merge(...$arrays) 解包,但解包前仍需确保每个元素是数组
替代方案与实际建议
根据场景选择更合适的工具,比死记 array_merge 行为更重要:
- 要拼接数值数组且保持顺序 → 用 array_merge 没问题
- 要合并配置项,希望深层递归合并 → 改用 array_replace_recursive
- 只想要右侧数组的键值,左侧仅作默认 → array_merge($defaults, $input) 是经典模式
- 不确定输入是否为数组 → 封装一层健壮函数,例如:safe_merge(...$args) { return array_merge(...array_map(fn($a) => is_array($a) ? $a : [], $args)); }









