当前位置：首页 > 文章列表 > 文章 > php教程 > PHP WeakMap 为什么对象销毁后键会自动消失

PHP WeakMap 为什么对象销毁后键会自动消失

来源：17golang原创 2026-10-06 15:25:36 0浏览收藏

WeakMap 的键会在对象销毁后自动消失，根本原因是：这个键不会增加对象的引用计数。只要业务变量、容器、闭包或其他属性都不再持有该对象，WeakMap 本身不会为了保留缓存条目而阻止对象被回收；对象被回收时，对应键值条目也会被移除。

官方资料：https://www.php.net/manual/en/class.weakmap.php

WeakMap 适合保存“依附于对象、可随时重建”的派生数据。它解决的是缓存寿命比业务对象更长的问题，不适合保存订单状态、权限结果等不能丢失的权威数据。

WeakMap 保护的是对象生命周期边界

PHP 对象变量保存的是可定位对象的标识。把对象赋给另一个变量，两个变量都会指向同一个对象。普通容器通常会形成强引用，因此即使业务变量已经释放，容器仍可能让对象继续存活。

WeakMap 的不同之处是，作为键放进去的对象不增加引用计数。PHP 官方手册明确说明：当 WeakMap 键成为对象的唯一剩余引用时，对象会被垃圾回收，并从 WeakMap 删除。这使缓存条目的寿命天然不超过键对象。

业务强引用、WeakMap 弱键与对象生命周期的静态关系图 — 图1：业务变量与普通容器可以形成强引用，WeakMap 键只建立弱关联；该图表达引用边界，不是执行时间线。

用 WeakMap 缓存对象的派生元数据

下面的示例给文档对象缓存一次计算得到的摘要。摘要可以重新计算，所以它适合跟随对象一起消失。

 */
    private WeakMap $items;

    public function __construct()
    {
        // WeakMap 只接受对象作为键
        $this->items = new WeakMap();
    }

    public function get(Document $document): string
    {
        if (!isset($this->items[$document])) {
            // 值是可重建的派生数据，不是业务事实
            $this->items[$document] = mb_substr($document->body, 0, 20);
        }

        return $this->items[$document];
    }

    public function count(): int
    {
        // count 只统计当前仍存活的条目
        return count($this->items);
    }
}

对象仍被调用方持有时，缓存可以正常命中。WeakMap 并不是“立刻丢数据”的容器，它只是拒绝成为延长键对象寿命的理由。

最后一个强引用消失后发生了什么

用一个最小调用即可观察边界。代码块中的输出只是预期说明，不把它冒充本机运行证据。

get($document);
echo $cache->count() . "\n";

// 删除最后一个外部强引用；WeakMap 键不会阻止对象回收
unset($document);

// 对于这里没有引用环的对象，条目会随对象释放而消失
echo $cache->count() . "\n";

在这个无引用环示例中，释放变量后引用计数可以立即归零，因此析构方法执行，WeakMap 条目也随之消失。若对象参与引用环，回收可能依赖 PHP 的循环垃圾回收机制；所以工程代码应依赖“条目最终不再存活”的语义，而不是把某个精确时刻当成业务事件。

文档对象、派生缓存与外部引用边界的静态关系图 — 图2：WeakMap 保存依附于 Document 的派生摘要，外部强引用决定对象是否仍存活；各连线表示依赖关系。

键没有消失时先排查隐藏强引用

WeakMap 中仍能看到对象，不等于 WeakMap 失效。更常见的原因是还有其他位置持有对象：

对象仍在普通数组、SplObjectStorage 或队列中；
闭包通过 use 捕获了对象；
服务对象的属性、静态属性或全局变量保存着对象；
另一个对象引用它，或者双方组成引用环；
调试代码本身把对象保存到临时集合中。

排查时应从“谁还拥有这个对象”入手，而不是对 WeakMap 手工反复 unset。如果确实需要立即撤销某条缓存，也可以显式执行 unset($map[$object])，但那是业务主动失效，不是弱键机制的必要步骤。

不要让缓存值反过来承担对象所有权

一个安全的设计原则是：WeakMap 的值只保存字符串、数字、不可变描述或与键对象生命周期无关的结果。不要让缓存值承担管理键对象的职责，也不要把必须可靠保存的数据只放在 WeakMap 中。

数据	是否适合 WeakMap	原因
对象解析后的摘要	适合	可重建，且只在对象存活时有意义
反射或格式化元数据	适合	依附对象并可再次计算
订单支付状态	不适合	不能因对象回收而丢失
跨请求会话数据	不适合	WeakMap 不是持久化存储