Twig : Les filtres disponibles

Le partage, c’est bien quand c’est utile :

Autant vous le dire tout de suite, je suis tombé littéralement amoureux de Symfony 2. Pratiquant incontesté du MVC et des bonnes pratiques de programmation, je prends particulièrement soin d’utiliser la puissance d’un moteur de template pour bien séparer le code HTML du PHP. Voici un aide mémoire sur la liste de tous les filtres qui sont disponible sous Twig, en espérant que cet anti-séche vous servira autant qu’à moi.

Accès rapide

 

Liste des filtres

Retourner une valeur absolue : abs()

Permet de s’assurer d’avoir l’affichage d’une valeur positive sur sa vue.

Formater une chaîne pour mettre le premier caractère en capitale : capitalize()

Ce filtre peut être utile quand vous voulez absolument que la chaîne de caractère commence par une lettre en capitale.

Modifier l’encodage par un un autre : convert_encoding()

Si vous récupérer une chaîne de caractère avec le mauvais encodage vous pourrez directement modifier cela dans la vue.

Formater l’affichage d’une date : date()

Permet de personnaliser l’affichage d’une date directement dans le code HTML. Ne pas le faire du côté serveur permettra d’optimiser votre code et de ne modifier l’affichage de la date uniquement quand cela est nécessaire.

Modifier la valeur d’une date : date_modify()

Ce filtre se révèle utile si vous devez afficher une période, en effet vous n’aurez qu’une seule variable à fournir au template.

Retourner la valeur par défaut d’une variable si elle est indéfinie ou vide : default()

Déclarer une valeur par défaut, et si la variable est vide (ou indéfinie), c’est cette valeur par défaut qui sera renvoyée.

Échapper une chaîne de caractères : escape()

Utilisez le filtre escape() ou son alias e() permet d’échapper la chaîne de caractère à l’affichage.

Remplacement d’espace(s) réservé(s) : format()

Permet de retourner une chaîne formaté avec un format bien spécifique renseigné lors de l’appel de ce filtre.

Concaténer des éléments avec un séparateur : join()

Très utile lorque vous voulez afficher une liste avec un séparateur provenant d’une séquence.

Retourner la représentation JSON d’une valeur : json_encode()

Ce filtre retourne a représentation JSON d’une valeur tout simplement, très efficace pour la création d’un fichier json.

Retourner les index d’une séquence : keys()

Si vous ne voulez retourner que les index d’un séquence c’est le filtre keys() qu’il faut utiliser sans hésiter.

Compter le nombre d’éléments ou la longueur d’une chaîne de caractères : length()

Encore un filtre bien pratique pour nous éviter de créer une variable côté serveur, elle permet de compter d’élément d’une séquence ou la longueur d’une chaîne de caractères.

Formater une chaîne de caractère en minuscule : lower()

Permet de mettre une chaîne de caractère entièrement en minuscule sans ce soucier de sa forme de départ.

Ajouter des éléments à une séquence : merge()

Permet de rajouter des éléments à la fin d’une séquence, ce filtre reste tout de même rarement utile mais on ne sait jamais !

Insérer un retour à la ligne HTML à chaque nouvelle ligne : nl2br()

Retourne la chaîne de caractère après avoir inséré des saut à la lignes HTML devant toutes les nouvelles lignes.

Formater une valeur pour l’affichage : number_format()

Permet de modifier une valeur à l’affichage en définissant un nombre de décimal, un séparateur pour le point décimal et un séparateur de milliers.

Échapper le contenu d’une variable : raw()

Ce filtre est à utiliser uniquement sur des variables sûr car elle sera échappé à l’affichage.

Remplacer des zones définies par une valeur : replace()

Très proche du filtre format() mais à ne pas confondre, ce filtre permet de remplacer une/des zones définies par une valeur.

Renverser une séquence ou une chaîne de caractère : reverse()

Ce filtre permet de renverser totalement une séquence ou une chaîne de caractères.

Retirer des éléments à une séquence : slice()

Contrairement à merge(), slice permet de retirer des éléments à une séquence.

Trier une séquence et conserve l’association des index : sort()

Permet de trier une séquence mas en ayant l’avanatage de garder l’association des index, ce qui peut se réveler très utile !

Diviser un élément en plusieurs (grâce à un séparateur) : split()

Filtre contraire de join(), il permet de créer une séquence à partir d’éléments séparés entre eux.

Supprimer les balises SGML/XML d’une chaîne : striptags()

Permet de supprimer les balises SGML/XML d’une chaîne de caractères sans pour autant modifier son contenu.

Retourner une chaîne de caractère pré-formaté pour un titre : title()

Ce filtre formate une chaîne de caractère en la mettant en minuscule comme lower() puis en mettant la première lettre de chaque mot en
capitale comme peut le faire capitalize() sur une chaîne entière.

Retirer les caractères vide au début et à la fin d’une chaîne : trim()

Retourne la chaîne en ayant prit soin de retirer les caractères vide placés au début et à la fin de celle ci.

Formater une chaîne de caractère en capitale : upper()

Permet de mettre une chaîne de caractère entièrement en capitale sans ce soucier de sa forme de départ.

Encoder une chaîne en URL : url_encode()

Ce filtre est utile lors de l’encodage d’une chaîne de caractères à utiliser dans la partie d’une URL, c’est une façon simple de passer des variables d’une page à l’autre.

Plus de détails sur la documentation officiel.

Le partage, c’est bien quand c’est utile :