الدالة dump في Twig

تهمل دالة dump معلومات عن متغير ما للقالب، وهذا مفيد لتنقيح قالب لا يتصرف كما يجب، من خلال الفحص الداخلي لمتغيراته:

{{ dump(user) }}

لاحظ أن دالة dump غير متاحة افتراضيًا، ويجب إضافة التوسيع ‎\Twig\Extension\DebugExtension صراحة عند إنشاء بيئة Twig الخاصة بك:

$twig = new \Twig\Environment($loader, [
    'debug' => true,
    // ...
]);
$twig->addExtension(new \Twig\Extension\DebugExtension());

لا تعرض دالة dump شيئًا إذا لم يكن الخيار debug مفعلًا على البيئة من أجل تجنب تسريب معلومات التنقيح على خادم الإنتاج (خادم العمل الحقيقي)، وغلِّف الخرج في سياق HTML بوسم pre من أجل تيسير القراءة:

<pre>
    {{ dump(user) }}
</pre>

لاحظ أن استخدام الوسم pre ليس ضروريًا إذا كان XDebug مفعلًا وكان html_errors على الوضع on، بل إن الخرج يكون أفضل عند تفعيل XDebug. ويمكن تنقيح عدة متغيرات بتمريرها كوسائط إضافية:

{{ dump(user, categories) }}

تهمَل جميع المتغيرات من السياق الحالي إذا لم تمرر أي قيمة:

{{ dump() }}

لاحظ أن Twig يستخدم دالة var_dump الخاصة بلغة PHP.

الوسائط

• context: السياق الذي يجب إهماله.

انظر أيضًا

• مقدمة عن محرك القوالب Twig.
• توسيع Twig.
• المكونات الداخلية لـ Twig.
• الوسوم في Twig.
• المرشحات في Twig.
• الدوال في Twig.

المصادر

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