L’article explique comment utiliser les macros Twig dans Symfony, des fragments réutilisables similaires à des fonctions, avec des arguments optionnels et une gestion flexible des paramètres surnuméraires. Il détaille trois méthodes d’importation (via import, from ou _self) et souligne leur impact sur la lisibilité et la portée des macros.

Le piège principal réside dans la portée limitée des macros : elles n’ont pas accès aux variables du template appelant, ce qui peut causer des bugs silencieux comme des conditions toujours fausses. L’auteur illustre ce problème avec un exemple où une variable current_route n’est pas visible dans la macro, entraînant un rendu incorrect.

Enfin, l’article recommande de remplacer les macros par des Twig Components dans les projets modernes, plus adaptés pour éviter ces écueils et optimiser la maintenance des templates Symfony.