Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages showcasing Symfony with Docker, APIs, queues & async tasks, Webpack, SPAs, etc.

WARNING: You are browsing the documentation for Symfony 3.3 which is not maintained anymore. Consider upgrading your projects to Symfony 5.2.

How to Dump Debug Information in Twig Templates

3.3 version

How to Dump Debug Information in Twig Templates

When using PHP, you can use the dump() function from the VarDumper component if you need to quickly find the value of a variable passed. This is useful, for example, inside your controller:

// src/AppBundle/Controller/ArticleController.php
namespace AppBundle\Controller;

// ...

class ArticleController extends Controller
    public function recentListAction()
        $articles = ...;

        // ...


The output of the dump() function is then rendered in the web developer toolbar.

In a Twig template, you can use the dump utility as a function or a tag:

  • {% dump %} is the way to go when the original template output shall not be modified: variables are not dumped inline, but in the web debug toolbar;
  • on the contrary, {{ dump( }} dumps inline and thus may or not be suited to your use case (e.g. you shouldn’t use it in an HTML attribute or a <script> tag).
{# app/Resources/views/article/recent_list.html.twig #}
{# the contents of this variable are sent to the Web Debug Toolbar #}
{% dump articles %}

{% for article in articles %}
    {# the contents of this variable are displayed on the web page #}
    {{ dump(article) }}

    <a href="/article/{{ article.slug }}">
        {{ article.title }}
{% endfor %}

By design, the dump() function is only available in the dev and test environments, to avoid leaking sensitive information in production. In fact, trying to use the dump() function in the prod environment will result in a PHP error.

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.