异常教程

PHP array_merge_recursive() 函数（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，数组操作是日常编程的核心任务之一。当需要合并两个或多个数组时，array_merge() 函数可能是最常用的工具。然而，当面对嵌套数组或需要保留原始键名时，array_merge() 的局限性会逐渐显现。这时，PHP array_merge_recursive() 函数 就像一把“瑞士军刀”，能够优雅地解决复杂场景下的数组合并问题。本文将通过循序渐进的方式，结合实际案例，帮助读者理解这一函数的原理、使用场景及潜在注意事项。

什么是 array_merge_recursive()？

array_merge_recursive() 是 PHP 内置的数组处理函数，用于将多个数组合并为一个新数组。与基础版的 array_merge() 相比，它最大的特点是支持 递归合并，即能够处理嵌套数组的层级结构，并自动将具有相同键名的元素合并为子数组。

核心特性

  • 递归合并：对嵌套数组逐层处理，保持结构完整性。
  • 键名冲突处理：当两个数组的键名（Key）相同时：
    • 关联键（字符串键名）：直接覆盖或合并为子数组。
    • 数值键（整数键名）：合并为一个扁平的数值键数组。

形象比喻

想象你有两个装满拼图碎片的盒子：

  • array_merge() 会将两个盒子的碎片混合到一个新盒子里，但若两个盒子里有相同图案的碎片，它会直接替换掉旧碎片。
  • array_merge_recursive() 则会将两个盒子的碎片按图案分类，如果图案相同，它会把它们叠在一起，形成一个“拼图叠层”，方便后续整理。

基础用法与代码示例

基础语法

array_merge_recursive(array1, array2, array3, ...);

此函数接收任意数量的数组作为参数，返回合并后的新数组。原始数组不会被修改。

示例 1：合并简单数组

$array1 = ['a' => 1, 'b' => 2];
$array2 = ['b' => 3, 'c' => 4];
$result = array_merge_recursive($array1, $array2);

// 输出结果：
// Array (
//     [a] => 1
//     [b] => Array (
//         [0] => 2
//         [1] => 3
//     )
//     [c] => 4
// )

这里，键名 b 在两个数组中都存在，array_merge_recursive() 将其合并为一个子数组，而非直接覆盖。

与 array_merge() 的对比

核心区别：键名冲突的处理方式

案例对比

// 使用 array_merge()
$merged = array_merge($array1, $array2);
// 输出：
// Array (
//     [a] => 1
//     [b] => 3  // 覆盖为第二个数组的值
//     [c] => 4
// )

// 使用 array_merge_recursive()
$recursive_merged = array_merge_recursive($array1, $array2);
// 输出如上文所示，保留了所有值

可见，array_merge() 会直接覆盖关联键的值，而 array_merge_recursive() 选择将冲突值合并为子数组。

表格总结

函数名数值键冲突处理关联键冲突处理是否递归处理嵌套数组
array_merge()合并为数值键数组后续值覆盖先前值不递归处理
array_merge_recursive()合并为数值键数组合并为子数组（键名保持）递归处理

递归合并的深层机制

嵌套数组的合并逻辑

当数组包含嵌套层级时，array_merge_recursive() 会逐层递归处理。例如：

$arrayA = [
    'user' => [
        'name' => 'Alice',
        'address' => 'Beijing'
    ],
    'score' => 90
];

$arrayB = [
    'user' => [
        'age' => 25
    ],
    'score' => 95
];

$result = array_merge_recursive($arrayA, $arrayB);
// 输出：
// Array (
//     [user] => Array (
//         [name] => Alice
//         [address] => Beijing
//         [age] => 25
//     ),
//     [score] => Array (
//         [0] => 90
//         [1] => 95
//     )
// )
  • user 子数组：合并为包含所有键的单个子数组。
  • score 关联键：因类型相同且键名冲突，合并为子数组。

形象比喻：俄罗斯套娃

递归合并的过程类似于打开层层嵌套的俄罗斯套娃：

  1. 外层数组的每个键被逐一检查；
  2. 若键名相同且为关联键，内部内容被展开合并；
  3. 若遇到嵌套数组，则继续递归处理子数组，直到所有层级都被处理完毕。

实际应用场景与案例

场景 1：合并配置文件

在开发中，常需要合并默认配置与用户自定义配置。例如：

// 默认配置
$default = [
    'theme' => 'light',
    'features' => ['search', 'dark-mode']
];

// 用户配置
$user = [
    'theme' => 'dark',
    'features' => ['dark-mode', 'analytics']
];

$merged = array_merge_recursive($default, $user);
// 输出：
// Array (
//     [theme] => dark
//     [features] => Array (
//         [0] => search
//         [1] => dark-mode
//         [2] => analytics
//     )
// )

通过递归合并，features 数组的值被合并为一个完整的列表，而非覆盖。

场景 2：合并多维数据

处理用户权限系统时：

$permissions1 = [
    'admin' => ['create', 'delete'],
    'user' => ['read']
];

$permissions2 = [
    'admin' => ['edit'],
    'guest' => ['view']
];

$merged = array_merge_recursive($permissions1, $permissions2);
// 输出：
// Array (
//     [admin] => Array (
//         [0] => create
//         [1] => delete
//         [2] => edit
//     ),
//     [user] => Array (
//         [0] => read
//     ),
//     [guest] => Array (
//         [0] => view
//     )
// )

合并后，admin 的权限列表被扩展，而非替换。

注意事项与常见问题

问题 1：数值键的合并逻辑

当两个数组的数值键（如 [0], [1]）冲突时，array_merge_recursive() 会将它们合并为一个新的数值键数组。例如：

$array1 = [1, 2];
$array2 = [3, 4];
$merged = array_merge_recursive($array1, $array2);
// 输出：Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 )

与 array_merge() 的行为一致，但若其中一个数组包含关联键，结果可能出乎意料。

问题 2：混合键名的冲突

若数组同时包含数值键和关联键，递归合并可能导致结构混乱。例如：

$arrayX = ['a', 'b', 'c'];
$arrayY = ['b' => 'value', 'd'];
$merged = array_merge_recursive($arrayX, $arrayY);
// 输出：
// Array (
//     [0] => a
//     [1] => b
//     [2] => c
//     [b] => value
//     [3] => d
// )

此时，array_merge() 的输出会更简洁，而递归合并保留了所有键，需谨慎使用。

解决方案：预处理或后处理

  • 预处理：合并前将数值键转换为关联键（如通过 array_combine）。
  • 后处理：使用 array_map 或自定义函数整理结果。

高级技巧与优化建议

技巧 1：与 array_replace_recursive() 的组合使用

若希望保留第二个数组的值覆盖第一个数组，可结合 array_replace_recursive()：

$array1 = ['a' => 1, 'b' => 2];
$array2 = ['a' => 3, 'c' => 4];
$result = array_replace_recursive($array1, $array2);
// 输出：Array ( [a] => 3 [b] => 2 [c] => 4 )

此函数适用于需要明确优先级的场景。

技巧 2：合并多维数组的特定层级

若需仅合并某一层级的键，可手动提取子数组处理：

$data1 = ['profile' => ['name' => 'Alice']];
$data2 = ['profile' => ['age' => 25]];
$merged_profile = array_merge_recursive($data1['profile'], $data2['profile']);
// 然后将结果重新嵌套到父数组中

结论

PHP array_merge_recursive() 函数是处理复杂数组合并的强大工具，尤其在需要保留嵌套结构或处理键名冲突时。通过递归机制，它能够优雅地将多个数组整合为一个逻辑统一的结构，但同时也需要开发者对键名类型和合并逻辑保持警惕。

掌握这一函数，不仅能够提升代码的简洁性，还能在配置管理、数据聚合等场景中发挥重要作用。建议读者通过实际项目练习，逐步熟悉其行为模式，并结合 array_merge()、array_replace() 等函数，构建灵活的数组操作方案。

希望本文能帮助你在 PHP 开发中更自信地使用 array_merge_recursive()，解决实际问题！

最新发布

查看更多文章