PHP ArrayObject 怎么整体替换存储内容并取回旧数组

如果需要把一个 ArrayObject 的全部内容换成另一组配置，同时还要拿到替换前的数据，应直接调用 exchangeArray()：传入的新数组成为对象当前存储，方法返回替换前的旧数组。它不是逐项追加，也不会把旧数组和新数组合并。

PHP 官方手册地址：https://www.php.net/manual/en/arrayobject.exchangearray.php

记住方向：参数是“要放进去的新内容”，返回值是“被换出来的旧内容”。先接住返回值，再继续使用对象，最不容易把前后状态写反。

先看清替换前后的状态

ArrayObject::exchangeArray 接收一个数组或对象，返回旧数组。调用完成后，原来的 ArrayObject 实例仍然存在，迭代、计数和后续偏移访问都针对新存储内容。

用返回值保存旧数组

最小用法是把返回值赋给一个有含义的变量。下面的例子把运行配置切换为新版本，同时保留旧配置用于记录差异；代码里的 getArrayCopy() 用来读取替换后的对象内容。

 'cn-east',
    'timeout' => 3,
    'features' => ['cache' => true],
]);

// 新配置会整体接管 ArrayObject 的存储
$nextSettings = [
    'region' => 'cn-north',
    'timeout' => 5,
    'features' => ['cache' => false],
];

// 返回值是被替换出来的旧数组，不是传入的新数组
$previousSettings = $settings->exchangeArray($nextSettings);

// 对象现在读取到新配置，旧快照仍可用于审计或差异计算
$currentSettings = $settings->getArrayCopy();

var_dump($previousSettings['region']); // cn-east
var_dump($currentSettings['region']);   // cn-north
?>

这里没有重新创建对象，所以持有 $settings 引用的其他代码仍然指向同一个实例。需要注意的是，返回的是旧数组快照；如果还要长期保留它，应在业务层明确保存，而不是期待对象继续替你维护两份状态。

把整体替换放进配置切换流程

在配置中心、租户上下文或请求级状态集合中，整体替换通常有三个动作：接收候选数组、替换对象存储、记录旧值。把这三个动作写成一个小方法，可以避免调用方忘记接收返回值。

values = new ArrayObject($initial);
    }

    public function replace(array $replacement): array
    {
        // 先替换，再把被换出的旧数组交给调用方记录
        return $this->values->exchangeArray($replacement);
    }

    public function all(): array
    {
        // 读取当前存储的副本，避免暴露内部对象引用
        return $this->values->getArrayCopy();
    }
}

$runtime = new RuntimeSettings(['mode' => 'safe']);
$old = $runtime->replace(['mode' => 'fast']);

var_dump($old['mode']);            // safe
var_dump($runtime->all()['mode']); // fast
?>

这个封装的关键不是隐藏方法名，而是固定返回值语义：replace() 返回旧数组，all() 读取当前数组。日志、差异比较或回滚准备都可以在拿到 $old 后完成。

边界情况与版本兼容

空数组：传入 [] 仍然是一次完整替换。调用后对象为空，返回值保留原来的全部条目。

数字键：数字键和值会按传入数组进入新存储，不要把整体替换理解成按键合并；如果业务需要合并，应在调用前显式生成最终数组。

对象参数：手册签名允许传入数组或对象，但这篇文章只把数组作为稳定、直观的存储边界。若传入对象，应先明确对象属性如何映射为 ArrayObject 的存储内容，并为项目支持的 PHP 版本单独回归。

PHP 8.4：官方 ArrayObject 页面记录的是类常量类型化变更；exchangeArray() 的“传入新内容、返回旧数组”调用契约没有因此改变。升级时重点检查的是类型声明、调用方是否误把返回值当成新数组，以及项目对输入类型的约束。

迁移和回归清单

如果旧数组只用于一次差异计算，可以在调用后立即处理；如果它要用于审计或回滚，就应把它和切换时间、请求标识或配置版本一起保存。这样即使对象已经进入下一状态，也不会失去变更前的依据。

常见问题

exchangeArray 返回的是新数组还是旧数组？

返回旧数组。传入参数才是替换后留在 ArrayObject 中的新内容。

调用后需要重新 new 一个 ArrayObject 吗？

不需要。原实例的内部存储已经被替换，继续使用同一个对象即可。

能不能用 exchangeArray 做数组合并？

不能把它当成合并操作。它执行的是整体替换；需要合并时，先在外部生成最终数组，再传入 exchangeArray。

为什么要保存返回值？

返回值是唯一直接拿到被换出旧数组的地方。保存它可以做差异记录、审计或回滚准备，避免替换后再从对象里寻找已经不存在的旧内容。

依据：PHP 官方 ArrayObject::exchangeArray 手册与 ArrayObject 类说明页。本文示例围绕整体替换和旧数组返回值展开，不把普通数组赋值、数组合并或对象参数扩展成另一个问题。