(PHP 4 >= 4.2.0, PHP 5, PHP 7)
debug_zval_dump — Exibe a representação de um interno zend value
Exibe a representação de um interno zend value.
variable
A variável a ser avaliada.
Não há valor retornado.
Exemplo #1 Exemplo da debug_zval_dump()
<?php
$var1 = 'Hello World';
$var2 = '';
$var2 =& $var1;
debug_zval_dump(&$var1);
?>
O exemplo acima irá imprimir:
&string(11) "Hello World" refcount(3)
Nota: Cuidado com o
refcount
O valor
refcount
retornado por esta função não é óbvio em certas circunstâncias. Por exemplo, um desenvolvedor espera que o exemplo acima indique umrefcount
de2
. A terceira referência é criada quando debug_zval_dump() é chamada.Este comportamento ocorre quando uma variável não passada para debug_zval_dump() por referência. Para ilustrar, veja a pequena modificação do exemplo acima:
<?php
$var1 = 'Hello World';
$var2 = '';
$var2 =& $var1;
debug_zval_dump($var1); // not passed by reference, this time
?>O exemplo acima irá imprimir:
string(11) "Hello World" refcount(1)Por quê
refcount(1)
? Por causa da cópia da$var1
ser feita, quando a função é chamada.Esta função se torna muita confusa quando uma variável com um
refcount
de1
é passado (por cópia/valor):
<?php
$var1 = 'Hello World';
debug_zval_dump($var1);
?>O exemplo acima irá imprimir:
string(11) "Hello World" refcount(2)O
refcount
de2
, aqui, é extremamente não óbvio. Especialmente considerando os exemplos acima. Então o quê acontece?Quando uma variável tem uma única referência (com faz
$var1
antes de ser usada como um argumento para debug_zval_dump()), a engine do PHP otimiza em que ela é passada para uma função. Internalmente, PHP trata$var1
como uma referência (em que orefcount
é aumentado para o escopo desta função), com um aviso que se passado referência pode ser reescrito para, um cópia feita, mas somente no momento de escrita. Isto é conhecido como "cópia na escrita."Então, se debug_zval_dump() precisa escrever para o único parãmetro (e ele não faz), então uma cópia pode ser feita. Desde então, a referência para o parâmetro é mantida, fazendo com que o
refcount
seja incrementado para2
para o escopo da chamada da função.