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: 659902 -->
   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       </modulelist>
  43       <directivelist>
  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>
  56       </directivelist>
  57     </related>
  58
  59 <p>La cha&icirc;ne de filtrage est disponible depuis la version 2.0 d'Apache,
  60 et permet aux applications de traiter les donn&eacute;es en entr&eacute;e et en sortie
  61 d'une mani&egrave;re hautement flexible et configurable, quelle que soit la
  62 provenance de ces donn&eacute;es.  Il est possible de pr&eacute;-traiter les donn&eacute;es
  63 en entr&eacute;e, et post-traiter les donn&eacute;es en sortie, comme souhait&eacute;.
  64 Ces traitements sont tout &agrave; fait ind&eacute;pendants des traditionnelles phases
  65 de traitement des requ&ecirc;tes.</p>
  66 <p class="figure">
  67 <img src="images/filter_arch.png" width="569" height="392" alt=
  68 "les filtres peuvent s'encha&icirc;ner, perpendiculairement au traitement
  69 des requ&ecirc;tes"
  70 />
  71 </p>
  72 <p>Voici quelques exemples de filtrage avec la distribution standard d'Apache:</p>
  73 <ul>
  74 <li><module>mod_include</module>, impl&eacute;mente les inclusions c&ocirc;t&eacute; serveur.</li>
  75 <li><module>mod_ssl</module>, impl&eacute;mente le cryptage SSL (https).</li>
  76 <li><module>mod_deflate</module>, impl&eacute;mente la compression/d&eacute;compression
  77 &agrave; la vol&eacute;e.</li>
  78 <li><module>mod_charset_lite</module>, transcodage entre diff&eacute;rents
  79 jeux de caract&egrave;res.</li>
  80 <li><module>mod_ext_filter</module>, utilisation d'un programme externe
  81 comme filtre.</li>
  82 </ul>
  83 <p>Apache utilise aussi plusieurs filtres en interne pour accomplir des t&acirc;ches
  84 comme le d&eacute;coupage des grosses requ&ecirc;tes (chunking) et la gestion des
  85 requ&ecirc;tes portant sur une partie d'un fichier (byte-range).</p>
  86
  87 <p>Un grand choix d'applications sont impl&eacute;ment&eacute;es par des modules de filtrage
  88 tiers disponibles &agrave; <a
  89 href="http://modules.apache.org/">modules.apache.org</a> entre autres.
  90 En voici quelques exemples :</p>
  91
  92 <ul>
  93 <li>Traitement et r&eacute;&eacute;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&eacute;codage des formulaires HTML</li>
  97 <li>Traitement d'image</li>
  98 <li>Protection des applications vuln&eacute;rables comme les scripts PHP</li>
  99 <li>Edition de texte par Chercher/Remplacer</li>
 100 </ul>
 101 </section>
 102
 103 <section id="smart">
 104 <title>Filtrage intelligent</title>
 105 <p class="figure">
 106 <img src="images/mod_filter_new.png" width="423" height="331"
 107 alt="Le filtrage intelligent applique diff&eacute;rents fournisseurs de filtrage en
 108 fonction de l'&eacute;tat du traitement de la requ&ecirc;te"/>
 109 </p>
 110 <p><module>mod_filter</module>, inclus dans les version 2.1 et sup&eacute;rieures
 111 d'Apache, permet de configurer la cha&icirc;ne de filtrage dynamiquement
 112 &agrave; l'ex&eacute;cution.
 113 Ainsi par exemple, vous pouvez d&eacute;finir un proxy pour r&eacute;&eacute;crire du code HTML
 114 avec un filtre HTML et traiter des images JPEG avec un filtre totalement
 115 s&eacute;par&eacute;, bien que le proxy ne poss&egrave;de aucune information pr&eacute;liminaire
 116 sur ce que le serveur &agrave; l'origine des donn&eacute;es &agrave; filtrer va envoyer.
 117 Ceci fonctionne gr&acirc;ce &agrave; l'utilisation d'un gestionnaire de filtre,
 118 qui distribue les t&acirc;ches &agrave; diff&eacute;rents fournisseurs de filtrage en fonction
 119 du contenu r&eacute;el &agrave; filtrer &agrave; l'ex&eacute;cution.  Tout filtre peut se voir soit
 120 ins&eacute;r&eacute; directement dans la cha&icirc;ne et lanc&eacute; inconditionnellement, soit
 121 utilis&eacute; comme un fournisseur de filtrage et ins&eacute;r&eacute; dynamiquement.
 122 Par exemple,</p>
 123 <ul>
 124 <li>un filtre de traitement HTML sera lanc&eacute; uniquement si le contenu est
 125 de type text/html ou application/xhtml+xml</li>
 126 <li>Un filtre de compression sera lanc&eacute; uniquement si les donn&eacute;es en entr&eacute;e
 127 sont de type compressible et non d&eacute;j&agrave; compress&eacute;es</li>
 128 <li>Un filtre de conversion de jeux de caract&egrave;res ne sera ins&eacute;r&eacute; que si
 129 le document texte n'est pas d&eacute;j&agrave; dans le jeu de caract&egrave;res voulu</li>
 130 </ul>
 131 </section>
 132
 133 <section id="using">
 134 <title>Utilisation des filtres</title>
 135 <p>Il y a deux mani&egrave;res d'utiliser le filtrage : Simple et Dynamique.
 136 En g&eacute;n&eacute;ral, vous utiliserez l'une ou l'autre m&eacute;thode; le m&eacute;lange des deux
 137 peut avoir des cons&eacute;quences inattendues (bien que le filtrage simple en entr&eacute;e
 138 puisse &ecirc;tre associ&eacute; sans probl&egrave;me avec le filtrage simple ou dynamique
 139 en sortie).</p>
 140 <p>La m&eacute;thode Simple est la seule permettant de configurer les filtres
 141 en entr&eacute;e, et suffit pour les filtres en sortie pour lesquels vous avez besoin
 142 d'une cha&icirc;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>
 150
 151 <p>La m&eacute;thode Dynamique permet une configuration dynamique des filtres en
 152 sortie &agrave; la fois statique et flexible, comme discut&eacute; 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>
 158
 159 <p>Une autre directive <directive
 160 module="core">AddOutputFilterByType</directive> est encore support&eacute;e,
 161 mais peut poser des probl&egrave;mes et est maintenant obsol&egrave;te. Utilisez la
 162 configuration dynamique &agrave; la place.</p>
 163
 164   </section>
 165 </manualpage>