PHP7.2 使用 SplObjectStorage 存储对象，对象销毁后内存释放问题-php教程-PHP中文网

splobjectstorage不释放内存是因为它对所存对象维持强引用，只要对象未被detach()显式移除，其引用计数就不会归零，导致即使unset($obj)或对象超作用域，内存仍无法释放；必须调用$storage->detach($obj)并配合gc_collect_cycles()才能安全回收。

php7.2 使用 splobjectstorage 存储对象，对象销毁后内存释放问题

为什么 SplObjectStorage 里的对象不释放内存

因为 SplObjectStorage 对所存对象维持强引用，只要它自己没被销毁或显式移除，对象的引用计数就不会归零。哪怕你已经 unset($obj) 或让对象超出作用域，只要它还在 $storage 里，PHP 的引用计数机制就认为它“还活着”。

常见错误现象：

memory_get_usage() 持续上涨，即使反复创建/销毁对象
调用 gc_collect_cycles() 后内存无明显下降
用 spl_object_id($obj) 查到的 ID 在后续仍能从 $storage 中取出对象

根本原因不是 GC 失效，而是你没真正“断开连接”——SplObjectStorage 是容器，不是缓存代理。

如何安全地从 SplObjectStorage 中移除对象并释放内存

必须用 detach() 显式解除绑定，不能只靠 unset() 容器变量或对象变量。

实操要点：

对每个要清理的对象，调用 $storage->detach($obj)；仅 unset($obj) 不起作用
若不确定对象是否在存储中，先用 $storage->contains($obj) 判断，避免 detach() 报 Notice
批量清理时，不要边遍历边 detach()（会破坏内部迭代器），改用 clone 后遍历副本，或先收集键再清理
清理后建议立即调用 gc_collect_cycles()，尤其在长生命周期脚本中（如 CLI 工具、队列消费者）

示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$storage = new SplObjectStorage();
$obj = new stdClass();
$storage->attach($obj);

// ❌ 错误：只 unset 变量
unset($obj);
// 此时 $obj 仍存在于 $storage 中，内存未释放

// ✅ 正确：先 detach，再 unset（可选）
$storage->detach($obj);
unset($obj); // 可省略，但语义更清晰
gc_collect_cycles();

SplObjectStorage + 循环引用的双重陷阱

当对象本身存在循环引用（比如 A→B→A），又同时被 SplObjectStorage 持有时，GC 几乎无法自动回收——引用计数卡在 ≥1，且循环结构未被根缓冲区捕获。

典型场景：

Observer 模式中，SplObjectStorage 存了观察者，而观察者又持有了被观察对象的引用
树形结构节点用 SplObjectStorage 缓存子节点，同时子节点反向持有父节点引用

解决方向：

优先用 WeakReference::create($obj)（PHP 7.4+）替代直接存储对象，彻底避开强引用
若必须双向持有，确保在对象销毁前调用 $storage->detach($obj) + 手动置空所有循环属性（如 $obj->parent = null）
避免在 __destruct() 中调用 $storage->detach($this) —— 此时 $storage 可能已不可达或正在析构，行为不可靠

替代方案：什么时候该放弃 SplObjectStorage

如果你的使用场景满足以下任一条件，SplObjectStorage 就不是最优解：

对象生命周期短、需高频增删（attach/detach 开销比数组高）
只需要对象唯一标识，不依赖对象身份做查找（此时用 spl_object_hash($obj) + 普通数组更轻量）
需要弱引用语义（PHP 7.4+ 必须用 WeakReference，SplObjectStorage 不支持）
运行环境是 PHP spl_object_id() 不可用，SplObjectStorage 的哈希逻辑更易碰撞）

简单替代写法：

// 用 spl_object_id 做键的普通数组，手动管理
$map = [];
$id = spl_object_id($obj);
$map[$id] = $obj;
// 释放时：
unset($map[$id]);
// 注意：对象销毁后，$id 可能被复用，所以不能长期依赖 $id 查找

最易被忽略的一点：无论用哪种方式，SplObjectStorage 本身也是对象，如果把它设为静态属性或全局变量，它自己就成了内存泄漏源——它的生命周期可能比所有存入对象都长。