port

Syntaxe

Paramètres

Description

Ce filtre permet d'extraire le numéro de port d'une URL.

Remarques

• Extraction directe du port depuis une URL complète : Le filtre port permet d'extraire uniquement le numéro de port (exemple : 443 pour HTTPS ou 8080 pour un port personnalisé) depuis une URL complète. Cela peut être utile pour des diagnostics ou des traitements spécifiques à des environnements de développement.
• Très utile pour distinguer les contextes réseau : Ce filtre permet de différencier les URL selon leur port, ce qui est essentiel lorsqu'un site ou une API utilise plusieurs ports pour différentes fonctions (développement, production, test,...). Il permet ainsi d'adapter dynamiquement des comportements selon le port détecté.
• Ne renvoie rien si le port n'est pas spécifié dans l'URL : Si le port utilisé est celui par défaut (80 pour HTTP ou 443 pour HTTPS) et qu'il n'est pas explicitement mentionné dans l'URL, alors le filtre port peut ne rien retourner. Cela peut prêter à confusion si l'on s'attend à toujours recevoir une valeur.
• Complémentaire aux filtres host, path, et scheme : Le filtre port fait partie d'une famille de filtres décomposant une URL en ses différentes composantes. Utilisé avec host, path, query_string ou scheme, il permet de reconstruire ou analyser une URL de manière granulaire.
• Utile pour des affichages conditionnels liés à l'environnement : Dans des cas où des ports spécifiques sont associés à des environnements particuliers (exemple : localhost:3000 pour le développement), ce filtre permet d'afficher dynamiquement un bandeau ou un message selon le port détecté.
• Comportement dépendant de la source de l'URL (exemple : request.url) : Le filtre suppose que l'on passe une URL complète. L'extraction du port n'a de sens que si la variable fournie (comme request.url) contient bien la structure protocole/hôte/port. Sinon, le résultat peut être vide ou erroné.
• Ne réalise pas de validation ni de correction automatique : Si l'URL fournie est mal formée (par exemple une chaîne sans protocole), le filtre ne corrige rien et peut retourner un résultat vide ou inattendu. Il est donc conseillé de valider ou structurer correctement les URLs avant de leur appliquer ce filtre.
• Idéal pour les intégrations avec des systèmes externes ou API : Lorsqu'un site interagit avec plusieurs hôtes ou ports d'une API (exemple pour du load-balancing ou des microservices), le filtre port permet de récupérer dynamiquement l'information de port à des fins de contrôle, d'audit ou d'adaptation des requêtes.