debug_zval_dump

Exemplos

string(10) "Olá, Mundo" refcount(3)

Nota: Entendendo o refcount (contagem de referências)

O valor de refcount mostrado por este função pode ser surpreendente sem um entendimento detalhado da implementação interna do motor.

O Motor Zend usa contagem de referência para dois propósitos diferentes:

• Otimização de uso de memória usando a técnica chamada "cópia na escrita", onde múltiplas variáveis com o mesmo valor apontam para o mesma posição na memória. Quando alguma dessas variáveis é modificada, ela é apontada para uma nova cópia na memória, e a contagem de referências na original é diminuída em 1.
• Rastrear variáveis que foram atribuídas ou passadas por referência (consulte Referências). Esta contagem de referências é armazenada em um zval de referência separado, apontando para o zval correspondente ao valor atual. Este zval adicional atualmente não é mostrado pela função debug_zval_dump().

Como a função debug_zval_dump() recebe suas entradas como parâmetros normais, passados por valor, a técnica de cópia na escrita será usada para passá-los: em vez de copiar os dados, a contagem de referências será adicionada em uma unidade durante toda a duração da chamada à função. Se a função modificasse o parâmetro depois de recebê-lo, então seria feita uma cópia; como ela não modifica, ela irá mostrar uma contagem uma unidade acima em relação ao escopo que a chamou.

A passagem de parâmetros também evita que debug_zval_dump() mostre variáveis que foram atribuídas por referência. Para ilustrar, considere uma versão levemente modificada do exemplo acima:

<?php
$var1 = 'Olá,';
$var1 .= ' Mundo';
// Aponta três variáveis como referências ao mesmo valor
$var2 =& $var1;
$var3 =& $var1;

debug_zval_dump($var1);
?>

O exemplo acima produzirá:

string(10) "Olá, Mundo" refcount(2)

Embora $var1, $var2 e $var3 estejam ligadas como referências, apenas o valor é passado a debug_zval_dump(). Este valor é usado uma vez pelo conjunto de referências, e uma vez dentro de debug_zval_dump(), por isso mostra uma contagem de 2.

Complicações adicionais aparecem por conta de otimizações implementadas no motor para diferentes tipos de dados. Alguns tipos como inteiros não usam "cópia na escrita", por isso não exibem nenhuma contagem de referência. Em outros casos, a contagem mostra cópias extras usadas internamente, como quando uma string ou array literais são armazenados como parte de uma instrução de código.