Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

WeakMap

Associe des données aux identités d’objets sans référence forte vers la clé.

Version : PHP 8.4; repository runtime, production runtime not attested

Syntaxe

new WeakMap()

Associe des données aux identités d’objets sans référence forte vers la clé. L’entrée disparaît avec la dernière référence forte. Les valeurs sont retenues fortement et une valeur pointant vers sa clé peut donc la maintenir en vie. En PHP 8.4 le ramasse-miettes peut libérer un cycle isolé entre valeur et clé. Si la clé est sa propre valeur, le compte vaut encore 1 après unset puis 0 après gc_collect_cycles().

$m=new WeakMap(); $obj=new stdClass(); $m[$obj]="cached"; $alias=$obj; unset($obj);
$while=count($m); unset($alias); echo json_encode([$while,count($m)]);
$key=new stdClass(); $m[$key]=$key; unset($key); $before=count($m); gc_collect_cycles(); echo PHP_EOL,json_encode([$before,count($m)]);
[1,0]
[1,0]

Exemples

<?php
$m=new WeakMap(); $obj=new stdClass(); $m[$obj]="cached"; $alias=$obj; unset($obj);
$while=count($m); unset($alias); echo json_encode([$while,count($m)]);
$key=new stdClass(); $m[$key]=$key; unset($key); $before=count($m); gc_collect_cycles(); echo PHP_EOL,json_encode([$before,count($m)]);

Résultat

[1,0]
[1,0]

Sources