PHP WeakMap 怎样让对象键随生命周期回收

PHP 的 WeakMap 适合保存“对象还活着时才有意义”的附加数据。它的键必须是对象；当对象不再被程序中的其他位置引用时，对应的条目会随对象生命周期结束而被清理，因此不会像普通数组那样因为保存键而把对象继续留在内存里。

最小判断可以记成一句话：需要用对象身份关联元数据，但不希望关联表反过来延长对象寿命，就考虑 WeakMap。下面用一个请求内的解析元数据缓存说明它的结构和边界。

先分清普通数组和 WeakMap 的持有关系

普通数组把对象放进键或值时，通常会形成强引用；只要数组还在，对象就可能继续存活。WeakMap 则把对象作为弱键，读取时仍然可以按对象身份找到数据，但这张表不是对象的拥有者。

这一区别对缓存尤其重要。缓存的值可以描述对象、保存解析结果或记录请求内状态，但缓存本身不应该成为对象的全局所有者。WeakMap 让“按对象查数据”和“对象结束后清掉数据”落在同一个数据结构里。

用对象作为弱键保存附加数据

下面的例子给每个 RequestContext 对象关联一个解析结果。代码只演示数据结构，不需要先把它改成全局单例；实际项目可以把 WeakMap 封装在一个服务对象中。

 '/reports',
    'tenant' => 'acme',
];

// 只要 $context 仍被引用，就可以通过同一个对象取回附加数据。
echo $metadata[$context]['route'], PHP_EOL;
echo $metadata->count(), PHP_EOL;
?>

这里的关键不是数组值长什么样，而是键的身份。新建一个属性相同、但不是同一个实例的对象，不能取到旧对象的条目。需要先用 isset 或 array_key_exists 一类明确的业务判断，再决定是否覆盖缓存值。

取消最后一个引用后，条目为什么会消失

WeakMap 的清理边界是对象是否仍有其他强引用。把变量设为 null 只是移除其中一个引用；如果业务容器、闭包或其他对象还保存着同一个实例，条目仍然存在。只有对象真正不再可达，WeakMap 才没有理由继续保留关联数据。

 ['id', 'amount']];

// 保存一个额外引用时，WeakMap 条目不会因为 $parser 变量变化而消失。
$anotherReference = $parser;
$parser = null;
echo $cache->count(), PHP_EOL; // 仍可看到 1 条关联。

// 释放最后一个外部引用后，对象和弱键关联都可以被清理。
$anotherReference = null;
echo $cache->count(), PHP_EOL; // 后续观察通常应按 0 条关联理解。
?>

不要把上面的计数当成精确的垃圾回收时序承诺。文章要点是引用关系：对象仍可达时条目可读；对象不可达后，条目不再应该被业务代码依赖。遍历 WeakMap 也只适合处理当前仍存活的对象关联，不适合当作历史记录。

四个容易误判的边界

值反向引用键时，弱键不等于无环引用

如果值对象又强引用了键对象，整个关系可能仍然可达。WeakMap 只改变键这一侧的持有方式，不会替你拆掉业务对象内部的强引用环。发现条目没有按预期消失时，先画出谁引用谁，再检查闭包、容器属性和事件监听器。

键必须是对象

字符串、整数和普通标量不能直接作为 WeakMap 的键。如果需求是按字符串标识缓存，就用普通数组或明确的缓存接口；不要为了追求“自动清理”把对象强行包装成无意义的键对象。

仍然被业务代码使用的对象不会自动消失

WeakMap 不是定时清理器，也不会替你释放数据库连接、文件句柄或外部服务资源。它只管理映射条目与对象可达性的关系，资源清理仍应由显式的关闭、取消或生命周期钩子负责。

条目数量不是性能监控指标

count() 和遍历适合辅助观察当前关联，不应直接等同于进程内对象数量、垃圾回收次数或内存使用量。性能判断应结合真正的缓存命中、对象创建和业务请求数据。

什么时候选 WeakMap，什么时候不用

落地时可以先写清楚“谁拥有对象、谁只是附加数据、对象结束后是否还需要这条记录”。如果记录必须在对象消失后仍可查，WeakMap 就不是合适的存储；如果记录只服务于对象存活期间的解析、格式化或临时缓存，它通常能让清理边界更自然。

常见问题

WeakMap 会立刻删除对象吗？

不会。它不会主动销毁仍被其他代码引用的对象，只是不把对象作为长期强拥有者。对象何时真正不可达，取决于程序中的引用关系和运行时回收机制。

可以遍历 WeakMap 取出所有历史对象吗？

不能把它当历史索引。遍历面向当前仍存在的关联，映射的设计目标正是允许对象结束后条目消失。

WeakMap 适合做全局缓存吗？

可以作为按对象关联的辅助结构，但全局范围不会改变弱键语义。若缓存结果必须跨请求、跨对象或按业务 ID 复用，应选择具有明确失效策略的缓存存储。