Filtres

Le filtrage avec Apache 2

Modules Apparent�s	Directives Apparent�es
mod_filter mod_deflate mod_ext_filter mod_include mod_charset_lite	FilterChain FilterDeclare FilterProtocol FilterProvider AddInputFilter AddOutputFilter RemoveInputFilter RemoveOutputFilter 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, 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.