PHP var_dump() ou print_r() : afficher un tableau, déboguer

print_r($array) affiche un tableau ou un objet avec ses clés et ses valeurs sous une forme lisible. var_dump($value) affiche la même structure plus le type et la longueur de chaque valeur. Utilisez print_r pour voir ce que contient un tableau, et var_dump quand vous devez savoir si une valeur vaut "1" ou 1.

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

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

Comparez les deux sorties pour admin : print_r n'a rien affiché après la flèche, var_dump a affiché bool(false). Cette différence est la principale raison de prendre var_dump pour déboguer.

print_r, var_dump ou var_export

Les trois fonctions montrent les mêmes données avec un niveau de détail différent :

<?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 est la plus facile à lire, var_dump la plus précise, et var_export vous donne du code que vous pouvez recoller dans un fichier.

Obtenir la sortie de print_r sous forme de chaîne

Passez true en second argument et print_r renvoie le texte au lieu de l'afficher. C'est ainsi qu'on écrit un tableau dans un fichier de journal ou qu'on l'insère dans un message plus large.

<?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) renvoie une chaîne de la même façon. var_dump affiche toujours, donc pour capturer sa sortie il faut la mise en tampon de sortie : ob_start(); var_dump($x); $text = ob_get_clean();.

Afficher joliment un tableau en HTML avec pre

Dans un navigateur, les sauts de ligne et les espaces de print_r se réduisent à une longue ligne, car le HTML ignore les espaces blancs. Entourez la sortie de <pre> pour garder la mise en forme. Exécutez ceci et regardez l'onglet 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 compte dès que les données peuvent contenir < ou &, par exemple une saisie utilisateur : sans elle, le navigateur traiterait ce texte comme du HTML. Pour des données destinées à JavaScript ou à une API, la forme json_encode est souvent la plus utile.

Afficher plusieurs valeurs à la fois

var_dump accepte autant d'arguments que vous voulez et affiche chacun à son tour, ce qui permet de comparer rapidement deux valeurs côte à côte.

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

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

La sortie montre pourquoi == les dit égales et pas === : l'une est string(2) "42", l'autre int(42).

Afficher des objets

Les trois fonctions affichent aussi les objets. var_dump et print_r signalent les propriétés privées et protégées ([label:Point:private]), ce qui aide quand une propriété semble manquer.

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

Le #1 dans la sortie de var_dump est l'identifiant de l'objet. Deux variables qui montrent le même identifiant désignent le même objet.

Erreur fréquente : echo sur un tableau

echo transforme son argument en chaîne. Un tableau n'a pas de forme chaîne, donc PHP affiche le mot Array et déclenche un warning :

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

PHP affiche :

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

Affichez le contenu avec l'une des fonctions ci-dessus, ou assemblez vous-même les valeurs :

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

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

implode sert à montrer une liste à un utilisateur, json_encode aux journaux et aux API, et print_r ou var_dump à votre propre débogage.