var_dump() vs print_r() w PHP: wypisywanie tablic i debug

print_r($array) wypisuje tablicę lub obiekt z kluczami i wartościami w czytelnej formie. var_dump($value) wypisuje tę samą strukturę oraz typ i długość każdej wartości. Używaj print_r, aby zobaczyć, co jest w tablicy, a var_dump, gdy musisz wiedzieć, czy wartość to "1", czy 1.

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

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

Porównaj oba wyniki dla admin: print_r nie wypisało nic po strzałce, a var_dump wypisało bool(false). Ta różnica to główny powód, by przy debugowaniu sięgać po var_dump.

print_r vs var_dump vs var_export

Te trzy funkcje pokazują te same dane z różną szczegółowością:

<?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 czyta się najłatwiej, var_dump jest najdokładniejsze, a var_export daje kod, który możesz wkleić z powrotem do pliku.

Wynik print_r jako string

Przekaż true jako drugi argument, a print_r zwróci tekst zamiast go wypisać. Tak zapisujesz tablicę do pliku logu albo umieszczasz ją w dłuższym komunikacie.

<?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) zwraca string w ten sam sposób. var_dump zawsze wypisuje, więc aby przechwycić jego wynik, potrzebujesz buforowania wyjścia: ob_start(); var_dump($x); $text = ob_get_clean();.

Ładne wypisanie tablicy w HTML przez pre

W przeglądarce złamania linii i spacje z print_r zlewają się w jedną długą linię, bo HTML ignoruje białe znaki. Otocz wynik znacznikiem <pre>, aby zachować układ. Uruchom to i spójrz na zakładkę 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 ma znaczenie, gdy tylko dane mogą zawierać < albo &, na przykład dane od użytkownika: bez tego przeglądarka potraktowałaby ten tekst jak HTML. Dla danych wysyłanych do JavaScriptu lub API często najbardziej przydatna jest forma json_encode.

Kilka wartości naraz

var_dump przyjmuje dowolną liczbę argumentów i wypisuje każdy po kolei, co pozwala szybko porównać dwie wartości obok siebie.

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

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

Wynik pokazuje, dlaczego == uznaje je za równe, a === nie: jedna to string(2) "42", druga int(42).

Wypisywanie obiektów

Wszystkie trzy funkcje wypisują też obiekty. var_dump i print_r oznaczają właściwości prywatne i chronione ([label:Point:private]), co pomaga, gdy jakaś właściwość wydaje się brakować.

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

#1 w wyniku var_dump to identyfikator obiektu. Dwie zmienne, które pokazują ten sam identyfikator, wskazują ten sam obiekt.

Częsty błąd: echo na tablicy

echo zamienia argument na string. Tablica nie ma postaci tekstowej, więc PHP wypisuje słowo Array i zgłasza ostrzeżenie:

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

PHP wypisuje:

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

Wypisz zawartość jedną z powyższych funkcji albo połącz wartości sam:

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

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

implode służy do pokazania listy użytkownikowi, json_encode do logów i API, a print_r lub var_dump do twojego własnego debugowania.