PHP8.1用array_replace_recursive深度合并多维数组怎么写-php教程-PHP中文网

array_replace_recursive() 是递归替换而非合并，同键子数组会被整体覆盖；PHP 8.1 完全支持，多数组按参数顺序优先级递增，非数组值直接覆盖，数字索引按位置替换。

php8.1用array_replace_recursive深度合并多维数组怎么写

直接用 array_replace_recursive() 就行，PHP 8.1 完全支持，语法和以前一样，但注意它“递归替换”而非“递归合并”——相同键的子数组会被整个替换，不是把元素逐个加进去。

核心行为：替换，不是追加

比如两个数组都有 'user' => ['name' => 'A'] 和 'user' => ['age' => 25]，结果是 'user' => ['age' => 25]（第二个覆盖第一个），'name' 会丢失——除非第二个数组也包含 'name'。

常见误用场景：

想把多个配置数组“叠起来”，却漏掉某些键 → 结果缺失字段
想合并多层默认值 + 用户配置，但用户只传了部分子键 → 缺失的子键不会保留默认值

基础写法（两层数组）

直接传入多个数组，前面的被后面的同键值覆盖：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

$defaults = ['db' => ['host' => 'localhost', 'port' => 3306]];
$envConfig = ['db' => ['host' => 'prod-db', 'user' => 'app']];
$result = array_replace_recursive($defaults, $envConfig);
// 结果：['db' => ['host' => 'prod-db', 'port' => 3306, 'user' => 'app']]

✅ host 被替换，port 保留，user 新增 —— 这才是递归替换的正确表现。

合并三个及以上数组

支持任意数量参数，顺序决定优先级（越靠后优先级越高）：

$base = ['site' => ['title' => 'My App', 'theme' => 'light']];
$locale = ['site' => ['lang' => 'zh-CN']];
$override = ['site' => ['title' => '新应用']];
$result = array_replace_recursive($base, $locale, $override);
// 结果：['site' => ['title' => '新应用', 'theme' => 'light', 'lang' => 'zh-CN']]

注意边界情况

遇到非数组类型（如字符串、数字）的同名键：直接覆盖，不递归 —— 比如 $a['x'] = ['a'=>1]，$b['x'] = 'hello'，结果 $x 就是字符串 'hello'
空数组 [] 会完全替换目标位置的子数组（不是清空其内容）
键为数字索引时，行为等同于 array_replace（按索引位置替换，不按值匹配）

如果需要的是“深度合并（保留所有键，不丢默认值）”，而不是“深度替换”，就得自己封装或用 array_merge_recursive（但后者会把同键值转为数组，需额外处理）。