PHP递归函数实现递归合并：合并多层数据的代码与方法

在PHP开发中，处理多维数组或嵌套数据结构时，经常需要将多个层级的数据合并到一起。例如合并配置文件、用户权限结构或者树形数据。PHP内置的 array_merge_recursive() 函数可以递归合并数组，但它的合并策略固定为“相同键名生成数组”。实际项目中可能需要自定义合并规则（如覆盖、追加、忽略等）。此时，利用PHP递归函数编写自定义的递归合并方法就成了最灵活的解决方案。

递归函数是调用自身的函数，用于处理嵌套结构。递归合并的核心思想是：遍历源数据，如果当前值是一个数组，则递归进入该层级继续合并；否则按规则进行合并（覆盖或追加）。下面我将详细讲解如何编写一个通用的递归合并函数，并给出完整代码示例。

递归合并的常见场景

• 配置合并：将多个配置文件按层级合并，后加载的配置覆盖前加载的。
• 多语言数据合并：不同语言包的结构相同，合并时保留所有键。
• 权限结构合并：将不同角色的权限树合并到用户权限中。

这些场景的共同特点是数据具有多层嵌套，且合并规则可能因业务而异。

递归合并函数的设计思路

1. 函数接收两个参数：基础数组 $base 和要合并的数组 $merge，返回合并后的数组。
2. 遍历 $merge 的每个键值对：
3. 如果当前键在 $base 中不存在，直接赋值。
4. 如果当前键存在，且两个值都是数组，则递归调用自身合并这两个子数组。
5. 如果当前键存在，但值不是数组（或其中一个不是数组），则根据规则决定是覆盖还是追加。
6. 为了避免出现合并时出现索引数组数值键混乱的问题，可以针对索引数组做特殊处理（如追加元素）。

下面的代码实现了一个可配置的递归合并函数，支持“覆盖”和“追加”两种模式。

<?php
/**
 * 自定义递归合并函数
 * @param array $base  基础数组
 * @param array $merge 要合并的数组
 * @param bool  $overwrite 是否覆盖相同键的值。true：覆盖（默认）；false：追加（键名相同时转为数组）
 * @return array
 */
function recursiveArrayMerge(array $base, array $merge, bool $overwrite = true): array
{
    foreach ($merge as $key => $value) {
        // 处理数字键（索引数组）：直接追加
        if (is_int($key)) {
            $base[] = $value;
            continue;
        }
        // 如果基础数组中不存在该键
        if (!array_key_exists($key, $base)) {
            $base[$key] = $value;
            continue;
        }
        // 键存在，且两个值都是数组 -> 递归合并
        if (is_array($base[$key]) && is_array($value)) {
            $base[$key] = recursiveArrayMerge($base[$key], $value, $overwrite);
            continue;
        }
        // 键存在，但非数组情况
        if ($overwrite) {
            // 覆盖模式：直接用新值替换旧值
            $base[$key] = $value;
        } else {
            // 追加模式：将新值和旧值一起放入数组
            $base[$key] = [$base[$key], $value];
        }
    }
    return $base;
}
?>

上述函数处理了以下情况：

• 数字键（索引数组）：直接追加到数组末尾，避免数值键冲突。
• 字符串键：如果基础数组没有该键，则直接赋值。
• 如果两个值都是数组，递归合并。
• 如果键存在且值非数组，根据 $overwrite 参数决定是覆盖还是合并成一个数组。

完整示例：合并多层配置数据

假设我们有两份配置文件，分别来自基础配置和用户自定义配置，需要递归合并以生成最终配置。

<?php
// 基础配置
$config = [
    'database' => [
        'host' => 'localhost',
        'port' => 3306,
        'username' => 'root',
        'options' => [
            'charset' => 'utf8',
            'collation' => 'utf8_general_ci'
        ]
    ],
    'app' => [
        'debug' => false,
        'log_level' => 'WARNING'
    ],
    'modules' => ['user', 'blog']
];

// 用户自定义配置（将要合并）
$custom = [
    'database' => [
        'host' => '192.168.1.100',
        'password' => 'secret',
        'options' => [
            'persistent' => true
        ]
    ],
    'app' => [
        'debug' => true,
        'log_level' => 'DEBUG'
    ],
    'modules' => ['admin', 'shop']  // 索引数组，会追加
];

// 覆盖模式合并
$result = recursiveArrayMerge($config, $custom, true);
print_r($result);
?>

输出结果（覆盖模式）：

Array
(
    [database] => Array
        (
            [host] => 192.168.1.100   // 被覆盖
            [port] => 3306
            [username] => root
            [password] => secret      // 新增
            [options] => Array
                (
                    [charset] => utf8
                    [collation] => utf8_general_ci
                    [persistent] => true  // 保留原有键，新增键
                )
        )
    [app] => Array
        (
            [debug] => true
            [log_level] => DEBUG
        )
    [modules] => Array
        (
            [0] => user
            [1] => blog
            [2] => admin
            [3] => shop
        )
)

在覆盖模式下，相同键的标量值被替换，子数组递归合并。索引数组（如 modules）则直接追加元素，保持了所有配置项。

注意事项与优化

• 避免无限递归：确保递归调用时，传入的数组层级是有穷的。如果数据自身包含循环引用（如对象嵌套），需增加深度限制或检测机制。
• 性能考虑：递归深度过深可能导致栈溢出。PHP默认递归深度大约为100-200层，对于大多数业务数据足够。如果处理超深层级，应改用迭代或增加 ini_set('xdebug.max_nesting_level', ...)。
• 合并策略多样性：实际项目中可能需要不同的合并规则（如合并时对特定键进行特殊处理）。可以在函数中添加回调参数，如 callable $customHandler，让调用者决定如何合并。
• 对象合并：如果数组中包含对象，需单独处理。上述函数中 is_array 会忽略对象，对象直接按标量处理（覆盖或追加）。

通过自定义递归合并函数，我们可以灵活地应对各种嵌套数据合并需求，而不必受限于内置函数的固定策略。掌握递归思想后，你还可以扩展出递归差集、递归交集等实用函数。

总结

本文从递归函数的基本概念出发，详细介绍了PHP中实现递归合并多层数据的思路和代码。我们编写了一个可配置的 recursiveArrayMerge 函数，支持覆盖和追加两种模式，并通过示例演示了合并配置数据的过程。希望这篇文章能帮助你更好地理解和应用PHP递归函数解决实际问题。

PHP递归函数数组合并递归数组合并array_merge_recursive多维数组处理