Filtres

Ce document décrit l'utilisation des filtres avec Apache.

Le filtrage avec Apache 2 mod_filter mod_deflate mod_ext_filter mod_include mod_charset_lite mod_reflector mod_buffer mod_data mod_ratelimit mod_reqtimeout mod_request mod_sed mod_substitute mod_xml2enc mod_proxy_html mod_policy FilterChain FilterDeclare FilterProtocol FilterProvider AddInputFilter AddOutputFilter RemoveInputFilter RemoveOutputFilter ReflectorHeader ExtFilterDefine ExtFilterOptions SetInputFilter SetOutputFilter

La chaîne de filtrage est disponible depuis la version 2.0 d'Apache, et permet aux applications de traiter les données en entrée et en sortie d'une manière hautement flexible et configurable, quelle que soit la provenance de ces données. Il est possible de pré-traiter les données en entrée, et post-traiter les données en sortie, selon vos souhaits. Ces traitements sont tout à fait indépendants des traditionnelles phases de traitement des requêtes.

les filtres peuvent s'enchaîner, perpendiculairement au traitement
des requêtes

Voici quelques exemples de filtrage avec la distribution standard d'Apache:

Apache utilise aussi plusieurs filtres en interne pour accomplir des tâches comme le découpage des grosses requêtes (chunking) et la gestion des requêtes portant sur une partie d'un fichier (byte-range).

Un grand choix d'applications sont implémentées par des modules de filtrage tiers. En voici quelques exemples :

Filtrage intelligent

Le filtrage intelligent applique différents fournisseurs de filtrage en
fonction de l'état du traitement de la requête

mod_filter, inclus dans les version 2.1 et supérieures d'Apache, permet de configurer la chaîne de filtrage dynamiquement à l'exécution. Ainsi par exemple, vous pouvez définir un proxy pour réécrire du code HTML avec un filtre HTML et traiter des images JPEG avec un filtre totalement séparé, bien que le proxy ne possède aucune information préliminaire sur ce que le serveur à l'origine des données à filtrer va envoyer. Ceci fonctionne grâce à l'utilisation d'un gestionnaire de filtre, qui distribue les tâches à différents fournisseurs de filtrage en fonction du contenu réel à filtrer à l'exécution. Tout filtre peut se voir soit inséré directement dans la chaîne et lancé inconditionnellement, soit utilisé comme un fournisseur de filtrage et inséré dynamiquement. Par exemple,

Présentation des filtres en tant que service HTTP

Les filtres permettent de traiter les requêtes des clients avant traitement par le serveur, ainsi que les contenus issus du serveur avant de les renvoyer au client. Le module mod_reflector permet aussi d'utiliser les filtres pour traiter les requêtes des clients avant de les renvoyer directement à ces derniers.

Le module mod_reflector reçoit les requêtes POST des clients, et en répercute le corps dans la requête POST constituant la réponse, lors de l'envoi de cette dernière au client en passant à travers la pile de filtres en sortie.

Cette technique peut être utilisée comme alternative à un service web s'exécutant à l'intérieur de la pile d'un serveur d'applications, où un filtre en sortie effectue la transformation requise sur le corps de la requête. Par exemple, on peut utiliser le module mod_deflate pour fournir un service général de compression ; un filtre de transformation d'images peut aussi se voir mué en service de transformation d'images.

Utilisation des filtres

Il y a deux manières d'utiliser le filtrage : Simple et Dynamique. En général, vous utiliserez l'une ou l'autre méthode; le mélange des deux peut avoir des conséquences inattendues (bien que le filtrage simple en entrée puisse être associé sans problème avec le filtrage simple ou dynamique en sortie).

La méthode Simple est la seule permettant de configurer les filtres en entrée, et suffit pour les filtres en sortie pour lesquels vous avez besoin d'une chaîne de filtres statique. Les directives correspondantes sont SetInputFilter, SetOutputFilter, AddInputFilter, AddOutputFilter, RemoveInputFilter, et RemoveOutputFilter.

La méthode Dynamique permet une configuration dynamique des filtres en sortie à la fois statique et flexible, comme discuté dans la page mod_filter. Les directives correspondantes sont FilterChain, FilterDeclare, et FilterProvider.

Une autre directive AddOutputFilterByType est encore supportée, mais obsolète. Utilisez la configuration dynamique à la place.