PHP SplObjectStorage 怎样一次移除另一集合中的对象

需要把一批对象从当前集合中整体排除时，直接调用 $current->removeAll($excluded)。它会从 $current 里移除同时存在于 $excluded 的对象，参数存储本身不会因此被清空；方法返回移除完成后当前存储的剩余对象数量。

官方地址：https://www.php.net/manual/en/splobjectstorage.removeall.php

最容易出错的地方是把两个参数的角色写反，或把“对象属性相同”误认为“对象是同一个实例”。

先划清当前集合和排除集合

把 current 想成待继续处理的对象集合，把 excluded 想成已经处理过、需要从当前集合排除的对象集合。removeAll() 的目标是修改调用方法的那个存储：$current->removeAll($excluded)。如果写成 $excluded->removeAll($current)，改变的就会是另一个容器，业务含义也随之反过来。

用 removeAll() 完成对象集合差集

下面的示例使用两个 SplObjectStorage。代码没有在本文环境执行，注释和文字只说明官方方法的调用关系与预期语义。

 'shared'];
$other = (object) ['name' => 'other'];
$sameNameButNewObject = (object) ['name' => 'shared'];

$current = new SplObjectStorage();
$current[$shared] = '待处理';
$current[$other] = '待处理';

$excluded = new SplObjectStorage();
$excluded[$shared] = '已处理';
$excluded[$sameNameButNewObject] = '另一实例';

// 只从 current 中移除 excluded 里命中的同一对象实例
$remaining = $current->removeAll($excluded);

// remaining 表示 current 现在还剩多少对象，不是移除数量
echo $remaining, PHP_EOL;
var_dump($current->contains($shared));
var_dump($current->contains($other));
var_dump($current->contains($sameNameButNewObject));

按官方定义，$shared 会被移除，$other 会保留，而 $sameNameButNewObject 因为是另一个实例，不会匹配 $shared。因此示例中的返回值应表示 $current 仍有多少个对象；它不是“本次移除了几个对象”的统计。

按对象身份判断是否真的命中

SplObjectStorage 以对象作为成员，判断重点是同一个对象实例，而不是对象里的 name、id 等字段是否相等。上例中的 $sameNameButNewObject 看起来和 $shared 有相同属性，却不会因为属性相同而被移除。

这条边界决定了使用场景：如果排除条件来自业务编号，应先建立“业务编号到对象”的明确映射，再把真正需要排除的对象实例放入 $excluded；不要期待 removeAll() 自动按业务字段比较。若对象可能被重新创建或克隆，也要在构造排除集合时保存正确的实例引用。

用返回值确认当前集合的剩余范围

官方方法返回的是操作完成后当前存储中的剩余对象数量。可以把它用于后续分支，但不要把它当作删除数量；删除数量需要在操作前后自行比较计数，且通常只在确实需要统计时才有必要。

removeAll($excluded);
$removed = $before - $remaining;

// removeAll() 不会修改 excluded；任务结束后按生命周期释放临时容器
if ($remaining === 0) {
    echo '当前集合已没有待处理对象', PHP_EOL;
}
echo '本次移除数量：', $removed, PHP_EOL;

如果只是想判断是否还有候选对象，直接使用返回值或之后的 count($current) 即可。对于长驻进程，排除操作完成后应明确这两个容器是否还会复用；不再需要时结束其作用域或主动清理关联，避免把过期对象集合长期挂在全局状态中。

接入前的四个判断

• 确认调用者是需要被修改的当前存储。
• 确认参数存储只负责提供要排除的对象。
• 确认两个存储里放的是同一批对象实例，而不是仅属性相同的新对象。
• 把返回值理解为当前存储的剩余数量；只有需要删除统计时才用前后计数相减。

removeAll() 会清空参数存储吗？

不会。它从调用者存储中移除参数存储包含的对象，参数存储仍保留自己的对象集合。

两个对象的属性完全一样，为什么没有被移除？

因为对象属性相同不等于实例相同。需要按业务编号排除时，应先将编号映射到实际对象实例。

能不能把 removeAll() 当成删除数量统计？

不能。返回值是当前存储操作后的剩余对象数量；删除数量可用操作前数量减去返回值计算。