Manuel Apache
Filtres
Ce document décrit l'utilisation des filtres avec Apache.
Le filtrage avec Apache 2
| Modules Apparentés | Directives Apparentées |
|---|---|
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, comme souhaité. Ces traitements sont tout à fait indépendants des traditionnelles phases de traitement des requêtes.
Voici quelques exemples de filtrage avec la distribution standard d'Apache:
mod_include, implémente les inclusions côté serveur.mod_ssl, implémente le cryptage SSL (https).mod_deflate, implémente la compression/décompression à la volée.mod_charset_lite, transcodage entre différents jeux de caractères.mod_ext_filter, utilisation d'un programme externe comme filtre.
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 disponibles à modules.apache.org entre autres. En voici quelques exemples :
- Traitement et réécriture HTML et XML
- Transformations XSLT et inclusions XML (XIncludes)
- Support de l'espace de nommage XML
- Gestion du chargement de fichier et décodage des formulaires HTML
- Traitement d'image
- Protection des applications vulnérables comme les scripts PHP
- Edition de texte par Chercher/Remplacer
Filtrage intelligent
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,
- un filtre de traitement HTML sera lancé uniquement si le contenu est de type text/html ou application/xhtml+xml
- Un filtre de compression sera lancé uniquement si les données en entrée sont de type compressible et non déjà compressées
- Un filtre de conversion de jeux de caractères ne sera inséré que si le document texte n'est pas déjà dans le jeu de caractères voulu
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 peut poser des problèmes et est maintenant obsolète. Utilisez la configuration dynamique à la place.
Remonter 
