PHP var_dump() ou print_r(): imprimir arrays e depurar

print_r($array) imprime um array ou objeto com as chaves e os valores numa forma legível. var_dump($value) imprime a mesma estrutura mais o tipo e o tamanho de cada valor. Use print_r para ver o que há num array, e var_dump quando precisar saber se um valor é "1" ou 1.

<?php
$user = ["name" => "Ada", "age" => 36, "admin" => false, "tags" => ["math", "code"]];

print_r($user);
echo "\n";
var_dump($user);

Compare as duas saídas para admin: o print_r não imprimiu nada depois da seta, o var_dump imprimiu bool(false). Essa diferença é o principal motivo para usar o var_dump ao depurar.

print_r, var_dump ou var_export

As três funções mostram os mesmos dados com níveis diferentes de detalhe:

<?php
$values = [0, "0", "", null, false, 1.5];

echo "print_r:\n";
print_r($values);

echo "\nvar_dump:\n";
var_dump($values);

echo "\nvar_export:\n";
var_export($values);
echo "\n";

O print_r é o mais fácil de ler, o var_dump o mais preciso, e o var_export dá um código que você pode colar de volta num arquivo.

Obter a saída do print_r como string

Passe true como segundo argumento e o print_r retorna o texto em vez de imprimi-lo. É assim que você escreve um array num arquivo de log ou o coloca dentro de uma mensagem maior.

<?php
$order = ["id" => 1042, "items" => ["book", "pen"], "total" => 18.5];

$text = print_r($order, true);

echo "Order received:\n" . $text;
echo "That was " . strlen($text) . " characters\n";

file_put_contents("debug.log", date("H:i:s") . " " . $text, FILE_APPEND);
echo "Log size: " . filesize("debug.log") . " bytes\n";

var_export($value, true) retorna uma string do mesmo jeito. O var_dump sempre imprime, então para capturá-lo você precisa de output buffering: ob_start(); var_dump($x); $text = ob_get_clean();.

Formatar um array no HTML com pre

Num navegador, as quebras de linha e os espaços do print_r se juntam numa única linha longa, porque o HTML ignora espaços em branco. Envolva a saída em <pre> para manter o layout. Rode e olhe a aba Page.

<?php
$menu = [
    "Starters" => ["Soup" => 6, "Salad" => 7],
    "Mains" => ["Pasta" => 14, "Risotto" => 15],
];

echo "<h3>Without pre</h3>\n";
print_r($menu);

echo "<h3>With pre</h3>\n";
echo "<pre>" . htmlspecialchars(print_r($menu, true)) . "</pre>\n";

echo "<h3>As JSON</h3>\n";
echo "<pre>" . htmlspecialchars(json_encode($menu, JSON_PRETTY_PRINT)) . "</pre>\n";

O htmlspecialchars importa assim que os dados possam conter < ou &, por exemplo entradas do usuário: sem ele, o navegador trataria esse texto como HTML. Para dados que você envia ao JavaScript ou a uma API, a forma com json_encode costuma ser a mais útil.

Mostrar vários valores de uma vez

O var_dump aceita qualquer quantidade de argumentos e imprime um de cada vez, o que é rápido para comparar dois valores lado a lado.

<?php
$fromForm = "42";
$fromDb = 42;

var_dump($fromForm, $fromDb, $fromForm == $fromDb, $fromForm === $fromDb);

A saída mostra por que == diz que são iguais e === não: um é string(2) "42", o outro int(42).

Imprimir objetos

As três funções também imprimem objetos. O var_dump e o print_r marcam as propriedades privadas e protegidas ([label:Point:private]), o que ajuda quando uma propriedade parece estar faltando.

<?php
class Point
{
    public function __construct(
        public int $x,
        public int $y,
        private string $label = "origin",
    ) {}
}

$p = new Point(3, 4);

print_r($p);
echo "\n";
var_dump($p);

O #1 na saída do var_dump é o id do objeto. Duas variáveis que mostram o mesmo id apontam para o mesmo objeto.

Erro comum: echo num array

O echo transforma o argumento em string. Um array não tem forma de string, então o PHP imprime a palavra Array e gera um aviso:

<?php
$colors = ["red", "green", "blue"];
echo $colors;

O PHP imprime:

Warning: Array to string conversion in /home/index.php on line 3
Array

Imprima o conteúdo com uma das funções acima, ou junte os valores você mesmo:

<?php
$colors = ["red", "green", "blue"];

echo implode(", ", $colors), "\n";
echo json_encode($colors), "\n";
print_r($colors);

O implode serve para mostrar uma lista a um usuário, o json_encode para logs e APIs, e o print_r ou o var_dump para a sua própria depuração.