PHP/var dump

(PHP 4, PHP 5, PHP 7)

تستخلص الدالة var_dump()‎‎‎ معلومات حول المتغيّر.

الوصف

void var_dump ( mixed $expression [, mixed $... ] )

تعرض هذه الدالة معلومات مُنظَّمة حول واحد أو أكثر من التعابير (expressions) بما في ذلك نوعها وقيمتها. تُستكشف المصفوفات والكائنات بشكل تكراري مع قيم بغرض إظهار البنية.

تُعاد كافة خصائص الكائنات المحميّة والخاصّة والعامّة ما لم يعتمد الكائن التابع debugInfo()‎__ (اعتُمِدَ في إصدار PHP 5.6.0).

فائدة: كما هو الحال مع أي شيء يُخرِج نتائجه مباشرةً إلى المتصفّح، يُمكِن استخدام دوال التحكّم بالمخرجات لالتقاط خرْج هذه الدالة وحفظه في سلسلة نصّيّة على سبيل المثال.

المعاملات

expression

المتغيّر المطلوب استخلاص معلومات عنه.

القيم المعادة

لا تُعاد أي قيمة.

أمثلة

المثال 1: مثال على الدالة var_dump()‎

<?php
$a = array(1, 2, array("a", "b", "c"));
var_dump($a);
?>

ينتج عن المثال السّابق ما يلي:

array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  array(3) {
    [0]=>
    string(1) "a"
    [1]=>
    string(1) "b"
    [2]=>
    string(1) "c"
  }
}

<?php

$b = 3.1;
$c = true;
var_dump($b, $c);

ينتج عن المثال السّابق ما يلي:

float(3.1)
bool(true)

انظر أيضًا

• الدالة print_r()‎: طباعة معلومات مقروءة من قبل الإنسان حول متغيّر ما.
• الدالة debug_zval_dump()‎: استخلاص تمثيل سلسلة نصّيّة لقيمة zend داخليّة إلى الخرْج.
• الدالة var_export()‎‎: إعادة أو إخراج تمثيل سلسلة نصّيّة قابل للتحليل.
• الدالة debugInfo()‎__.

مصادر

• صفحة الدالة var_dump في توثيق PHP الرسمي.