Twig

Informations

Première version	2009
Dernière version	3.22.1 (16 novembre 2025)[1]
Dépôt	github.com/twigphp/Twig
Écrit en	PHP
Système d'exploitation	Multiplateforme (d)
Type	Système de gabarit Bibliothèque PHP (d)
Licence	Licence BSD
Site web	twig.symfony.com

modifier - modifier le code - voir Wikidata (aide)

Twig est un moteur de templates pour le langage de programmation PHP, utilisé par défaut par le framework Symfony.

Il a été inspiré par Jinja, moteur de template Python^[2].

• contrôle de flux complexe
• échappement automatique
• héritage des templates
• filtres variables^[3]
• internationalisation (via gettext)
• macros
• langage extensible^[4].

Supportés par les environnements de développement intégrés tels que^[5] :

• Eclipse
• Komodo
• NetBeans
• PhpStorm (nativement)
• Microsoft Visual Studio

Et les éditeurs de texte :

• Atom
• emacs
• Notepad++
• Sublime Text
• TextMate
• vim

• {{ ... }} : appel à une variable ou une fonction PHP, ou un template Twig parent ({{ parent() }}).
• {# ... #} : commentaires.
• {% ... %} : commande, comme une affectation, une condition, une boucle ou un bloc HTML.
  • {% set foo = 'bar' %} : assignation^[6].
  • {% if i is defined and i == 1 %} ... {% endif %} : condition.
  • {% for i in 0..10 %} ... {% endfor %} : compteur dans une boucle.
• ' : caractère d'échappement.

Pour créer un tableau itératif :

{% set myArray = [1, 2] %}

Un tableau associatif :

{% set myArray = {'key': 'value'} %}

Du moins au plus prioritaire^[7] :

Les filtres fournissent des traitements sur une expression, si on les place après elle séparés par des pipes. Par exemple^[3] :

• capitalize : met une majuscule à la première lettre d'une chaine de caractères.
• upper : met la chaine en lettres capitales.
• first : affiche la première ligne d'un tableau.
• length : renvoie la taille de la variable.

• loop contient les informations de la boucle dans laquelle elle se trouve. Par exemple loop.index donne le nombre d'itérations déjà survenue.
• Les variables globales commencent par des underscores, par exemple :
  • _route (partie de URL située après le domaine)
  • _self (nom de du fichier courant)

  Donc, pour obtenir la route d'une page : {{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')) }}

• Les variables d'environnement CGI, telles que {{ app.request.server.get('SERVER_NAME') }}

Si le fichier "base.html" contient l'en-tête et le pied de page HTML communs à toutes les pages, ces dernières peuvent en hériter avec le mot extends.

{% extends "base.html.twig" %}
{% block navigation %}
    <ul id="navigation">
    {% for item in navigation %}
        <li>
            <a href="{{ item.href }}">
                {% if item.level == 2 %}
                      {{ item.name|upper }}
                {% endif %}
            </a>
        </li>
    {% endfor %}
    </ul>
{% endblock navigation %}

• Portail de la programmation informatique