PHP ArrayObject::exchangeArray 怎样替换底层数组并保留对象包装

ArrayObject::exchangeArray() 的作用很直接：把当前 ArrayObject 持有的数组或对象替换成新的数据，并返回被替换的旧数组。它不会要求调用方重新创建一个包装对象，所以已经保存的对象引用仍然指向同一个 ArrayObject 实例。

官方地址：https://www.php.net/arrayobject.exchangearray.php

需要“换数据但保留对象包装”时，用 $old = $store->exchangeArray($newData) 同时完成交换和旧数据接收。真正需要留意的是：旧数组是否还要保留、交换前创建的迭代器是否还要继续使用，以及交换次数和数据副本数量是否可控。

exchangeArray 替换的到底是什么

ArrayObject 可以把数组包装成对象。调用 exchangeArray() 后，变化的是对象内部当前持有的数据；变量本身仍然是原来的对象。PHP 官方手册给出的签名是 public function exchangeArray(array|object $array): array：参数是新的数组或对象，返回值是旧数组。

因此可以把关系拆成三块：调用方保存的对象引用、对象内部的新存储，以及方法返回的旧数据。getArrayCopy() 是读取当前数据的快照；它和 exchangeArray() 的返回值用途不同，前者读当前值，后者接住被替换的值。

最小交换写法：对象不变，底层数据更换

最小用法是先创建一个 ArrayObject，再把新数组传给 exchangeArray()，并用变量接住旧数组。把旧数组接收写在调用处，后续清理、审计或比较都会更明确。

 'draft',
    'version' => 1,
]);

// 另一个变量仍然指向同一个 ArrayObject 实例。
$sameStore = $store;

$newData = [
    'status' => 'published',
    'version' => 2,
];

// 返回值是交换前的旧数组，store 本身仍然是同一个对象。
$oldData = $store->exchangeArray($newData);

// 用对象恒等比较确认没有重新创建包装对象。
var_dump($store === $sameStore); // bool(true)
var_dump($oldData['status']);    // string(5) "draft"
var_dump($store['status']);      // string(9) "published"
?>

这个例子把三个结果分开了：$store === $sameStore 说明对象包装没有换，$oldData 保存旧内容，$store['status'] 读取交换后的数据。若不需要旧内容，应尽快让保存旧数组的变量离开作用域或显式释放，避免它继续占用业务层的引用。

参数和返回值要按签名理解

exchangeArray() 的参数名虽然叫 $array，官方签名允许传入 array|object。在日常集合封装中，优先使用结构清楚的数组作为新存储，避免把对象属性转换成数组这一层语义混入交换逻辑。

返回值是旧数组，不是新的 ArrayObject，也不是一个新的迭代器。常见的三个误解可以这样区分：

引用、快照和迭代器不要混为一谈

如果业务代码先取得了旧数据或迭代器，再调用 exchangeArray()，这些变量不会自动变成“新数据观察器”。旧数组变量仍然代表旧内容；需要遍历新集合时，应在交换后重新取得迭代器；需要保存交换前状态时，应明确把返回值或 getArrayCopy() 保存为快照。

getIterator();

// 返回值作为旧数据快照，避免靠旧迭代器猜测交换前内容。
$oldData = $store->exchangeArray(['blue', 'yellow']);

// 如果要遍历交换后的集合，重新取得迭代器。
$newIterator = $store->getIterator();

// 业务代码应分别管理旧快照和新迭代器的生命周期。
foreach ($newIterator as $color) {
    echo $color, PHP_EOL;
}
?>

重点不是把交换包装成一个复杂流程，而是让变量名表达数据时点。$oldData 是旧数组，$newIterator 绑定交换后的对象状态；如果仍需要旧迭代器，应先完成它的读取，再进行交换，或改成先保存数组快照。

用三个指标判断交换是否值得

exchangeArray() 解决的是数据切换语义，不能只凭方法名断言“更快”。评估集合封装时，建议固定记录三个指标：单位时间内的交换次数、旧数组被保留的最长时间，以及同时存活的数据副本数量。

下面的代码只搭建测量骨架，不预设某台机器上的结果。它把每次交换返回的旧数组立即释放，适合观察“只保留当前集合”这一策略；如果业务需要审计旧版本，就应把保留策略单独计数。

 0]);
$payload = ['version' => 1, 'items' => 100];
$rounds = 1000; // 这是测量样本数，不代表业务推荐值。

$start = hrtime(true);
for ($i = 0; $i exchangeArray($payload);
    unset($old);
}
$elapsedMs = (hrtime(true) - $start) / 1_000_000;

// 只输出测量结果；不要把一次本地样本当成通用性能结论。
printf("交换次数：%d，耗时：%.3f ms%s", $rounds, $elapsedMs, PHP_EOL);
?>

如果旧数据要进入缓存或审计队列，就另记“旧数组保留时长”和“并存副本数”。对于大集合，真正需要优化的通常是数据生命周期和交换频率，而不是单独替换一个方法名。

在集合封装中集中交换动作

当多个业务模块都需要替换底层数组时，可以在自定义集合类中集中处理。这样调用方不用直接依赖旧数组的来源，也能统一记录交换次数或清理策略。

items = new ArrayObject($initial);
    }

    public function replace(array $next): array
    {
        // 返回旧数组，让上层决定记录、比较或释放的时机。
        $previous = $this->items->exchangeArray($next);
        $this->exchangeCount++;
        return $previous;
    }

    public function snapshot(): array
    {
        // 快照只读取当前数据，不改变底层存储。
        return $this->items->getArrayCopy();
    }
}
?>

这个封装把边界固定成两个动作：replace() 负责交换并返回旧值，snapshot() 负责读取当前副本。若接口只需要“替换成功”而不需要旧内容，也可以在更高层立即丢弃返回值，但要让这个选择成为明确的生命周期策略。

常见问题

exchangeArray 会创建新的 ArrayObject 吗？

不会。它替换当前对象持有的数据并返回旧数组；已经保存的对象引用仍然指向原来的 ArrayObject 实例。

为什么要把返回值赋给变量？

因为返回值就是旧数组。需要比较版本、记录变更或清理旧数据时，直接接收返回值比交换后再从对象中推断旧状态更可靠。

getArrayCopy 和 exchangeArray 有什么区别？

getArrayCopy() 读取当前数据的数组副本，不改变对象；exchangeArray() 会替换当前数据，并返回替换前的旧数组。

交换后还能继续使用旧迭代器吗？

不要把旧迭代器当成新集合的遍历器。交换后如果要读取新数据，重新调用 getIterator()，旧数据需要时则使用已经保存的旧数组或快照。

总结

ArrayObject::exchangeArray() 适合“保留对象包装、替换当前数据”的场景。最小可靠写法是同时保存旧数组返回值，并把对象引用、数据快照、迭代器和性能测量样本分开管理。这样换数据的动作简单，生命周期也不会被隐藏在一次方法调用里。