WeakReference 通过不增加引用计数来打破循环引用，使对象可在无强引用时被及时回收；需用 WeakReference::create($obj) 创建，并始终通过 get() 安全访问，适用于 parent 引用、缓存等“可有可无”场景。
PHP 8.0+ 怎么用 WeakReference 打断循环引用
PHP 8.0 引入了 WeakReference，它不增加引用计数，因此不会阻止对象被垃圾回收。这正好用来解耦父子对象、事件监听器、缓存容器里常见的「你持有我、我持有你」死锁结构。
注意：WeakReference 不是万能胶——它只适用于「一方可有可无」的场景，比如日志上下文、临时回调绑定、树节点的 parent 引用。不能拿它替代正常对象生命周期管理。
-
WeakReference::create($obj)创建弱引用，$obj被销毁后，$ref->get()返回null - 不能对资源（resource）、标量、数组直接创建弱引用，只支持对象
- 调用
$ref->get()是唯一安全取值方式；直接访问属性会报Fatal error: Uncaught Error: Cannot fetch property from weak reference - 弱引用本身不阻止 GC，但若对象被 GC，后续再调用
get()永远返回null，不会恢复
为什么 unset() 或 null 赋值有时不管用
单纯写 $obj->parent = null 或 unset($obj->parent) 在某些结构下仍无法释放内存，尤其是当对象还被其他变量、全局数组、闭包 use 捕获、或未关闭的 PDOStatement 持有时。
典型误判场景：
立即学习“PHP免费学习笔记（深入）”；
- 类中定义了
__destruct()但没清空内部引用链，导致 GC 延迟触发 - 使用
array_map()或array_filter()处理大对象数组，匿名函数隐式捕获了外部作用域中的对象 - 框架中事件分发器把监听器对象存进静态数组，而监听器又持有了事件源（如
$this->emitter = $emitter） -
WeakReference不会自动清理这些外部持有者，它只解决「本对象内部双向引用」这一层
WeakReference 实际替换循环引用的写法对比
原始写法（内存泄漏风险高）：
class Node {
public ?Node $parent = null;
public array $children = [];
public function addChild(Node $child) {
$child->parent = $this; // ← 这里形成循环引用
$this->children[] = $child;
}
}
改用弱引用（推荐）：
class Node {
private WeakReference $parentRef;
public array $children = [];
public function __construct(?Node $parent = null) {
$this->parentRef = $parent ? WeakReference::create($parent) : WeakReference::create(null);
}
public function getParent(): ?Node {
return $this->parentRef->get();
}
public function addChild(Node $child) {
$child->parentRef = WeakReference::create($this);
$this->children[] = $child;
}
}
关键点：
- 构造时就用
WeakReference::create()包一层，别等运行时才建 - 所有读取都走
getParent()方法，避免裸指针误用 - 不要在
__destruct()里试图操作$this->parentRef->get()—— 此时父对象可能已被回收，get()返回null是正常行为
弱引用不是银弹：哪些情况它帮不上忙
WeakReference 解决不了所有内存问题。以下情况必须换思路：
- 大文件用
file_get_contents()一次性读入 → 改用fopen()+fgets()流式处理 - PDO 查询全量结果集（
fetchAll()）→ 改用游标分页或yield生成器 - 递归深度过大（如无限嵌套 JSON 解析）→ 改用迭代栈模拟，或加深度限制
- OPcache + CLI 下反复
require同一文件 → 清理 opcache，或确认是否真需重载 -
xdebug.mode=debug开着跑脚本 → 关掉再测，xdebug 单步本身吃内存很猛
真正棘手的内存问题，往往藏在「你以为只是引用，其实已复制」的地方：比如 json_encode() 后又 json_decode() 回对象，中间数组副本已占两倍内存；或者 array_merge() 在循环里不断拼大数组。这些地方 WeakReference 完全不生效，得靠 memory_get_usage(true) 打点定位。
