Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

WeakMap

Associa dados a identidades sem referência forte à chave.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

new WeakMap()

Associa dados a identidades sem referência forte à chave. A entrada desaparece quando se perde a última referência forte. Os valores são mantidos fortemente e um valor que aponte para a chave pode conservá-la viva. No PHP 8.4 o coletor pode libertar um ciclo isolado de valor e chave. Se a chave for o seu próprio valor a contagem continua em 1 após unset e passa a 0 apó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]

Exemplos

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

Resultado

[1,0]
[1,0]

Fontes