WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

WeakMap

Ordnet Daten Objektidentitäten zu, ohne Schlüssel stark zu referenzieren.

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

Syntax

new WeakMap()

Ordnet Daten Objektidentitäten zu, ohne Schlüssel stark zu referenzieren. Nach Verlust der letzten starken Referenz verschwindet der Eintrag. Werte werden stark gehalten, daher kann ein Wert mit Rückverweis seinen Schlüssel am Leben erhalten. In PHP 8.4 kann die Zyklensammlung einen isolierten Wert-Schlüssel-Zyklus freigeben. Ist der Schlüssel selbst der Wert, beträgt die Anzahl nach unset noch 1 und nach gc_collect_cycles() 0.

$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]

Beispiele

<?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)]);

Ergebnis

[1,0]
[1,0]

Quellen