filter.xml.fr revision a0e549fa035cea0147cb7700d1a814c8088676fd
<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- English Revision: 105989 -->
<!--
Copyright 2002-2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="filter.xml.meta">
<title>Filtres</title>
<summary>
<p>Ce document explique le fonctionnement des filtres avec Apache.</p>
</summary>
<section id="filters">
<title>Filtres</title>
<related>
<modulelist>
<module>mod_deflate</module>
<module>mod_ext_filter</module>
<module>mod_include</module>
</modulelist>
<directivelist>
<directive module="mod_mime">AddInputFilter</directive>
<directive module="mod_mime">AddOutputFilter</directive>
<directive module="mod_mime">RemoveInputFilter</directive>
<directive module="mod_mime">RemoveOutputFilter</directive>
<directive module="mod_ext_filter">ExtFilterDefine</directive>
<directive module="mod_ext_filter">ExtFilterOptions</directive>
<directive module="core">SetInputFilter</directive>
<directive module="core">SetOutputFilter</directive>
</directivelist>
</related>
<p>On appelle <em>filtre</em> un processus qui s'applique aux données reçues
ou envoyées par le serveur. Les <em>filtres en entrée ("input filters")</em>
servent à filtrer les données envoyées par les clients au serveur, tandis
que les <em>filtres en sortie ("output filters")</em> travaillent sur les
données envoyées par le serveur à un client. Il est possible d'appliquer
plusieurs filtres à un flux de données, et l'ordre de ces filtres peux être
spécifiée de façon explicite.</p>
<p>Apache utilise des filtres en interne pour par exemple gérer les "grosses" requêtes
(chunked) ou les requêtes partielles (NDT : "byte-range" : requêtes sur seulement une
partie d'un fichier spécifiée par un pointeur de départ, et de fin).
Certains modules permettent en plus d'utiliser des filtres
en utilisant des directives de configuration. Les filtres sont utilisables
au moyen des directives
<directive module="core">SetInputFilter</directive>,
<directive module="core">SetOutputFilter</directive>,
<directive module="mod_mime">AddInputFilter</directive>,
<directive module="mod_mime">AddOutputFilter</directive>,
<directive module="mod_mime">RemoveInputFilter</directive> et
<directive module="mod_mime">RemoveOutputFilter</directive>
.</p>
<p>Les filtres listés ci-dessous sont fournis dans la distribution d'Apache, et
peuvent être utilisés par tout administrateur.</p>
<dl>
<dt>INCLUDES</dt>
<dd>Le module <module>mod_include</module> travaille au moyen de
"Server-Side Includes"</dd>
<dt>DEFLATE</dt>
<dd>Le module <module>mod_deflate</module> compresse les données avant leur envoi au
client (filtre en sortie).</dd>
</dl>
<p>En outre, le module <module>mod_ext_filter</module> permet d'utiliser des
programes externes à Apache en tant que filtres.</p>
</section>
</manualpage>