url_escape |
Échappement URL |
| Liquid (Microsoft) |
Syntaxe
|
{{ string | url_escape }}
|
Paramètres
| Nom |
Description |
| string |
Ce paramètre permet d'indiquer la chaîne de caractères qui doit être encodée pour être sûre et valide dans une URL, en appliquant le codage par pourcentage (percent-encoding). |
Description
Ce filtre permet d'échapper une chaîne pour qu'elle soit sûre dans une URL (percent-encoding).
Remarques
- Encodage sécurisé pour les URL : Le filtre url_escape applique le codage par pourcentage (percent-encoding) sur une chaîne de caractères. Cela signifie
que les caractères spéciaux (espaces, accents, symboles) sont transformés en codes valides dans une URL, ce qui garantit que la chaîne ne brise pas la structure de
l'adresse.
- Indispensable pour générer des liens dynamiques : Lorsqu'une URL est construite dynamiquement avec des variables utilisateurs (exemple nom, titre,
recherche), l'utilisation de url_escape est essentielle pour éviter les erreurs ou les comportements imprévus, comme un lien qui ne fonctionne pas ou qui se casse.
- Convertit les caractères non alphanumériques : Les caractères comme l'espace ( ), l'esperluette (&), le point d'interrogation (?) ou le dièse (#) sont
encodés en %20, %26, %3F, %23,... Cela permet d'intégrer des données utilisateur dans des URL sans conflit avec la syntaxe des adresses web.
- Améliore la compatibilité inter-navigateurs : Sans encodage, certaines URL contenant des caractères spéciaux peuvent mal se comporter dans certains
navigateurs ou systèmes. En appliquant url_escape, on assure une meilleure compatibilité et portabilité des liens générés.
- Particulièrement utile avec les formulaires et les requêtes GET : Lorsque des valeurs saisies dans un formulaire sont utilisées dans une requête
GET (exemple ?query=valeur), url_escape permet d'éviter que des caractères spéciaux perturbent les paramètres ou la structure
de la requête.
- Préserve l'intention originale de la donnée : Même si le résultat encodé semble illisible pour un humain (Café crème devient Caf%C3%A9%20cr%C3%A8me), le
filtre préserve la signification exacte de la donnée côté navigateur ou serveur lors de son traitement.
- Ne doit pas être utilisé deux fois : Il est important de ne pas appliquer deux fois url_escape sur une même chaîne, car cela entraînerait un double
encodage (% devient %25, etc.), ce qui fausserait complètement le résultat final et rendrait l'URL invalide ou erronée.
- Inverse possible avec url_decode (si disponible) : Bien que url_escape soit unidirectionnel (il encode), il existe parfois un filtre complémentaire
url_decode pouvant restaurer la chaîne d'origine depuis une URL encodée. Cela est utile pour afficher une valeur lisible à partir d'une URL.
Dernière mise à jour : Jeudi, le 24 Juillet 2025