array_replace_recursive() 是 PHP 中用于递归合并数组的核心函数，尤其适用于配置覆盖场景。它按字符串键进行深度替换：若相同键对应数组则递归合并，非数组则直接替换；对数字键则按索引替换而非追加，不会重新索引。与 array_merge_recursive() 不同，后者会将同键值（包括非数组）合并为新数组，导致意外嵌套，而前者更符合“覆盖”语义。需注意其对数字键的替换行为可能导致数据被意外覆盖，不适用于需保留所有元素的场景。
在PHP中对数组进行递归合并，最直接且常用的方法就是使用
array_replace_recursive()
函数。这个函数能够智能地将一个或多个数组的值合并到第一个数组中，特别是在遇到嵌套数组时，它会深入到这些子数组中进行递归替换，而不是简单地覆盖。但需要注意的是，它的行为并非总是你直觉上的“合并”，尤其是在处理数字键时，它更倾向于替换而非累加。
解决方案
array_replace_recursive()
函数是PHP标准库中用于实现深度数组合并的核心工具。它的基本语法是
array_replace_recursive(array $array1, array ...$arrays): array
。它会从左到右依次处理传入的数组，将后续数组的值替换到第一个数组中。
让我来详细解释一下它的工作机制和一些我个人在使用中发现的“小脾气”：
字符串键的替换与合并： 当遇到字符串键时，如果键在多个数组中都存在，那么右边数组（后传入的数组）的值会替换掉左边数组（先传入的数组）中相同键的值。如果两个相同键的值都是数组，那么它会递归地进入这两个子数组，继续进行替换合并。这非常符合我们常说的“配置覆盖”场景。
立即学习“PHP免费学习笔记（深入）”；
数字键的“替换”行为： 这是最容易让人产生误解的地方。
array_replace_recursive()
对于数字键的处理方式，与它处理字符串键的方式有所不同。它不会像
array_merge()
那样简单地重新索引或追加数字键的值。相反，它会尝试按索引进行替换。这意味着如果
$arr1
有一个
0
键，
$arr2
也有一个
0
键，那么
$arr2[0]
会直接替换
$arr1[0]
，即使它们都是数组，它也不会像字符串键那样进行深度合并。如果
$arr2
有一个
$key
而
$arr1
没有，那么这个
$key
会被添加到
$arr1
中。如果
$arr1
有一个
$key
而
$arr2
没有，那么
$arr1[$key]
会保持不变。
非数组值与数组值的替换： 如果在合并过程中，一个键在某个数组中对应的是一个非数组值（比如字符串、整数），而在另一个数组中对应的是一个数组，那么非数组值会被直接替换成数组。反之亦然。它不会尝试将非数组值“塞进”数组，或将数组“扁平化”成非数组。
来看一个具体的例子，这样可能更直观：
'My Application', 'debug_mode' => false, 'database' => [ 'host' => 'localhost', 'port' => 3306, 'username' => 'root', 'password' => '', 'options' => [ 'charset' => 'utf8mb4', 'persistent' => false ] ], 'features' => [ 'user_registration' => true, 'email_verification' => false, 0 => 'feature_a' // 这是一个数字键 ]];$user_config = [ 'debug_mode' => true, // 覆盖 debug_mode 'database' => [ 'host' => '192.168.1.100', // 覆盖 host 'password' => 'mysecret', // 覆盖 password 'options' => [ 'persistent' => true, // 覆盖 persistent 'timeout' => 5 // 新增 timeout ] ], 'features' => [ 'email_verification' => true, // 覆盖 email_verification 1 => 'feature_b' // 新增数字键 1 ], 'new_setting' => 'some_value' // 新增顶级设置];$merged_config = array_replace_recursive($defaults, $user_config);echo '';print_r($merged_config);echo '
';/*输出结果大致如下：Array( [app_name] => My Application [debug_mode] => 1 // true 被转换为 1 [database] => Array ( [host] => 192.168.1.100 [port] => 3306 [username] => root [password] => mysecret [options] => Array ( [charset] => utf8mb4 [persistent] => 1 // true 被转换为 1 [timeout] => 5 ) ) [features] => Array ( [user_registration] => 1 [email_verification] => 1 [0] => feature_a // 这里的数字键 0 保持不变，因为 user_config 没有覆盖它 [1] => feature_b // user_config 中的数字键 1 被添加进来 ) [new_setting] => some_value)*/// 再看一个数字键替换的例子$arr_base = ['a', 'b', 'c'];$arr_override = [0 => 'x', 2 => 'y', 3 => 'z']; // 覆盖索引 0, 2，新增索引 3$result_numeric = array_replace_recursive($arr_base, $arr_override);echo '
';print_r($result_numeric);echo '
';/*输出结果：Array( [0] => x [1] => b [2] => y [3] => z)*/// 可以看到，索引 0 和 2 的值被替换，索引 1 的值保持不变，索引 3 的值被添加。// 这里的行为更像是 "按索引替换"，而不是 "追加并重新索引"。?>
array_merge_recursive()
array_merge_recursive()
与
array_replace_recursive()
有何不同？
这是一个非常经典的问题，也是很多PHP开发者初次接触数组合并时容易混淆的地方。理解它们之间的核心差异至关重要，因为它们在某些情况下会导致截然不同的结果。
在我看来，最本质的区别在于：
array_merge_recursive()
倾向于累加（append），而
array_replace_recursive()
倾向于替换（replace）。
array_merge_recursive()
的行为：
字符串键： 如果两个数组中有相同的字符串键，并且它们的值都是数组，那么
array_merge_recursive()
会递归地合并这些子数组。但如果其中一个或两个值不是数组，它会将所有相同键的值放入一个新的数组中。这通常会导致意想不到的多层嵌套数组，比如
['key' => [value1, value2]]
。数字键： 对于数字键，
array_merge_recursive()
的行为更像是
array_merge()
。它会简单地将所有数字键的值追加到结果数组的末尾，并重新建立从
0
开始的连续索引。这意味着它会保留所有数字键的值，而不是替换它们。
让我们看个例子：
['a' => 1, 'b' => 2], 'items' => ['item1', 'item2'], 'data' => 'initial'];$arr2 = [ 'config' => ['b' => 3, 'c' => 4], 'items' => ['item3'], 'data' => 'updated'];$merged_recursive = array_merge_recursive($arr1, $arr2);echo '';echo 'array_merge_recursive 结果：' . PHP_EOL;print_r($merged_recursive);echo '
';/*输出：array_merge_recursive 结果：Array( [config] => Array ( [a] => 1 [b] => 3 // 'b' 被覆盖 [c] => 4 ) [items] => Array // 注意这里，'items' 变成了嵌套数组 ( [0] => item1 [1] => item2 [2] => item3 ) [data] => Array // 'data' 也变成了嵌套数组 ( [0] => initial [1] => updated ))*/?>
从上面的例子可以看出，
array_merge_recursive()
在
items
和
data
键上，将原始值和新值都保留了下来，并放入了一个新的数组中。这在配置合并的场景中，通常不是我们想要的行为。
array_replace_recursive()
的行为：
字符串键： 如前所述，它会递归地替换相同字符串键的值。如果都是数组，则递归合并；如果不是，则直接替换。这使得它非常适合配置覆盖。数字键： 它不会重新索引。它会尝试按现有索引进行替换。如果一个数字键在源数组中不存在，它会被添加。如果存在，则值会被替换。
再用同样的例子对比
array_replace_recursive()
：
['a' => 1, 'b' => 2], 'items' => ['item1', 'item2'], 'data' => 'initial'];$arr2 = [ 'config' => ['b' => 3, 'c' => 4], 'items' => ['item3'], 'data' => 'updated'];$replace_recursive = array_replace_recursive($arr1, $arr2);echo '';echo 'array_replace_recursive 结果：' . PHP_EOL;print_r($replace_recursive);echo '
';/*输出：array_replace_recursive 结果：Array( [config] => Array ( [a] => 1 [b] => 3 [c] => 4 ) [items] => Array ( [0] => item3 // 'item1' 被 'item3' 替换，'item2' 保持不变 [1] => item2 ) [data] => updated // 'initial' 被 'updated' 替换)*/?>
可以看到，
array_replace_recursive()
的结果更符合我们通常理解的“覆盖”和“合并”：
data
键的值被直接替换，
items
数组的第一个元素被替换，而第二个元素保持不变。
总结一下：如果你想要的是一个深度合并，其中新值（包括数组）会替换掉旧值，那么
array_replace_recursive()
是你的首选。它更适合处理配置、设置等需要覆盖默认值的场景。如果你想要的是将所有值都保留下来，尤其是将相同键的非数组值累加到一个新数组中，或者希望所有数字键都重新索引并追加，那么
array_merge_recursive()
可能会符合你的需求，但请务必小心它可能产生的复杂嵌套结构。在实际项目中，我个人很少直接使用
array_merge_recursive()
，因为它产生的结构往往不是我想要的。
array_replace_recursive()
array_replace_recursive()
有哪些局限性或需要注意的边缘情况？
虽然
array_replace_recursive()
在大多数深度配置合并场景下表现出色，但它并非万能药。在使用它时，有一些我踩过的坑和需要注意的局限性：
数字键的“替换”而非“智能合并”： 这是我前面强调过的，也是最常见的误解。如果你的数组中包含大量数字键（比如一个对象列表，每个对象都有一个唯一的ID，但你把它放在了数字索引的数组中），
array_replace_recursive()
会尝试按索引替换，而不是根据某个内部的ID进行智能合并。这意味着如果你有两个
[0 => ['id' => 1, 'name' => 'A']]
和
[0 => ['id' => 2, 'name' => 'B']]
，结果会是
[0 => ['id' => 2, 'name' => 'B']]
，而不是保留两个或根据ID合并。如果你需要根据特定字段（如
id
）来合并数组中的对象，`array
以上就是如何在PHP中对数组进行递归合并？array_replace_recursive()用法的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1293466.html
微信扫一扫 
支付宝扫一扫 
