1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
4 <!-- French translation : Lucien GENTIS -->
5 <!-- Reviewed by : Vincent Deffontaines -->
6 <!--English Revision : 659902 -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="filter.xml.meta">
27 <title>Filtres</title>
30 <p>Ce document décrit l'utilisation des filtres avec Apache.</p>
34 <title>Le filtrage avec Apache 2</title>
37 <module>mod_filter</module>
38 <module>mod_deflate</module>
39 <module>mod_ext_filter</module>
40 <module>mod_include</module>
41 <module>mod_charset_lite</module>
44 <directive module="mod_filter">FilterChain</directive>
45 <directive module="mod_filter">FilterDeclare</directive>
46 <directive module="mod_filter">FilterProtocol</directive>
47 <directive module="mod_filter">FilterProvider</directive>
48 <directive module="mod_mime">AddInputFilter</directive>
49 <directive module="mod_mime">AddOutputFilter</directive>
50 <directive module="mod_mime">RemoveInputFilter</directive>
51 <directive module="mod_mime">RemoveOutputFilter</directive>
52 <directive module="mod_ext_filter">ExtFilterDefine</directive>
53 <directive module="mod_ext_filter">ExtFilterOptions</directive>
54 <directive module="core">SetInputFilter</directive>
55 <directive module="core">SetOutputFilter</directive>
59 <p>La chaîne de filtrage est disponible depuis la version 2.0 d'Apache,
60 et permet aux applications de traiter les données en entrée et en sortie
61 d'une manière hautement flexible et configurable, quelle que soit la
62 provenance de ces données. Il est possible de pré-traiter les données
63 en entrée, et post-traiter les données en sortie, comme souhaité.
64 Ces traitements sont tout à fait indépendants des traditionnelles phases
65 de traitement des requêtes.</p>
67 <img src="images/filter_arch.png" width="569" height="392" alt=
68 "les filtres peuvent s'enchaîner, perpendiculairement au traitement
72 <p>Voici quelques exemples de filtrage avec la distribution standard d'Apache:</p>
74 <li><module>mod_include</module>, implémente les inclusions côté serveur.</li>
75 <li><module>mod_ssl</module>, implémente le cryptage SSL (https).</li>
76 <li><module>mod_deflate</module>, implémente la compression/décompression
77 à la volée.</li>
78 <li><module>mod_charset_lite</module>, transcodage entre différents
79 jeux de caractères.</li>
80 <li><module>mod_ext_filter</module>, utilisation d'un programme externe
83 <p>Apache utilise aussi plusieurs filtres en interne pour accomplir des tâches
84 comme le découpage des grosses requêtes (chunking) et la gestion des
85 requêtes portant sur une partie d'un fichier (byte-range).</p>
87 <p>Un grand choix d'applications sont implémentées par des modules de filtrage
88 tiers disponibles à <a
89 href="http://modules.apache.org/">modules.apache.org</a> entre autres.
90 En voici quelques exemples :</p>
93 <li>Traitement et réécriture HTML et XML</li>
94 <li>Transformations XSLT et inclusions XML (XIncludes)</li>
95 <li>Support de l'espace de nommage XML</li>
96 <li>Gestion du chargement de fichier et décodage des formulaires HTML</li>
97 <li>Traitement d'image</li>
98 <li>Protection des applications vulnérables comme les scripts PHP</li>
99 <li>Edition de texte par Chercher/Remplacer</li>
104 <title>Filtrage intelligent</title>
106 <img src="images/mod_filter_new.png" width="423" height="331"
107 alt="Le filtrage intelligent applique différents fournisseurs de filtrage en
108 fonction de l'état du traitement de la requête"/>
110 <p><module>mod_filter</module>, inclus dans les version 2.1 et supérieures
111 d'Apache, permet de configurer la chaîne de filtrage dynamiquement
112 à l'exécution.
113 Ainsi par exemple, vous pouvez définir un proxy pour réécrire du code HTML
114 avec un filtre HTML et traiter des images JPEG avec un filtre totalement
115 séparé, bien que le proxy ne possède aucune information préliminaire
116 sur ce que le serveur à l'origine des données à filtrer va envoyer.
117 Ceci fonctionne grâce à l'utilisation d'un gestionnaire de filtre,
118 qui distribue les tâches à différents fournisseurs de filtrage en fonction
119 du contenu réel à filtrer à l'exécution. Tout filtre peut se voir soit
120 inséré directement dans la chaîne et lancé inconditionnellement, soit
121 utilisé comme un fournisseur de filtrage et inséré dynamiquement.
124 <li>un filtre de traitement HTML sera lancé uniquement si le contenu est
125 de type text/html ou application/xhtml+xml</li>
126 <li>Un filtre de compression sera lancé uniquement si les données en entrée
127 sont de type compressible et non déjà compressées</li>
128 <li>Un filtre de conversion de jeux de caractères ne sera inséré que si
129 le document texte n'est pas déjà dans le jeu de caractères voulu</li>
134 <title>Utilisation des filtres</title>
135 <p>Il y a deux manières d'utiliser le filtrage : Simple et Dynamique.
136 En général, vous utiliserez l'une ou l'autre méthode; le mélange des deux
137 peut avoir des conséquences inattendues (bien que le filtrage simple en entrée
138 puisse être associé sans problème avec le filtrage simple ou dynamique
140 <p>La méthode Simple est la seule permettant de configurer les filtres
141 en entrée, et suffit pour les filtres en sortie pour lesquels vous avez besoin
142 d'une chaîne de filtres statique.
143 Les directives correspondantes sont
144 <directive module="core">SetInputFilter</directive>,
145 <directive module="core">SetOutputFilter</directive>,
146 <directive module="mod_mime">AddInputFilter</directive>,
147 <directive module="mod_mime">AddOutputFilter</directive>,
148 <directive module="mod_mime">RemoveInputFilter</directive>, et
149 <directive module="mod_mime">RemoveOutputFilter</directive>.</p>
151 <p>La méthode Dynamique permet une configuration dynamique des filtres en
152 sortie à la fois statique et flexible, comme discuté dans la page
153 <module>mod_filter</module>.
154 Les directives correspondantes sont
155 <directive module="mod_filter">FilterChain</directive>,
156 <directive module="mod_filter">FilterDeclare</directive>, et
157 <directive module="mod_filter">FilterProvider</directive>.</p>
159 <p>Une autre directive <directive
160 module="core">AddOutputFilterByType</directive> est encore supportée,
161 mais peut poser des problèmes et est maintenant obsolète. Utilisez la
162 configuration dynamique à la place.</p>