PHP数组合并技巧：array_merge递归使用指南

PHP中没有开箱即用的“piso合并”（深度递归+同键覆盖）功能，array_merge_recursive会追加而非覆盖相同键值，array_merge又不支持递归，而array_replace_recursive虽最接近该语义但不修改原数组且缺乏优先级控制；文章深入剖析了三者差异与局限，手把手教你用引用传参实现轻量高效的自定义array_piso_merge函数，并提醒null、对象、深层嵌套及资源类型等关键边界问题，最后给出实用建议：优先尝试array_replace_recursive，仅在定制化需求强烈时才引入手写逻辑——帮你避开踩坑，写出更健壮、可维护的数组合并代码。

PHP 里没有 array_merge_recursive 的“覆盖式递归合并”（即所谓“piso 合并”），array_merge_recursive 是追加而非覆盖，而 array_merge 又不递归——所以直接用内置函数做不到你想要的“深度合并 + 同键覆盖”行为。

为什么 array_merge_recursive 不符合“piso 合并”预期

它遇到相同字符串键时会把值塞进数组，而不是覆盖。比如两个数组都有 'name' => 'a' 和 'name' => 'b'，结果是 'name' => ['a', 'b']，不是 'name' => 'b'。

• 数值键会被重排，无法保留原顺序
• 无法控制“子数组是否继续合并”，纯追加逻辑
• 没有提供回调或策略参数来定制覆盖规则

手动实现“piso 合并”的核心逻辑

所谓 piso（pick-in-sub-object），本质是：遍历目标数组，对每个键，若源数组存在同名键且双方都是数组，则递归合并；否则直接用源数组的值覆盖目标数组的值。

• 必须显式判断 is_array($target[$key]) && is_array($source[$key])
• 不能依赖 array_key_exists 或 isset 混用，空值（null、false）也要被覆盖
• 推荐用引用传参避免重复复制大数组：&$target

简版示例：

function array_piso_merge(&$target, $source) {
    foreach ($source as $key => $value) {
        if (is_array($value) && isset($target[$key]) && is_array($target[$key])) {
            array_piso_merge($target[$key], $value);
        } else {
            $target[$key] = $value;
        }
    }
}

使用 array_replace_recursive 的注意事项

PHP 5.3+ 提供了 array_replace_recursive，它更接近“piso 合并”语义：同键数组递归合并，非数组则直接覆盖。

• 它不修改原数组，而是返回新数组，注意赋值：$result = array_replace_recursive($a, $b);
• 只支持从左到右依次替换，不能指定优先级顺序（如“最后传入的数组最高优先级”需自己控制参数顺序）
• 对空数组、null 键、数字键都按标准规则处理，但不会跳过 0 或 false 这类“falsy”值
• 性能上比手写递归略优，因底层是 C 实现

容易被忽略的边界情况

合并时真正出问题的往往不是主逻辑，而是这些点：

• null 值会被覆盖，但如果你期望“仅非 null 才覆盖”，就得额外加判断
• 对象未转数组就传入，is_array 判定失败，直接覆盖成对象，后续递归中断
• 深层嵌套时递归太深触发 max_execution_time 或 xdebug.max_nesting_level
• 资源类型（如 file handle）、闭包、不可序列化对象无法安全合并，会报 warning 或静默失败

实际项目中，建议先用 array_replace_recursive 尝试，不满足再补手写逻辑——多数“piso 合并”需求，它已经够用。

今天关于《PHP数组合并技巧：array_merge递归使用指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！