1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_filter - Serveur Apache HTTP Version 2.4</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.4</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_filter</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_filter.html" title="Franais"> fr </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de configuration de filtre intelligent sensible au
contexte</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">IdentificateurdeModule:</a></th><td>filter_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">FichierSource:</a></th><td>mod_filter.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit:</a></th><td>Versions 2.1 et suprieures</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module permet une configuration intelligente et dpendant du
contexte des filtres de contenu en sortie. Par exemple, Apache peut
tre configur pour faire traiter diffrents types de contenus par
diffrents filtres, mme lorsque le type de contenu n'est pas connu
l'avance (par exemple dans un serveur mandataire).</p>
<p>Le fonctionnement de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> consiste
introduire des branchements dans la chane de filtrage. Plutt que
d'insrer directement des filtres dans la chane, on insre un
slecteur de filtre qui va effectuer un branchement conditionnel
vers un fournisseur de filtre. <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> peut
utiliser tout filtre de contenu comme fournisseur ; aucune
modification des modules de filtrage existants n'est ncessaire
(bien qu'il soit tout de mme possible de les simplifier).</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filterchain">FilterChain</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filterdeclare">FilterDeclare</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filterprotocol">FilterProtocol</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filterprovider">FilterProvider</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filtertrace">FilterTrace</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#smart">Filtrage intelligent</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#terms">Dclarations de filtres, fournisseurs et
chanes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">Configuration de la chane de
filtrage</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#errordocs">Filtrage et statut de la rponse</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#upgrade">Mise jour depuis une configuration du
serveur HTTP Apache 2.2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#protocol">Gestion de protocole</a></li>
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="smart" id="smart">Filtrage intelligent</a></h2>
<p>Dans le modle de filtrage traditionnel, les filtres sont insrs
sans condition l'aide de la directive <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> et des directives
apparentes. Chaque filtre doit ensuite dterminer s'il doit
s'excuter ou non, et les administrateurs du serveur disposent de
peu de souplesse pour faire en sorte que la chane soit traite de
manire dynamique.</p>
<p><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>, l'oppos, fournit aux
administrateurs du serveur un grand degr de souplesse pour
configurer la chane de filtrage. Concrtement, la dcision
d'insrer un filtre peut tre prise en fonction d'une <a href="../expr.html">expression</a> boolenne complexe. Ceci
gnralise le fonctionnement relativement souple de la directive
<code class="directive">AddOutputFilterByType</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="terms" id="terms">Dclarations de filtres, fournisseurs et
chanes</a></h2>
<p class="figure">
<img src="../images/mod_filter_old.gif" width="160" height="310" alt="[Cette image illustre le modle de filtrage traditionnel]" /><br />
<dfn>Figure 1:</dfn> Le modle de filtrage traditionnel</p>
<p>Dans le modle traditionnel, les filtres en sortie constituent
une simple chane s'tendant depuis le gnrateur de contenu (ou
gestionnaire) jusqu'au client. Ce fonctionnement peut convenir s'il
permet d'atteindre le but recherch, mais pose
problme lorsque cette chane doit tre configure dynamiquement en
fonction de la sortie du gestionnaire.</p>
<p class="figure">
<img src="../images/mod_filter_new.gif" width="423" height="331" alt="[Cette image illustre le modle de fonctionnement de mod_filter]" /><br />
<dfn>Figure 2:</dfn> Le modle de fonctionnement de
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></p>
<p>Le fonctionnement de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> consiste
introduire des branchements dans la chane de filtrage. Plutt que
d'insrer directement des filtres dans la chane, on insre un
slecteur de filtre qui va effectuer un branchement conditionnel
vers un fournisseur de filtre. <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> peut
utiliser tout filtre de contenu comme fournisseur ; aucune
modification des modules de filtrage existants n'est ncessaire
(bien qu'il soit tout de mme possible de les simplifier). Il peut y
avoir plusieurs fournisseurs pour un seul filtre, mais un seul
fournisseur sera choisi pour chaque requte.</p>
<p>Une chane de filtrage peut comporter autant d'instances du
slecteur de filtre que l'on souhaite, chacune d'entre elles pouvant
disposer de plusieurs fournisseurs. Un slecteur de filtre possdant
un seul fournisseur dont le choix est inconditionnel constitue un
cas particulier : cette situation est quivalente l'insertion
directe du filtre dans la chane.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">Configuration de la chane de
filtrage</a></h2>
<p>Trois tapes sont ncessaires pour configurer une chane de
filtrage avec <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. Voir ci-dessous la
description dtaille des directives.</p>
<dl>
<dt>Dclaration des filtres</dt>
<dd>La directive <code class="directive"><a href="#filterdeclare">FilterDeclare</a></code> permet de dclarer un
filtre en lui assignant un nom et un type. Elle n'est obligatoire
que si le filtre n'est pas du type par dfaut
AP_FTYPE_RESOURCE.</dd>
<dt>Enregistrement des fournisseurs</dt>
<dd>La directive <code class="directive"><a href="#filterprovider">FilterProvider</a></code> permet d'associer un
fournisseur un filtre. Le filtre a t ventuellement dclar
l'aide de la directive <code class="directive"><a href="#filterdeclare">FilterDeclare</a></code> ; si ce n'est pas le cas, FilterProvider
va le dclarer implicitement avec le type par dfaut
AP_FTYPE_RESOURCE. Le fournisseur doit avoir t enregistr
l'aide de <code>ap_register_output_filter</code> par un module
quelconque. Le dernier argument de la directive <code class="directive"><a href="#filterprovider">FilterProvider</a></code> est une expression :
le fournisseur s'excutera pour une requte si et seulement si
l'expression est value vraie. L'expression peut valuer une
requte HTTP ou les en-ttes de la rponse, des variables
d'environnement, ou le gestionnaire utilis par cette requte. la
diffrence des version prcdentes, mod_filter supporte dsormais
les expressions complexes associant des critres multiples au moyen
d'une logique AND / OR (&& / ||) et de parenthses. Pour les
dtails sur la syntaxe de l'expression, voir la <a href="../expr.html">documentation sur ap_expr</a>.</dd>
<dt>Configuration de la chane de filtrage</dt>
<dd>Les directives ci-dessus permettent d'laborer les lments
d'une chane de filtrage intelligente, mais pas de les configurer en
vue de leur excution. La directive <code class="directive"><a href="#filterchain">FilterChain</a></code> labore une chane de filtrage
partir de filtres intelligents dclars, permettant avec souplesse
d'insrer des filtres au dbut ou la fin de la chane, de
supprimer un filtre ou mme la chane complte.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="errordocs" id="errordocs">Filtrage et statut de la rponse</a></h2>
<p>Normalement, mod_filter n'applique les filtres qu'aux rponses
possdant un statut HTTP 200 (OK). Pour pouvoir filtrer des
documents possdant un autre statut, vous devez dfinir la variable
d'environnement <var>filter-errordocs</var>, les rponses tant
alors filtres sans se proccuper de leur statut. Pour dfinir ce
comportement de manire plus fine, vous pouvez utiliser des
conditions dans la directive
<code class="directive">FilterProvider</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="upgrade" id="upgrade">Mise jour depuis une configuration du
serveur HTTP Apache 2.2</a></h2>
<p>La directive <code class="directive"><a href="#filterprovider">FilterProvider</a></code> a t modifie par
rapport httpd 2.2 : les arguments <var>match</var> et
<var>dispatch</var> ont t remplacs par l'argument unique
<var>expression</var> plus polyvalent. En gnral, il est possible
de convertir une paire match/dispatch vers les deux cts d'une
expression, de la manire suivante :</p>
<div class="example"><p><code>"dispatch = 'match'"</code></p></div>
<p>Les en-ttes de requte et de rponse et les variables
d'environnement sont maintenant interprts selon les syntaxes
respectives <var>%{req:foo}</var>, <var>%{resp:foo}</var> et
<var>%{env:foo}</var>. Les variables <var>%{HANDLER}</var> et
<var>%{CONTENT_TYPE}</var> sont galement supportes.</p>
<p>Notez que l'valuation de l'expression ne supporte plus les
comparaisons de sous-chanes. Ces dernires peuvent
tre remplaces par des comparaisons d'expressions rationnelles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="examples" id="examples">Exemples</a></h2>
<dl>
<dt>Inclusions ct serveur (SSI)</dt>
<dd>Un exemple simple de remplacement de la directive <code class="directive"><a href="../mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code>
<pre class="prettyprint lang-config">FilterDeclare SSI
FilterProvider SSI INCLUDES "%{CONTENT_TYPE} =~ m|^text/html|"
FilterChain SSI</pre>
</dd>
<dt>Inclusions ct serveur (SSI)</dt>
<dd>Mme exemple que ci-dessus, mais envoi vers un gestionnaire
(comportement classique des SSI ; les fichiers .shtml sont
traits).
<pre class="prettyprint lang-config">FilterProvider SSI INCLUDES "%{HANDLER} = 'server-parsed'"
FilterChain SSI</pre>
</dd>
<dt>mulation de mod_gzip avec mod_deflate</dt>
<dd>Insertion du filtre INFLATE seulement si l'en-tte
Accept-Encoding a une valeur autre que "gzip". Ce filtre s'excute
avec le type ftype CONTENT_SET.
<pre class="prettyprint lang-config">FilterDeclare gzip CONTENT_SET
FilterProvider gzip inflate "%{req:Accept-Encoding} !~ /gzip/"
FilterChain gzip</pre>
</dd>
<dt>Diminution de la rsolution d'une image</dt>
<dd>Supposons que nous voulions rduire la rsolution de toutes les
images web, et que nous disposions de filtres pour les images GIF,
JPEG et PNG.
<pre class="prettyprint lang-config">FilterProvider unpack jpeg_unpack "%{CONTENT_TYPE} = 'image/jpeg'"
FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'"
FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'"
FilterProvider downsample downsample_filter "%{CONTENT_TYPE} = m|^image/(jpeg|gif|png)|"
FilterProtocol downsample "change=yes"
FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'"
FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'"
FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'"
<Location /image-filter>
FilterChain unpack downsample repack
</Location></pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="protocol" id="protocol">Gestion de protocole</a></h2>
<p>Historiquement, tout filtre doit s'assurer que toute modification
qu'il effectue est correctement reprsente dans les en-ttes de la
rponse HTTP, et qu'il ne s'excutera pas si cette excution
rsultait en une modification interdite. Ceci impose aux auteurs de
filtres la corve de rimplmenter certaines fonctionnalits
communes dans chaque filtre :</p>
<ul>
<li>De nombreux filtres modifient les contenus, et de ce fait
invalident les balises de ces contenus, leur somme de
contrle, leur condens (hash) existant, ainsi que leur
taille.</li>
<li>Les filtres qui ncessitent une rponse entire et non tronque en
entre, doivent s'assurer qu'il n'ont pas reu une rponse une
requte partielle.</li>
<li>Les filtres qui modifient la sortie d'un autre filtre doivent
s'assurer qu'ils ne violent pas la directive d'un en-tte
<code>Cache-Control: no-transform</code> ventuel.</li>
<li>Les filtres peuvent agir sur des rponses de faon ce qu'elles
ne puissent plus tre mises en cache.</li>
</ul>
<p><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> a pour but de grer de manire
gnrale ces dtails de l'implmentation des filtres, rduisant par
l-mme la complexit des modules de filtrage de contenu. Le
travail permettant d'atteindre ce but est cependant toujours en
cours ; la directive <code class="directive"><a href="#filterprotocol">FilterProtocol</a></code>
implmente certaines de ces fonctionnalits des fins de
compatibilit ascendante avec les modules d'Apache 2.0. Pour les
versions 2.1 et suprieures de httpd, les API
<code>ap_register_output_filter_protocol</code> et
<code>ap_filter_protocol</code> permettent aux modules de filtrage
de dfinir leurs propres comportements.</p>
<p>Cependant, <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> ne doit pas interfrer
avec un filtre qui gre dj tous les aspects du protocole. Par
dfaut (c'est dire en l'absence de toute directive <code class="directive"><a href="#filterprotocol">FilterProtocol</a></code>),
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> ne modifiera donc pas les en-ttes.</p>
<p>Au moment o ces lignes sont crites, cette fonctionnalit a t
trs peu teste, car les modules d'usage courant ont t conus pour
fonctionner avec httpd 2.0. Les modules qui l'utilisent devront donc
l'exprimenter avec prcautions.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigne un filtre en sortie pour un type de mdia
particulier</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilterByType <var>filtre</var>[;<var>filtre</var>...]
<var>type_de_mdia</var> [<var>type_de_mdia</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_filter</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit:</a></th><td>Prsentait de svres limitations avant d'tre dplac dans
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> dans la version 2.3.7</td></tr>
</table>
<p>Cette directive active un <a href="../filter.html">filtre</a> en sortie particulier pour une
requte en fonction du <a class="glossarylink" href="../glossary.html#type de mdia" title="voir glossaire">type de mdia</a> de la rponse.</p>
<p>L'exemple suivant active le filtre <code>DEFLATE</code> qui est
fourni par le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. Il va compresser
toute sortie dont le type MIME est <code>text/html</code> ou
<code>text/plain</code> avant de l'envoyer au client.</p>
<pre class="prettyprint lang-config">AddOutputFilterByType DEFLATE text/html text/plain</pre>
<p>Si vous voulez assigner plusieurs filtres au contenu, leurs noms
doivent tre spars par des points-virgules. On peut aussi utiliser
une directive <code class="directive">AddOutputFilterByType</code> pour
chacun des filtres assigner.</p>
<p>La configuration ci-dessous impose le traitement de toute sortie
de script dont le type MIME est <code>text/html</code> en premier
lieu par le filtre <code>INCLUDES</code>, puis par le filtre
<code>DEFLATE</code>.</p>
<pre class="prettyprint lang-config"><Location /cgi-bin/>
Options Includes
AddOutputFilterByType INCLUDES;DEFLATE text/html
</Location></pre>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
<li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
<li><a href="../filter.html">Les filtres</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FilterChain" id="FilterChain">FilterChain</a> <a name="filterchain" id="filterchain">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure la chane de filtrage</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterChain [+=-@!]<var>nom_filtre</var> <var>...</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_filter</td></tr>
</table>
<p>Cette directive permet de configurer une chane de filtrage
compose de filtres dclars. <code class="directive">FilterChain</code>
accepte un nombre illimit d'arguments, chacun d'entre eux tant
prcd d'un caractre de contrle unique qui dtermine l'action
entreprendre :</p>
<dl>
<dt><code>+<var>nom filtre</var></code></dt>
<dd>Ajoute<var>nom filtre</var> la fin de la chane de filtrage</dd>
<dt><code>@<var>nom filtre</var></code></dt>
<dd>Ajoute <var>nom filtre</var> au dbut de la chane de filtrage</dd>
<dt><code>-<var>nom filtre</var></code></dt>
<dd>Supprime <var>nom filtre</var> de la chane de filtrage</dd>
<dt><code>=<var>nom filtre</var></code></dt>
<dd>Supprime tous les filtres de la chane de filtrage existante et
les remplace par <var>nom filtre</var></dd>
<dt><code>!</code></dt>
<dd>Supprime tous les filtres de la chane de filtrage existante</dd>
<dt><code><var>nom filtre</var></code></dt>
<dd>quivalent <code>+<var>nom filtre</var></code></dd>
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FilterDeclare" id="FilterDeclare">FilterDeclare</a> <a name="filterdeclare" id="filterdeclare">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dclare un filtre intelligent</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterDeclare <var>nom_filtre</var> <var>[type]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_filter</td></tr>
</table>
<p>Cette directive permet de dclarer un filtre en sortie associ
un en-tte ou une variable d'environnement qui dterminera les
conditions de son excution. Le premier argument est le <var>nom du
filtre</var> destin tre utilis dans les directives <code class="directive"><a href="#filterprovider">FilterProvider</a></code>, <code class="directive"><a href="#filterchain">FilterChain</a></code> et <code class="directive"><a href="#filterprotocol">FilterProtocol</a></code>.</p>
<p>Le dernier argument (optionnel) est le type du filtre, et peut
prendre les valeurs de <code>ap_filter_type</code>, savoir
<code>RESOURCE</code> (valeur par dfaut), <code>CONTENT_SET</code>,
<code>PROTOCOL</code>, <code>TRANSCODE</code>,
<code>CONNECTION</code> ou <code>NETWORK</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FilterProtocol" id="FilterProtocol">FilterProtocol</a> <a name="filterprotocol" id="filterprotocol">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vrifie le respect du protocole HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterProtocol <var>nom_filtre</var> [<var>nom_fournisseur</var>]
<var>drapeaux_protocole</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_filter</td></tr>
</table>
<p>Cette directive permet <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> de s'assurer
qu'un filtre ne s'excutera pas s'il ne doit pas le faire, et que
les en-ttes de la rponse HTTP sont dfinis correctement en tenant
compte des effets du filtre.</p>
<p>Cette directive se prsente sous deux formes. Avec trois
arguments, elle s'applique de manire spcifique un <var>nom
filtre</var> et un <var>nom fournisseur</var> pour ce filtre. Avec
deux arguments, elle s'applique un <var>nom filtre</var> pour
<em>tout</em> fournisseur qu'il actionne.</p>
<p>Les drapeaux spcifis sont fusionns avec les drapeaux que les
fournisseurs sous-jacents ont ventuellement enregistrs avec
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. Par exemple, un filtre peut avoir
spcifi en interne un drapeau quivalent <code>change=yes</code>,
mais une configuration particulire du module peut le surcharger
en spcifiant <code>change=no</code>.
</p>
<p><var>drapeaux_protocole</var> peut contenir un ou plusieurs
drapeaux parmi les suivants :</p>
<dl>
<dt><code>change=yes|no</code></dt>
<dd>Indique si le filtre doit modifier le contenu, y compris ventuellement sa
taille</dd>
<dt><code>change=1:1</code></dt>
<dd>Le filtre modifie le contenu, mais pas sa taille</dd>
<dt><code>byteranges=no</code></dt>
<dd>Le filtre ne peut pas traiter de rponses des sous-requtes et
ncessite des rponses compltes en entre</dd>
<dt><code>proxy=no</code></dt>
<dd>Le filtre ne doit pas s'excuter dans un contexte de mandataire</dd>
<dt><code>proxy=transform</code></dt>
<dd>Le filtre transforme la rponse de manire incompatible avec
l'en-tte HTTP <code>Cache-Control: no-transform</code></dd>
<dt><code>cache=no</code></dt>
<dd>Le filtre fait en sorte que la sortie ne puisse pas tre mise en
cache (par exemple en introduisant des modifications de contenu
alatoires)</dd>
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FilterProvider" id="FilterProvider">FilterProvider</a> <a name="filterprovider" id="filterprovider">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre un filtre de contenu</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterProvider <var>nom_filtre</var> <var>nom_fournisseur</var>
<var>expression</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_filter</td></tr>
</table>
<p>Cette directive permet d'associer un <em>fournisseur</em> au
filtre intelligent. Le fournisseur sera invoqu si et seulement si
l'<var>expression</var> est value vraie lorsque le slecteur de
filtre est appel pour la premire fois.</p>
<p>
<var>nom fournisseur</var> doit avoir t enregistr au cours du
chargement d'un module l'aide de
<code>ap_register_output_filter</code>.
</p>
<p><var>expression</var> est une expression <a href="../expr.html">ap_expr</a>.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="../expr.html">Les expressions dans le serveur HTTP
Apache</a>, pour une rfrence complte et d'autres exemples.</li>
<li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FilterTrace" id="FilterTrace">FilterTrace</a> <a name="filtertrace" id="filtertrace">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Obtention d'informations de dbogage/diagnostique en
provenance de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterTrace <var>nom_filtre</var> <var>niveau</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_filter</td></tr>
</table>
<p>Cette directive permet d'obtenir des informations de dbogage en
provenance de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. Elle est conue pour
aider tester et dboguer les fournisseurs (ou modules de filtrage)
; elle peut aussi apporter une aide l'utilisation de
<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> lui-mme.</p>
<p>La sortie de dbogage dpend de la dfinition d'argument
<var>level</var> :</p>
<dl>
<dt><code>0</code> (valeur par dfaut)</dt>
<dd>Aucune information de dbogage n'est gnre.</dd>
<dt><code>1</code></dt>
<dd><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> va enregistrer les ensembles de
conteneurs de donnes (buckets and brigades) qui traversent le
filtre dans le journal des erreurs, avant que le fournisseur ne les
traite. Ces informations sont similaires celles gnres par <a href="http://apache.webthing.com/mod_diagnostics/">mod_diagnostics</a>.
</dd>
<dt><code>2</code> (pas encore implment)</dt>
<dd>Ce niveau permettra d'enregistrer l'ensemble des donnes qui
traversent le filtre dans un fichier temporaire avant de les envoyer
au fournisseur. <strong>Pour un dbogage mono-utilisateur
seulement</strong> ; l'enregistrement des donnes concernant
plusieurs requtes simultannes ne sera pas support.</dd>
</dl>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_filter.html" title="Franais"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_filter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
|
