PHP WeakReference 对象被回收后如何安全读取引用

PHP 的 WeakReference::get() 不是“永远取回对象”的缓存读取方法：被引用对象还活着时，它返回对象；对象已经销毁时，它返回 null。安全写法是每次读取都把结果接到一个临时变量上，先判断是否为 null，再访问属性或方法；不要把这个结果无条件放回长期缓存，否则又会建立普通强引用。

先分清弱引用和普通对象变量

弱引用适合“想观察一个对象，但不想因为观察它而延长生命周期”的场景，例如缓存对象、调试索引或观察者表。PHP 官方文档说明，创建弱引用不会增加被引用对象的引用计数；当对象的其他强引用都消失后，弱引用本身不会把它留在内存里。

因此，弱引用本身只能说明“现在还能不能找到对象”，不能保证下一行代码仍能找到。读取和使用应当尽量放在同一个局部范围内。

用 create 创建弱引用，再用 get 安全读取

WeakReference 不能用普通构造方式创建，应使用 WeakReference::create($object)。关键代码如下：先保留一个普通变量观察对象仍在时的结果，再 unset 普通变量，最后通过 get() 处理失效引用。

get();
if ($current instanceof SessionView) {
    echo $current->name;
}

// 释放最后一个外部强引用后，弱引用不会阻止对象销毁。
unset($view);

$afterRelease = $weak->get();
if ($afterRelease === null) {
    // 这里应走缓存未命中、重新构建或跳过本次观察的分支。
    echo '对象已回收';
}

这里的 instanceof 同时完成了非空判断和类型收窄。即便业务对象有多个实现，也建议在这个位置判断接口或基类，而不是先调用方法再等待运行时抛错。

缓存读取时不要把对象重新养回来

弱引用常被放在“可丢弃缓存”中。读取时可以把结果放入局部变量，命中就使用，未命中就重建；但不要为了方便把 get() 的结果再次写回一个长期数组。后者会让数组成为新的强引用持有者，改变原本的生命周期策略。

 */
    private array $items = [];

    public function remember(string $key, object $value): void
    {
        // 缓存只保存弱引用，不因缓存本身延长对象生命周期。
        $this->items[$key] = WeakReference::create($value);
    }

    public function find(string $key): ?object
    {
        $ref = $this->items[$key] ?? null;
        $value = $ref?->get();

        if ($value === null) {
            // 失效条目及时删除，避免数组长期堆积无效引用。
            unset($this->items[$key]);
            return null;
        }

        // 只返回本次调用需要的对象，不把它写回 items。
        return $value;
    }
}

按生命周期表检查四个容易误判的结果

排查“为什么 get() 突然变成 null”时，先找最后一个普通强引用，而不是反复调用 get()。下面的判断表可以作为代码审查清单。

还要注意一个时间窗口：$value = $weak->get() 成功后，$value 在当前作用域中就是普通强引用。因此可以在它上面完成一次完整操作，但操作结束后应让变量离开作用域、覆盖或显式释放，避免把观察型缓存变成隐形对象池。

常见问题

WeakReference::get() 返回 null 是异常吗？

不是。它表示被观察对象已经销毁，或当前已经没有可达的强引用；调用方应按缓存未命中或对象需要重建处理。

可以直接写 $weak->get()->name 吗？

不建议。对象已经回收时 get() 返回 null，应先保存结果并判断类型，再访问属性或方法。

为什么读取后对象没有被回收？

最常见原因是读取结果被保存到了长期数组、对象属性、闭包或其他结构中。检查这些位置是否无意中保留了新的普通强引用。