PHP var_dump() и print_r(): вывод массивов и отладка

print_r($array) выводит массив или объект с ключами и значениями в читаемом виде. var_dump($value) выводит ту же структуру плюс тип и длину каждого значения. Используйте print_r, чтобы увидеть, что лежит в массиве, и var_dump, когда нужно знать, это "1" или 1.

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

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

Сравните два вывода для admin: print_r ничего не вывел после стрелки, а var_dump вывел bool(false). Это главная причина брать при отладке var_dump.

print_r, var_dump и var_export

Три функции показывают одни и те же данные с разной детализацией:

<?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 читается легче всего, var_dump точнее всего, а var_export даёт код, который можно вставить обратно в файл.

Вывод print_r в виде строки

Передайте true вторым аргументом, и print_r вернёт текст, а не напечатает его. Так массив записывают в лог-файл или вставляют в более длинное сообщение.

<?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) возвращает строку так же. var_dump всегда печатает, поэтому чтобы поймать его вывод, нужна буферизация вывода: ob_start(); var_dump($x); $text = ob_get_clean();.

Красивый вывод массива в HTML через pre

В браузере переносы строк и пробелы print_r схлопываются в одну длинную строку, потому что HTML игнорирует пробельные символы. Оберните вывод в <pre>, чтобы сохранить разметку. Запустите и посмотрите на вкладку 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 становится важен, как только в данных может оказаться < или &, например в пользовательском вводе: без него браузер воспримет такой текст как HTML. Для данных, которые вы отправляете в JavaScript или API, часто удобнее всего форма json_encode.

Вывод нескольких значений сразу

var_dump принимает любое число аргументов и выводит их по очереди, так удобно быстро сравнить два значения рядом.

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

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

Вывод показывает, почему == считает их равными, а === нет: одно это string(2) "42", другое int(42).

Вывод объектов

Все три функции выводят и объекты. var_dump и print_r помечают закрытые и защищённые свойства ([label:Point:private]), что помогает, когда свойство будто бы пропало.

<?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 в выводе var_dump это id объекта. Две переменные, у которых показан один и тот же id, указывают на один объект.

Частая ошибка: echo для массива

echo превращает аргумент в строку. У массива нет строкового представления, поэтому PHP выводит слово Array и выдаёт предупреждение:

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

PHP выводит:

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

Выведите содержимое одной из функций выше или склейте значения сами:

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

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

implode нужен, чтобы показать список пользователю, json_encode для логов и API, а print_r или var_dump для вашей собственной отладки.