الدالة dump في Twig

من موسوعة حسوب
< Twig
مراجعة 14:23، 3 مايو 2021 بواسطة أسامه-دمراني (نقاش | مساهمات) (1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

تهمل دالة 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: السياق الذي يجب إهماله.

انظر أيضًا

المصادر