Les filtres et les fonctions sont des outils essentiels dans Twig pour manipuler les données et exécuter des tâches spécifiques dans les templates. Tandis que les filtres transforment ou formatent les données, les fonctions permettent d’exécuter des opérations plus complexes, comme générer des URL ou déboguer des variables.
Les filtres permettent d’appliquer des transformations à des données. Ils sont particulièrement utiles pour préparer les données destinées à l’affichage. La syntaxe générale d’un filtre est la suivante :
{{ variable|nom_du_filtre }}
{{ 'texte'|nom_du_filtre('paramètre1', 'paramètre2') }}
Plusieurs filtres peuvent être enchaînés :
{{ variable|filtre_1|filtre_2|filtre_3 }}
Table des matières :1 2 Principaux Filtres Twig2.1 a) Filtres pour les chaînes de caractères2.2 2.3 b) Filtres liés à l’échappement2.4 2.5 c) Filtres pour l’encodage3 4 Les Fonctions Twig4.1 a) Twig et le Routage4.2 b) Débogage avec dump5 6 Cas pratiques et astuces6.1 a) Créer des liens dynamiques6.2 b) Inclure du JSON dans un script6.3 c) Travailler avec des encodages multiples7
Principaux Filtres Twig
a) Filtres pour les chaînes de caractères
lower : Convertit une chaîne en minuscules.
{{ 'Bonjour'|lower }} {# Résultat : 'bonjour' #}
upper : Convertit une chaîne en majuscules.
{{ 'Bonjour'|upper }} {# Résultat : 'BONJOUR' #}
title : Met chaque mot en majuscule.
{{ 'le gilet bleu'|title }} {# Résultat : 'Le Gilet Bleu' #}
capitalize : Met la première lettre en majuscule.
{{ 'le gilet bleu'|capitalize }} {# Résultat : 'Le gilet bleu' #}
b) Filtres liés à l’échappement
escape (alias
e
) : Échappe les caractères spéciaux pour éviter les attaques XSS.
{{ '<h1>Titre</h1>'|escape }} {# Résultat : '<h1>Titre</h1>' #}
raw : Affiche une chaîne sans échappement.
{{ '<h1>Titre</h1>'|raw }} {# Résultat : '<h1>Titre</h1>' #}
striptags : Supprime les balises HTML.
{{ '<h1>Titre</h1>'|striptags }} {# Résultat : 'Titre' #}
c) Filtres pour l’encodage
convert_encoding : Change l’encodage d’une chaîne.
{{ texte|convert_encoding('UTF-8', 'ISO-8859-1') }}
json_encode : Convertit un tableau en JSON.
{{ {'cle': 'valeur'}|json_encode }} {# Résultat : '{"cle":"valeur"}' #}
url_encode : Encode une chaîne pour une URL.
{{ 'mot clé'|url_encode }} {# Résultat : 'mot%20clé' #}
Les Fonctions Twig
Les fonctions dans Twig sont similaires aux fonctions en PHP. Elles exécutent des actions spécifiques et retournent une valeur. Voici quelques-unes des fonctions les plus courantes.
a) Twig et le Routage
path : Génère une URL relative vers une route.
<a href="{{ path('ma_route') }}">Visiter ma page</a>
Avec des paramètres :
<a href="{{ path('hello', { 'name': 'world' }) }}">Visiter ma page</a>
url : Génère une URL absolue vers une route (utile pour les e-mails).
<a href="{{ url('ma_route') }}">Visiter ma page</a>
b) Débogage avec dump
Twig propose une fonction dump pour inspecter les variables dans les templates, similaire à
var_dump()
en PHP. Cela est utile pour le débogage.
{{ dump(variable) }}
Cas pratiques et astuces
a) Créer des liens dynamiques
Générer des liens dynamiques basés sur des données :
{% for article in articles %}
<a href="{{ path('article_show', { 'id': article.id }) }}">
{{ article.title }}
</a>
{% endfor %}
b) Inclure du JSON dans un script
Utiliser le filtre
json_encode
pour intégrer des données dans un script JavaScript :
<script>
var options = {{ options|json_encode|raw }};
</script>
c) Travailler avec des encodages multiples
Gérer des données issues de sources externes non UTF-8 :
{{ texte_externe|convert_encoding('UTF-8', 'ISO-8859-1') }}
Documentation officielle Twig - Filtres
Documentation officielle Twig - Fonctions
Cheatsheet Twig
Les filtres et les fonctions dans Twig offrent une grande flexibilité pour manipuler et afficher des données dans vos templates. Qu’il s’agisse de transformer des chaînes, de générer des URL, ou de déboguer vos données, ces outils sont indispensables pour créer des vues dynamiques et maintenables dans Symfony. Leur maîtrise vous permettra d’exploiter tout le potentiel de Twig.