PHP does not have a built-in WeakMap type, but similar functions can be implemented through the WeakMap class provided by the Weakref PECL extension. The key feature of WeakMap is that its keys are stored in a weak reference manner, avoiding preventing garbage collection and thus preventing memory leaks. When using it, you must first install and enable the Weakref extension. After creating a WeakMap instance, the object is stored as a key, and it will be automatically cleaned when there are no other references to the object. Applicable scenarios include: 1. Cache object-related data; 2. Add metadata to the object; 3. Avoid memory leaks in the event system. Notes include: 1. WeakMap is not a PHP core function; 2. The key must be an object; 3. The entry clearing time is uncontrollable. If the deployment environment allows, WeakMap is an effective tool to manage object relationships without affecting the life cycle.

PHP doesn't have a built-in WeakMap type like JavaScript does, but it does offer similar functionality through the use of weak references — typically via the WeakMap class provided by the Weakref PECL extension. If you're coming from JavaScript or another language where WeakMaps are native, understanding how they work (or can be simulated) in PHP is useful for managing object relationships without interfering with garbage collection.

What Makes a Weak Map “Weak”?

In languages ??that support them natively, WeakMaps hold their keys weakly . This means if the key (usually an object) is the only thing referencing that object, the object can still be garbage collected. In PHP, this behavior is made possible using the WeakMap class from the Weakref PECL extension.

Without this kind of structure:

• You might accidentally keep objects alive longer than necessary.
• Memory usage could balloon in long-running scripts or daemons.

So, the "weakness" here refers specifically to the relationship between the key and the value — not the value holding the key.

How to Use WeakMap in PHP

To use WeakMap , first you need to install and enable the Weakref extension. It's not bundled with PHP by default.

Once installed:

 $map = new WeakMap();

$obj = new stdClass();

$map[$obj] = 'some related data';

Now, as long as $obj is referenced somewhere else in your code, the entry stays in the map. But once all other references to $obj are gone, the garbage collector can clean it up — and the WeakMap will automatically drop the corresponding entry.

This is especially helpful when associating data with objects you don't control (like third-party classes), without affecting their lifecycle.

When Should You Use a Weak Map?

Here are a few practical use cases:

• Caching per-object data : Like storing computed values ??tied to specific objects without preventing those objects from being freed.
• Decorating objects without modifying them : Adding metadata or secondary properties without changing the original class definition.
• Avoiding memory leaks in event systems : If you attach handlers or data to event-emitting objects, WeakMap ensures you don't block garbage collection.

If you're working on large-scale applications or long-running processes (like daemons or CLI tools), these patterns help manage memory more efficiently.

A Few Things to Watch Out For

• Not part of core PHP : The WeakMap requires the Weakref PECL extension, which may not be available in all environments.
• Keys must be objects : Unlike regular arrays or hash maps, you can't use strings or numbers as keys.
• Unpredictable timing : You can't rely on exactly when an entry disappears from the map after its key is dereferenced — it depends on when garbage collection runs.

If portability or deployment simplicity is important, consider whether relying on WeakMap is worth the trade-off. For some use cases, manual cleanup or reference tracking might be acceptable alternatives.

Basically that's it. Weak Maps aren't something most PHP developers reach for every day, but when you need to associate data with objects without keeping them alive, they're incredibly handy — assuming you can use the extension.

The above is the detailed content of What are Weak Maps in PHP?. For more information, please follow other related articles on the PHP Chinese website!