PHP SplObjectStorage 怎样给对象关联附加数据

PHP SplObjectStorage可以把对象作为键，把任意附加数据作为值：$storage[$object] = $info建立或更新关联，$storage[$object]读取数据。附加数据属于这个存储容器，无需写进对象自身属性。

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

先确认元数据跟随实例还是业务编号

例如同一轮任务处理需要给对象记录状态和尝试次数，但不想修改领域对象定义，可以单独建立对象到元数据的映射。SplObjectStorage的官方定位就是对象到数据的映射，也可作为对象集合。默认对象身份语义适合跟随同一个内存实例的临时信息。类文档

这里的选择讨论的是数据归属，不需要为使用集合引入云服务。同样属性的新对象不应自动继承另一个实例的处理状态。以下限定未重写哈希行为的标准SplObjectStorage。

用对象作键建立关联

新代码可以使用数组式赋值或offsetSet。虽然旧教程常写attach，官方已将该方法自PHP 8.5.0起标为弃用，建议改用offsetSet；并不是整个类都弃用。attach弃用说明、offsetSet接口。

下面是完整示例，未在本文环境运行，没有展示虚构运行输出。

 'export-17'];
$other = (object) ['id' => 'export-17'];
$metadata = new SplObjectStorage();
$metadata[$task] = ['state' => 'queued', 'attempts' => 0];

// 查的是同一个实例，不是属性是否相等
var_dump($metadata->offsetExists($task));
var_dump($metadata->offsetExists($other));

// 数组元数据先取出、修改，再整体回写
$info = $metadata[$task];
$info['state'] = 'running';
$info['attempts']++;
$metadata[$task] = $info;

foreach ($metadata as $object) {
    // 迭代值是对象；用对象读取附加数据
    $data = $metadata[$object];
    echo $object->id, ':', $data['state'], PHP_EOL;
}

// 本次处理结束，移除关联，不等于销毁所有外部对象变量
unset($metadata[$task]);

按标准实例身份语义，task存在而other不存在，尽管它们的id相同。回写后，task对应的state为running、attempts为1；这是代码预期含义，不是本文实测记录。迭代得到对象后，再用它读取元数据，避免把迭代值误当附加数组。

更新数组元数据时显式回写

不要依赖$metadata[$task]['attempts']++这类间接修改。对于取出的数组，采用“取到局部变量、修改、整体赋回”的方式，把更新明确落回存储。后一次赋值替换该对象的附加数据，不是自动合并数组字段；需要保留旧字段时应基于旧info修改。

对象可能不存在时先调用offsetExists，不要靠读取返回值是否为null判断成员资格。附加值本来就可以是null，而读取未关联对象与读取已关联null是不同情况。成员判断、元数据读取。

控制关联的存活范围

为一次任务建立一个存储实例，任务完成后移除关联或结束容器作用域，通常比把它放进长期全局状态更容易管理。SplObjectStorage会持有加入的对象；不要把它当成对象失去外部引用后自动移除条目的弱键容器。

附加值也可能包含其他对象。数组回写只解决容器中值的更新，不会自动把整个对象图深复制。若跨任务复用同一容器，还要清楚旧条目何时清理；删除关联并不承诺外部变量引用的对象立即销毁。

接入前的判断清单

• 确认键是同一实例，还是应该使用业务ID。
• 使用数组式赋值或offsetSet写入。
• 读取前区分成员资格与null值。
• 数组修改后整体回写，避免丢失原字段。
• 为长期运行进程明确关联清理时机。

修改对象属性会丢失附加数据吗？

标准对象身份映射不会因为普通属性变化就把它当作新实例；但重新创建或克隆的对象具有不同身份，不能当原来的键。

同一个对象能关联两份数据吗？

同一存储里对应一个附加值。需要多项数据时可把它们放入一个数组，或为不同处理职责使用不同存储实例。

能跨进程凭同一个id取得这份数据吗？

不能仅凭实例映射做到。跨进程查找应显式使用业务编号和共享存储，这与本例的内存元数据是不同需求。