]> granicus.if.org Git - apache/blob - docs/manual/filter.xml.fr
mod_reqtimeout: Change the default to set some reasonable timeout values if loaded
[apache] / docs / manual / filter.xml.fr
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 : 1189549 -->
7
8 <!--
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
15
16      http://www.apache.org/licenses/LICENSE-2.0
17
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.
23 -->
24
25 <manualpage metafile="filter.xml.meta">
26
27   <title>Filtres</title>
28
29   <summary>
30     <p>Ce document d&eacute;crit l'utilisation des filtres avec Apache.</p>
31   </summary>
32
33   <section id="intro">
34     <title>Le filtrage avec Apache 2</title>
35     <related>
36       <modulelist>
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>
42         <module>mod_reflector</module>
43         <module>mod_buffer</module>
44         <module>mod_data</module>
45         <module>mod_ratelimit</module>
46         <module>mod_reqtimeout</module>
47         <module>mod_request</module>
48         <module>mod_sed</module>
49         <module>mod_substitute</module>
50         <module>mod_xml2enc</module>
51         <module>mod_proxy_html</module>
52       </modulelist>
53       <directivelist>
54         <directive module="mod_filter">FilterChain</directive>
55         <directive module="mod_filter">FilterDeclare</directive>
56         <directive module="mod_filter">FilterProtocol</directive>
57         <directive module="mod_filter">FilterProvider</directive>
58         <directive module="mod_mime">AddInputFilter</directive>
59         <directive module="mod_mime">AddOutputFilter</directive>
60         <directive module="mod_mime">RemoveInputFilter</directive>
61         <directive module="mod_mime">RemoveOutputFilter</directive>
62         <directive module="mod_reflector">ReflectorHeader</directive>
63         <directive module="mod_ext_filter">ExtFilterDefine</directive>
64         <directive module="mod_ext_filter">ExtFilterOptions</directive>
65         <directive module="core">SetInputFilter</directive>
66         <directive module="core">SetOutputFilter</directive>
67       </directivelist>
68     </related>
69
70 <p>La cha&icirc;ne de filtrage est disponible depuis la version 2.0 d'Apache,
71 et permet aux applications de traiter les donn&eacute;es en entr&eacute;e et en sortie
72 d'une mani&egrave;re hautement flexible et configurable, quelle que soit la
73 provenance de ces donn&eacute;es.  Il est possible de pr&eacute;-traiter les donn&eacute;es
74 en entr&eacute;e, et post-traiter les donn&eacute;es en sortie, comme souhait&eacute;.
75 Ces traitements sont tout &agrave; fait ind&eacute;pendants des traditionnelles phases
76 de traitement des requ&ecirc;tes.</p>
77 <p class="figure">
78 <img src="images/filter_arch.png" width="569" height="392" alt=
79 "les filtres peuvent s'encha&icirc;ner, perpendiculairement au traitement
80 des requ&ecirc;tes"
81 />
82 </p>
83 <p>Voici quelques exemples de filtrage avec la distribution standard d'Apache:</p>
84 <ul>
85 <li><module>mod_include</module>, impl&eacute;mente les inclusions c&ocirc;t&eacute; serveur.</li>
86 <li><module>mod_ssl</module>, impl&eacute;mente le cryptage SSL (https).</li>
87 <li><module>mod_deflate</module>, impl&eacute;mente la compression/d&eacute;compression
88 &agrave; la vol&eacute;e.</li>
89 <li><module>mod_charset_lite</module>, transcodage entre diff&eacute;rents
90 jeux de caract&egrave;res.</li>
91 <li><module>mod_ext_filter</module>, utilisation d'un programme externe
92 comme filtre.</li>
93 </ul>
94 <p>Apache utilise aussi plusieurs filtres en interne pour accomplir des t&acirc;ches
95 comme le d&eacute;coupage des grosses requ&ecirc;tes (chunking) et la gestion des
96 requ&ecirc;tes portant sur une partie d'un fichier (byte-range).</p>
97
98 <p>Un grand choix d'applications sont impl&eacute;ment&eacute;es par des modules de filtrage
99 tiers disponibles &agrave; <a
100 href="http://modules.apache.org/">modules.apache.org</a> entre autres.
101 En voici quelques exemples :</p>
102
103 <ul>
104 <li>Traitement et r&eacute;&eacute;criture HTML et XML</li>
105 <li>Transformations XSLT et inclusions XML (XIncludes)</li>
106 <li>Support de l'espace de nommage XML</li>
107 <li>Gestion du chargement de fichier et d&eacute;codage des formulaires HTML</li>
108 <li>Traitement d'image</li>
109 <li>Protection des applications vuln&eacute;rables comme les scripts PHP</li>
110 <li>Edition de texte par Chercher/Remplacer</li>
111 </ul>
112 </section>
113
114 <section id="smart">
115 <title>Filtrage intelligent</title>
116 <p class="figure">
117 <img src="images/mod_filter_new.png" width="423" height="331"
118 alt="Le filtrage intelligent applique diff&eacute;rents fournisseurs de filtrage en
119 fonction de l'&eacute;tat du traitement de la requ&ecirc;te"/>
120 </p>
121 <p><module>mod_filter</module>, inclus dans les version 2.1 et sup&eacute;rieures
122 d'Apache, permet de configurer la cha&icirc;ne de filtrage dynamiquement
123 &agrave; l'ex&eacute;cution.
124 Ainsi par exemple, vous pouvez d&eacute;finir un proxy pour r&eacute;&eacute;crire du code HTML
125 avec un filtre HTML et traiter des images JPEG avec un filtre totalement
126 s&eacute;par&eacute;, bien que le proxy ne poss&egrave;de aucune information pr&eacute;liminaire
127 sur ce que le serveur &agrave; l'origine des donn&eacute;es &agrave; filtrer va envoyer.
128 Ceci fonctionne gr&acirc;ce &agrave; l'utilisation d'un gestionnaire de filtre,
129 qui distribue les t&acirc;ches &agrave; diff&eacute;rents fournisseurs de filtrage en fonction
130 du contenu r&eacute;el &agrave; filtrer &agrave; l'ex&eacute;cution.  Tout filtre peut se voir soit
131 ins&eacute;r&eacute; directement dans la cha&icirc;ne et lanc&eacute; inconditionnellement, soit
132 utilis&eacute; comme un fournisseur de filtrage et ins&eacute;r&eacute; dynamiquement.
133 Par exemple,</p>
134 <ul>
135 <li>un filtre de traitement HTML sera lanc&eacute; uniquement si le contenu est
136 de type text/html ou application/xhtml+xml</li>
137 <li>Un filtre de compression sera lanc&eacute; uniquement si les donn&eacute;es en entr&eacute;e
138 sont de type compressible et non d&eacute;j&agrave; compress&eacute;es</li>
139 <li>Un filtre de conversion de jeux de caract&egrave;res ne sera ins&eacute;r&eacute; que si
140 le document texte n'est pas d&eacute;j&agrave; dans le jeu de caract&egrave;res voulu</li>
141 </ul>
142 </section>
143
144 <section id="service">
145
146 <title>Pr&eacute;sentation des filtres en tant que service HTTP</title>
147 <p>Les filtres permettent de traiter les contenus en provenance du
148 serveur. Le module <module>mod_reflector</module> permet aussi
149 d'utiliser les filtres pour traiter les contenus en provenance du
150 client.</p>
151
152 <p>Le module <module>mod_reflector</module> re&ccedil;oit les requ&ecirc;tes POST des
153 clients, et en r&eacute;percute le corps dans la requ&ecirc;te POST constituant la
154 r&eacute;ponse, lors de l'envoi de cette derni&egrave;re au client en passant &agrave; travers la
155 pile de filtres en sortie.</p>
156
157 <p>Cette technique peut &ecirc;tre utilis&eacute;e comme alternative &agrave; un service web
158 s'ex&eacute;cutant &agrave; l'int&eacute;rieur de la pile d'un serveur d'applications, o&ugrave; un
159 filtre en sortie effectue la transformation requise sur le corps de la
160 requ&ecirc;te. Par exemple, on peut utiliser le module
161 <module>mod_deflate</module> pour fournir un service g&eacute;n&eacute;ral de
162 compression ; un filtre de transformation d'images peut aussi se voir
163 mu&eacute; en service de transformation d'images.</p>
164
165 </section>
166
167
168 <section id="using">
169 <title>Utilisation des filtres</title>
170 <p>Il y a deux mani&egrave;res d'utiliser le filtrage : Simple et Dynamique.
171 En g&eacute;n&eacute;ral, vous utiliserez l'une ou l'autre m&eacute;thode; le m&eacute;lange des deux
172 peut avoir des cons&eacute;quences inattendues (bien que le filtrage simple en entr&eacute;e
173 puisse &ecirc;tre associ&eacute; sans probl&egrave;me avec le filtrage simple ou dynamique
174 en sortie).</p>
175 <p>La m&eacute;thode Simple est la seule permettant de configurer les filtres
176 en entr&eacute;e, et suffit pour les filtres en sortie pour lesquels vous avez besoin
177 d'une cha&icirc;ne de filtres statique.
178 Les directives correspondantes sont
179     <directive module="core">SetInputFilter</directive>,
180     <directive module="core">SetOutputFilter</directive>,
181     <directive module="mod_mime">AddInputFilter</directive>,
182     <directive module="mod_mime">AddOutputFilter</directive>,
183     <directive module="mod_mime">RemoveInputFilter</directive>, et
184     <directive module="mod_mime">RemoveOutputFilter</directive>.</p>
185
186 <p>La m&eacute;thode Dynamique permet une configuration dynamique des filtres en
187 sortie &agrave; la fois statique et flexible, comme discut&eacute; dans la page
188 <module>mod_filter</module>.
189 Les directives correspondantes sont
190     <directive module="mod_filter">FilterChain</directive>,
191     <directive module="mod_filter">FilterDeclare</directive>, et
192     <directive module="mod_filter">FilterProvider</directive>.</p>
193
194 <p>Une autre directive <directive
195 module="mod_filter">AddOutputFilterByType</directive> est encore support&eacute;e,
196 mais obsol&egrave;te. Utilisez la
197 configuration dynamique &agrave; la place.</p>
198
199   </section>
200 </manualpage>