array_replace按顺序用后续数组覆盖前数组的键值，不支持递归合并，需自定义函数实现深层覆盖。示例表明，直接使用array_replace会整块替换嵌套数组，而通过递归函数可实现键级合并。与array_merge_recursive不同，后者合并同键数组值，前者则完全覆盖，选择取决于具体需求。
在PHP中，array_replace 函数用于用后面的数组元素替换前面数组中的对应键值。当处理多个数组时，它遵循特定的覆盖规则，但默认不支持递归（深层）合并。理解其行为对实现深层数组合并至关重要。
array_replace 基本覆盖规则
该函数遍历后续数组中的每一个元素，使用其键去替换第一个数组中相同键的值。如果第一个数组中不存在该键，则添加进去。
示例：
$a = ['name' => 'Tom', 'age' => 25, 'info' => ['city' => 'Beijing']]; $b = ['age' => 30, 'gender' => 'male']; $c = array_replace($a, $b); // 结果：['name' => 'Tom', 'age' => 30, 'info' => ['city' => 'Beijing'], 'gender' => 'male']
注意：info 是一个子数组，它被整体保留，并未与后续可能存在的同名结构进行深层合并。
多数组覆盖顺序与优先级
传入多个数组时，靠后的数组具有更高优先级，会逐层覆盖前面数组的同名键。
立即学习“PHP免费学习笔记（深入）”；
- 从左到右依次处理每个数组
- 后一个数组的值完全替换前一个数组中相同键的值（非递归）
- 新增键会被追加到结果数组中
$base = ['a' => 1, 'b' => ['x' => 10, 'y' => 20]]; $extra1 = ['b' => ['z' => 30]]; // 这会完全替换掉 $base['b'] $extra2 = ['c' => 100]; $result = array_replace($base, $extra1, $extra2); // 结果：['a' => 1, 'b' => ['z' => 30], 'c' => 100] // 注意：原 $base['b']['x'] 和 ['y'] 已丢失
实现递归深层合并（递归 array_replace 功能）
由于 array_replace 不支持递归合并，需手动实现。常见做法是遍历每个数组，遇到数组类型时递归合并。
以下是一个模拟递归 array_replace 的函数：
function array_replace_recursive($base) {
$arrays = func_get_args();
array_shift($arrays); // 移除第一个参数
foreach ($arrays as $array) {
foreach ($array as $key => $value) {
if (is_array($value) && isset($base[$key]) && is_array($base[$key])) {
$base[$key] = array_replace_recursive($base[$key], $value);
} else {
$base[$key] = $value;
}
}
}
return $base;
}
使用示例：
$a = ['user' => ['name' => 'Alice', 'profile' => ['age' => 20]]]; $b = ['user' => ['profile' => ['city' => 'Shanghai']]]; $c = array_replace_recursive($a, $b); // 结果： // [ // 'user' => [ // 'name' => 'Alice', // 'profile' => ['age' => 20, 'city' => 'Shanghai'] // ] // ]
此实现确保嵌套数组也能按键合并，而非整块替换。
与 array_merge_recursive 的区别
PHP自带的 array_merge_recursive 在遇到相同键的数组时，会将值合并为数组（可能导致结构变化），而我们实现的递归替换更接近“覆盖”语义。
对比示例：
$x = ['data' => ['id' => 1]]; $y = ['data' => ['name' => 'test']]; // array_merge_recursive 结果： // ['data' => ['id' => 1, 'name' => 'test']] ✅ 合并为一个数组 // array_replace_recursive 结果： // ['data' => ['name' => 'test']] ❌ 'id' 被覆盖
因此选择哪个函数取决于你希望是合并字段还是覆盖字段。
基本上就这些。掌握 array_replace 的扁平覆盖机制，并根据需要实现递归版本，能更好控制多层数组的数据合并逻辑。不复杂但容易忽略细节，尤其是嵌套结构的处理方式。
