PHP SplObjectStorage 如何按对象去重：attach、contains 与 detach 生命周期

做事件监听或对象去重时，数组并不总是合适：两个属性值完全相同的对象，仍可能代表两个不同的实例。SplObjectStorage 的优势正在这里——它按对象身份保存成员，也可以给每个对象挂一份数据。先掌握 attach、contains、detach 的生命周期，再迁移到 PHP 8.5 推荐的数组访问式写法，代码会更稳。

把 SplObjectStorage 当成“对象键的集合或映射”，不要当成按字段比较的数组去重器；PHP 8.5 新代码优先使用 offsetSet、offsetExists 和 offsetUnset。

先把“对象身份”和“字段相等”分开

SplObjectStorage 的键必须是对象。下面两个 stdClass 实例拥有相同字段，却是两个独立对象；把它们放进存储后，数量应为 2。这是对象集合和“按某个 id 去重”的根本区别。

name = 'worker';
$second = new stdClass();
$second->name = 'worker';

$storage = new SplObjectStorage();
$storage[$first] = 'first instance';
$storage[$second] = 'second instance';

var_dump(count($storage)); // int(2)
var_dump($first === $second); // bool(false)

这里的 === 只是把身份差异显式打印出来。若业务真正需要按用户编号合并，应该使用数组或数据库唯一键；不要先把业务规则塞进 SplObjectStorage，再期待它替你比较对象内容。

attach、contains、detach 如何组成一条生命周期

老版本代码里常见的是 attach 加入对象、contains 判断成员、detach 移除对象。三步的判断对象始终是同一个实例，而不是后来重新构造的“内容相同对象”。

attach($listener, ['event' => 'order.created']);
var_dump($storage->contains($listener)); // bool(true)
var_dump($storage[$listener]['event']); // string(13) "order.created"

$storage->detach($listener);
var_dump($storage->contains($listener)); // bool(false)
var_dump(count($storage)); // int(0)

attach 的第二个参数是关联数据，省略时相当于存入 null。detach 后对象不再是集合成员，关联数据也随存储项一起消失。若监听器仍被其他地方引用，它本身不会因此销毁；这里清理的是存储关系，不是强行释放对象。

重复加入会发生什么，空数据又怎么判断

同一个对象再次 attach 不会新增第二个条目，但带入的新信息会覆盖旧信息。这个行为适合给一个对象刷新状态，不适合表达“同一对象保留多条历史记录”。历史记录应放在对象关联的数组、队列或专门的持久化结构中。

attach($job, ['state' => 'queued']);
$storage->attach($job, ['state' => 'running']);

var_dump(count($storage)); // int(1)
var_dump($storage[$job]['state']); // string(7) "running"
var_dump($storage->contains(new stdClass())); // bool(false)

最后一次判断故意传入新建对象。即使它没有字段，也不会命中 $job。因此排查“为什么 contains 返回 false”时，先检查对象引用是否来自同一个生命周期，而不是只打印几个属性。

PHP 8.5 用 offsetSet、offsetExists、offsetUnset 替代旧方法

PHP 官方手册已把 attach、contains、detach 标记为 PHP 8.5 的 Deprecated，并分别指向 offsetSet、offsetExists、offsetUnset。迁移时不必改变存储模型，只改调用入口：

 'order.created'];
var_dump(isset($storage[$listener])); // bool(true)
var_dump($storage[$listener]['event']); // string(13) "order.created"

unset($storage[$listener]);
var_dump(isset($storage[$listener])); // bool(false)

数组访问式写法让“对象到数据”的映射更直观，也避开 8.5 的弃用提示。版本兼容项目可以暂时保留旧方法，但应把替换写进升级清单，并在 CI 中用目标 PHP 版本执行一遍新增、读取、更新和移除。

别把 SplObjectStorage 当成万能缓存

它保留的是对象引用关系，适合监听器、运行时上下文和临时对象集合；它不是跨进程缓存，也不替代数据库唯一约束。把长生命周期对象放入全局存储而不在结束时 unset 或 detach，会让存储一直持有这些对象，造成可观的内存保留。

• 需要按业务主键合并时，使用数组键或数据库唯一索引。
• 需要给对象附加多个事件时，把历史放到关联数组，不要重复登记同一对象。
• 请求、任务或订阅结束时清理存储关系，并用 count 验证回到预期数量。
• 升级到 PHP 8.5 时，检查弃用日志，把三个旧方法逐个替换。

相关问题

两个属性完全一样的对象会被合并吗？

不会。SplObjectStorage 按对象身份区分它们；只有同一个对象实例再次加入时，存储数量才保持不变。

关联数据能不能直接修改其中一个字段？

更稳妥的方式是先取出关联数组，修改后再写回对象键；不要依赖重载元素的间接修改行为。

PHP 8.5 还能调用 attach 吗？

方法仍存在，但已标记为 Deprecated。新代码使用数组访问式接口，旧项目则在升级测试中完成替换。

小结

SplObjectStorage 的价值是明确表达对象身份和对象关联数据。掌握加入、判断、移除的生命周期后，再把旧式方法迁移到 offsetSet、offsetExists、offsetUnset，既能保留原有语义，也能减少 PHP 8.5 的弃用噪声。