PHP8.0怎样调用WeakMaps函数_PHP8.0弱引用映射调用术【内存】

WeakMap 是 PHP 8.0+ 引入的 final 类，必须用 new WeakMap() 实例化，键必须为对象且自动随键销毁而清理，不支持非对象键、静态方法或函数调用。

很多人刚接触 WeakMap 时会下意识当函数去“调用”，但其实这是个典型误区。WeakMap 是 PHP 8.0 引入的原生类，不是函数，直接用 WeakMap() 或 weakmap_init() 这种写法，只会得到 Fatal error: Uncaught Error: Class "WeakMap" not found 或者 Call to undefined function 的错误。原因很简单——它根本没有全局函数接口，唯一的正确姿势是实例化之后再操作。

实例化：必须 new WeakMap()

WeakMap 是 final 类，不可继承，也没有静态工厂方法。所以唯一合法创建方式就是 $map = new WeakMap();。常见的错误写法包括 WeakMap([])、WeakMap::create()、weak_map_new()——全都不存在。另外要注意类名大小写敏感，weakmap 或 weakMap 都会栽跟头。而且这条规则只适用于 PHP 8.0+，低于这个版本直接 fatal，不会有任何警告或空对象降级。

存取值：键必须是活生生的对象

WeakMap 的键强制要求为对象，任何非对象类型（string、int、null）传进来都会抛出 Fatal error: WeakMap key must be an object。合法的写法是这样：$map[$user] = ['role' => 'admin'];（其中 $user 是 new User()）。反之，用字符串、数字或者 null 当键，统统不行。

读取之前建议先用 isset($map[$obj]) 或者 $map->offsetExists($obj) 判断一下，虽然直接用 $map[$obj] 返回 null 不会报错，但加个判断总归更稳妥。最关键的一点是：键对象一旦被销毁，对应的条目自动消失——既不残留，也不会触发任何回调，安静得很。

遍历：foreach 是最安全的，别想着手动控制迭代器

虽然 WeakMap 实现了 Tra versable，但它的迭代器只遍历当前仍存活的键值对。如果你在 foreach 过程中修改 map（比如 unset($map[$obj])），或者键对象恰好在此期间被回收，行为是不靠谱的。推荐的做法老老实实用 foreach ($map as $obj => $value)，底层已经帮你处理好了生命周期。不要手动调 $map->getIterator() 再 while + next() 循环，除非你确实需要精细控制迭代节奏——大多数场景下没必要。

其他要注意的点：$map->count() 返回的是当前存活的条目数，不是初始插入数，它会随着 GC 而突变；没有 keys() 或 values() 方法，想提取所有键只能遍历，想批量清理只能逐个 offsetUnset 或者重建新实例。

别把 WeakMap 和 WeakReference 搞混了

两者都跟循环引用有关，但定位完全不一样。WeakReference 是单个弱指针，你得手动管理生命周期，判断 get() 是否返回 null，适合打破双向依赖链，比如 Observer 模式中 Subject 持有 WeakReference 到 Observer。WeakMap 则是一个按对象索引的弱缓存容器，你根本不用关心对象是否还活着，它自动剔除死键，适合元数据绑定、对象级缓存这种场景（比如 $cache[$request] = $response）。

一个重要的提醒：禁止把 WeakReference 当键塞进 WeakMap，键必须是原始对象，不是弱引用包装器。而且 WeakMap 的键对象被回收时，不会调用 __destruct 来通知你，它是静默的。如果你需要通知机制，得自己加 Observer 或钩子。

最后强调一个容易忽略的点：WeakMap 的“弱”只作用于键，不限制值。如果你往里面存了一个大数组或闭包，而这个闭包又捕获了其他长生命周期对象，内存照样涨。WeakMap 解决的是“键对象无法释放”的问题，不是万能内存保险丝，这点一定要搞清楚。