PHP var_dump() vs print_r(): stampare array e fare debug

print_r($array) stampa un array o un oggetto con le sue chiavi e i suoi valori in forma leggibile. var_dump($value) stampa la stessa struttura più il tipo e la lunghezza di ogni valore. Usa print_r per vedere cosa c'è in un array, e var_dump quando devi sapere se un valore è "1" o 1.

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

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

Confronta i due output per admin: print_r non ha stampato nulla dopo la freccia, var_dump ha stampato bool(false). Questa differenza è il motivo principale per usare var_dump durante il debug.

print_r vs var_dump vs var_export

Le tre funzioni mostrano gli stessi dati con un dettaglio diverso:

<?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";

print_r è il più facile da leggere, var_dump il più preciso, e var_export ti dà codice da reincollare in un file.

Ottenere l'output di print_r come stringa

Passa true come secondo argomento e print_r restituisce il testo invece di stamparlo. È così che scrivi un array in un file di log o lo inserisci in un messaggio più lungo.

<?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) restituisce una stringa allo stesso modo. var_dump stampa sempre, quindi per catturarlo ti serve l'output buffering: ob_start(); var_dump($x); $text = ob_get_clean();.

Stampare un array leggibile nell'HTML con pre

In un browser, gli a capo e gli spazi di print_r si riducono a un'unica lunga riga, perché l'HTML ignora gli spazi bianchi. Racchiudi l'output in <pre> per mantenere l'impaginazione. Eseguilo e guarda la scheda 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";

htmlspecialchars conta appena i dati possono contenere < o &, per esempio l'input dell'utente: senza, il browser tratterebbe quel testo come HTML. Per i dati che invii a JavaScript o a un'API, la forma con json_encode è spesso la più utile.

Stampare più valori insieme

var_dump accetta un numero qualsiasi di argomenti e li stampa uno dopo l'altro, il che è comodo per confrontare due valori fianco a fianco.

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

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

L'output mostra perché == dice che sono uguali e === no: uno è string(2) "42", l'altro int(42).

Stampare oggetti

Tutte e tre le funzioni stampano anche gli oggetti. var_dump e print_r indicano le proprietà private e protected ([label:Point:private]), il che aiuta quando una proprietà sembra mancare.

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

Il #1 nell'output di var_dump è l'id dell'oggetto. Due variabili che mostrano lo stesso id puntano allo stesso oggetto.

Errore comune: echo su un array

echo trasforma il suo argomento in una stringa. Un array non ha una forma stringa, quindi PHP stampa la parola Array e genera un warning:

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

PHP stampa:

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

Stampa il contenuto con una delle funzioni qui sopra, oppure unisci tu i valori:

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

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

implode serve per mostrare una lista a un utente, json_encode per log e API, e print_r o var_dump per il tuo debug.