الدالة dump في Twig
< Twig
اذهب إلى التنقل
اذهب إلى البحث
مراجعة 16:49، 5 مايو 2021 بواسطة جميل-بيلوني (نقاش | مساهمات)
تهمل دالة 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