عرض مصدر Twig/dump

<noinclude>{{DISPLAYTITLE: الدالة dump في Twig}}</noinclude>
تهمل دالة <code>dump</code> معلومات عن متغير ما للقالب، وهذا مفيد لتنقيح قالب لا يتصرف كما يجب، من خلال الفحص الداخلي لمتغيراته:<syntaxhighlight lang="twig">
{{ dump(user) }}
</syntaxhighlight>لاحظ أن دالة <code>dump</code> غير متاحة افتراضيًا، ويجب إضافة التوسعة ‎<code>\Twig\Extension\DebugExtension</code> صراحة عند إنشاء بيئة Twig الخاصة بك:<syntaxhighlight lang="twig">
$twig = new \Twig\Environment($loader, [
    'debug' => true,
    // ...
]);
$twig->addExtension(new \Twig\Extension\DebugExtension());
</syntaxhighlight>لا تعرض دالة <code>dump</code> شيئًا إذا لم يكن الخيار <code>debug</code> مفعلًا على البيئة من أجل تجنب تسريب معلومات التنقيح على خادم الإنتاج (خادم العمل الحقيقي)، وغلِّف الخرج في سياق HTML بوسم <code>pre</code> من أجل تيسير القراءة:<syntaxhighlight lang="twig">
<pre>
    {{ dump(user) }}
</pre>
</syntaxhighlight>لاحظ أن استخدام الوسم <code>pre</code> ليس ضروريًا إذا كان [https://xdebug.org/docs/display XDebug] مفعلًا وكان <code>html_errors</code> على الوضع <code>on</code>، بل إن الخرج يكون أفضل عند تفعيل XDebug. ويمكن تنقيح عدة متغيرات بتمريرها كوسائط إضافية:<syntaxhighlight lang="twig">
{{ dump(user, categories) }}
</syntaxhighlight>تهمَل جميع المتغيرات من السياق الحالي إذا لم تمرر أي قيمة:<syntaxhighlight lang="twig">
{{ dump() }}
</syntaxhighlight>لاحظ أن Twig يستخدم دالة <code>var_dump</code> الخاصة بلغة [[PHP]].

== الوسائط ==

* <code>context</code>: السياق الذي يجب إهماله.

== انظر أيضًا ==
*[[Twig/intro|مقدمة عن محرك القوالب Twig]]
*[[Twig/advanced|توسيع Twig]]
*[[Twig/internals|المكونات الداخلية لـ Twig]]
*[[Twig/tags|الوسوم في Twig]]
*[[ Twig/filters|المرشحات في Twig]]
* [[ Twig/functions|الدوال في Twig]]
== المصادر ==
* [https://twig.symfony.com/doc/3.x/functions/dump.html صفحة توثيق الدالة dump في توثيق Twig الرسمي]

[[تصنيف:Twig]]
[[تصنيف:Twig Functions]]