array_replace_recursive 不会修改原数组，它返回新数组；与 array_merge_recursive 的核心区别在于前者覆盖同键值，后者合并同键值导致嵌套。
array_replace_recursive 会修改原数组吗
不会。array_replace_recursive 是纯函数式操作，它返回一个新数组，原始数组完全不受影响。这点和 array_merge_recursive 类似，但行为逻辑不同——别误以为它会像 array_walk_recursive 那样就地修改。
常见错误是写成：$a = array_replace_recursive($a, $b)，以为在“更新”$a，其实只是重新赋值；如果真想复用变量名，必须显式赋值，但这不是函数副作用。
和 array_merge_recursive 的关键区别在哪
两者都递归处理嵌套数组，但合并策略相反：
-
array_replace_recursive：以第一个参数为“基底”，后续数组的键若存在，就直接覆盖（包括子数组），不合并； -
array_merge_recursive：遇到相同键，把值“装进数组”再合并，永远不覆盖，导致意外嵌套（比如字符串变数组）。
示例场景：配置覆盖。你有一份默认配置 $defaults 和用户自定义的 $overrides，要让 database.host 被替换，但保留 cache.timeout 不变——这时 array_replace_recursive($defaults, $overrides) 才符合直觉；用 array_merge_recursive 可能把 host 变成 ['127.0.0.1', 'localhost']。
立即学习“PHP免费学习笔记（深入）”；
空数组或非数组参数会怎样
array_replace_recursive 要求所有参数都是数组，否则会报 Warning 并返回 null（PHP 8.0+）或 false（旧版）。特别容易踩的坑：
- 传入
null或字符串（比如array_replace_recursive($cfg, $_POST['extra'] ?? null)）→ 直接中断执行； - 传入对象（即使实现了
ArrayAccess）→ 不被识别，触发警告； - 第一个参数为空数组
[]没问题，但第二个起若非数组，整个调用失败。
安全写法：统一 cast 成数组，例如 array_replace_recursive($base, (array)$user_input)，避免因数据来源不可控而崩。
深层嵌套时 key 类型混用的陷阱
该函数按「键名」匹配，不区分数字键和字符串数字键。比如 0 和 '0' 在 PHP 数组中视为不同键，但 array_replace_recursive 会分别处理——这通常不是问题；真正危险的是当子数组里混用整数索引和字符串键时，覆盖行为可能不符合预期。
例如：$a = ['items' => [0 => 'a', 'id' => 1]]，$b = ['items' => ['id' => 99]]，结果 items[0] 保留，items['id'] 被替换。但如果 $b['items'] 写成 [1 => 'new']，它不会覆盖 $a['items'][0]，而是新增键 1 ——因为键不匹配，不触发替换。
所以别依赖“顺序覆盖”，只依赖“键名精确匹配”。需要按位置合并？得换思路，比如用 array_values + array_merge。
