dump
New in version 1.5: The dump
function was added in Twig 1.5.
The dump
function dumps information about a template variable. This is mostly useful to debug a template that does not behave as expected by introspecting its variables:
{{ dump(user) }}
Note
The dump
function is not available by default. You must add the \Twig\Extension\DebugExtension
extension explicitly when creating your Twig environment:
$twig = new \Twig\Environment($loader, [
'debug' => true,
// ...
]);
$twig->addExtension(new \Twig\Extension\DebugExtension());
Even when enabled, the dump
function won’t display anything if the debug
option on the environment is not enabled (to avoid leaking debug information on a production server).
In an HTML context, wrap the output with a pre
tag to make it easier to read:
<pre>
{{ dump(user) }}
</pre>
Tip
Using a pre
tag is not needed when XDebug is enabled and html_errors
is on
; as a bonus, the output is also nicer with XDebug enabled.
You can debug several variables by passing them as additional arguments:
{{ dump(user, categories) }}
If you don’t pass any value, all variables from the current context are dumped:
{{ dump() }}
Note
Internally, Twig uses the PHP var_dump function.
Arguments
-
context
: The context to dump
© 2009–2018 by the Twig Team
Licensed under the three clause BSD license.
The Twig logo is © 2010–2020 Symfony
https://twig.symfony.com/doc/1.x/functions/dump.html