var_dump() מול print_r() ב-PHP: הדפסת מערכים ודיבאג

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 תמיד מדפיסה, ולכן כדי ללכוד אותה צריך output buffering: 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 הוא המזהה של האובייקט. שני משתנים שמציגים אותו מזהה מצביעים על אותו אובייקט.

טעות נפוצה: 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 ללוגים ול-APIs, ו-print_r או var_dump לדיבאג שלכם.