Code sur écran d'ordinateur

Symfony – déboguer un template Twig avec dump()

La fonction {{ dump() }} de Twig est très pratique pour inspecter une variable dans un template. Mais sans le bon paquet installé, le rendu est illisible. Voici comment obtenir un affichage propre et pliable comme celui-ci :

Rendu de la fonction dump() de Twig avec le DebugBundle de Symfony

Installer le DebugBundle

Le rendu soigné vient du composant VarDumper de Symfony, activé par le DebugBundle. Installez-le en dépendance de développement :

composer require --dev symfony/debug-bundle

Avec Symfony Flex, l’alias debug fonctionne aussi :

composer require --dev debug

Utilisation dans un template

Deux syntaxes sont disponibles :

{# affiche le contenu d'une variable #}
{{ dump(user) }}

{# ou, sous forme de balise, plusieurs variables à la fois #}
{% dump user, articles %}

Bon à savoir

Comme le bundle est installé en --dev, la fonction dump() ne produit rien en production : aucun risque de laisser fuiter des données si un appel traîne dans un template.

À lire aussi