如何用PHP弱引用WeakReference避免循环引用内存溢出？

本文共计1057个文字，预计阅读时间需要5分钟。

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) 打点定位。