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 فتطبع دائمًا، لذا لالتقاط مخرجاتها تحتاج إلى التخزين المؤقت للمخرجات: 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 أو إلى واجهة برمجية، كثيرًا ما تكون صيغة 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 للسجلات والواجهات البرمجية، وprint_r أو var_dump لتصحيح أخطائك.