granicus.if.org Git - apache/blob - docs/manual/mod/mod_deflate.html.fr.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
   4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_deflate - Serveur HTTP Apache Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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>
  21 <p class="apache">Serveur HTTP Apache Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Module Apache mod_deflate</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_deflate.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_deflate.html" title="Français">&nbsp;fr&nbsp;</a> |
  31 <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  32 <a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  33 </div>
  34 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
  35             anglaise pour les changements récents.</div>
  36 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Comprime le contenu avant de le servir au
  37 client</td></tr>
  38 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  39 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>deflate_module</td></tr>
  40 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_deflate.c</td></tr></table>
  41 <h3>Sommaire</h3>
  42
  43     <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> implémente le filtre de
  44     sortie <code>DEFLATE</code> qui permet de comprimer la sortie de
  45     votre serveur avant de l'envoyer au client sur le réseau.</p>
  46 </div>
  47 <div id="quickview"><h3>Sujets</h3>
  48 <ul id="topics">
  49 <li><img alt="" src="../images/down.gif" /> <a href="#supportedencodings">Codages supportés</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#recommended">Exemples de configurations</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation de la compression</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#proxies">Prise en compte des serveurs mandataires</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#precompressed">Servir du contenu précompressé</a></li>
  54 </ul><h3 class="directives">Directives</h3>
  55 <ul id="toc">
  56 <li><img alt="" src="../images/down.gif" /> <a href="#deflatealteretag">DeflateAlterETag</a></li>
  57 <li><img alt="" src="../images/down.gif" /> <a href="#deflatebuffersize">DeflateBufferSize</a></li>
  58 <li><img alt="" src="../images/down.gif" /> <a href="#deflatecompressionlevel">DeflateCompressionLevel</a></li>
  59 <li><img alt="" src="../images/down.gif" /> <a href="#deflatefilternote">DeflateFilterNote</a></li>
  60 <li><img alt="" src="../images/down.gif" /> <a href="#deflateinflatelimitrequestbody">DeflateInflateLimitRequestBody</a></li>
  61 <li><img alt="" src="../images/down.gif" /> <a href="#deflateinflateratioburst">DeflateInflateRatioBurst</a></li>
  62 <li><img alt="" src="../images/down.gif" /> <a href="#deflateinflateratiolimit">DeflateInflateRatioLimit</a></li>
  63 <li><img alt="" src="../images/down.gif" /> <a href="#deflatememlevel">DeflateMemLevel</a></li>
  64 <li><img alt="" src="../images/down.gif" /> <a href="#deflatewindowsize">DeflateWindowSize</a></li>
  65 </ul>
  66 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_deflate">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_deflate">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
  67 <ul class="seealso">
  68 <li><a href="../filter.html">Les filtres</a></li>
  69 <li><a href="#comments_section">Commentaires</a></li></ul></div>
  70 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  71 <div class="section">
  72 <h2><a name="supportedencodings" id="supportedencodings">Codages supportés</a> <a title="Lien permanent" href="#supportedencodings" class="permalink">&para;</a></h2>
  73   <p>Le seul codage supporté est <code>gzip</code> afin d'assurer une complète
  74   compatibilité avec les anciens navigateurs. Le codage <code>deflate</code>
  75   n'est donc pas supporté ; voir à ce sujet la <a href="http://www.gzip.org/zlib/zlib_faq.html#faq38">documentation de zlib</a>
  76   pour une explication détaillée.
  77   </p>
  78 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  79 <div class="section">
  80 <h2><a name="recommended" id="recommended">Exemples de configurations</a> <a title="Lien permanent" href="#recommended" class="permalink">&para;</a></h2>
  81     <div class="warning"><h3>Compression et TLS</h3>
  82         <p>Certaines applications web sont vulnérables à une attaque pour
  83         vol d'informations lorsqu'une connexion TLS transporte des
  84         données compressées par deflate. Pour plus de détails,
  85         documentez-vous sur la famille d'attaques "BREACH".</p>
  86     </div>
  87     <p>Voici un exemple simple de configuration qui permet de comprimer
  88     les types de contenu à base de texte.</p>
  89
  90     <div class="example"><h3>Ne comprime que certains types de documents</h3><pre class="prettyprint lang-config">AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript</pre>
  91 </div>
  92
  93 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  94 <div class="section">
  95 <h2><a name="enable" id="enable">Activation de la compression</a> <a title="Lien permanent" href="#enable" class="permalink">&para;</a></h2>
  96     <div class="warning"><h3>Compression et TLS</h3>
  97         <p>Certaines applications web sont vulnérables à une attaque pour
  98         vol d'informations lorsqu'une connexion TLS transporte des
  99         données compressées par deflate. Pour plus de détails,
 100         documentez-vous sur la famille d'attaques "BREACH".</p>
 101     </div>
 102
 103     <h3><a name="output" id="output">Compression de la sortie</a></h3>
 104       <p>La compression est implémentée par le <a href="../filter.html">filtre</a> <code>DEFLATE</code>. La
 105       directive suivante active la compression des documents dans le
 106       conteneur où elle est placée :</p>
 107
 108       <pre class="prettyprint lang-config">SetOutputFilter DEFLATE
 109 SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre>
 110
 111
 112       <p>Si vous voulez limiter la compression à certains types MIME
 113       particuliers, vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>. Voici un exemple
 114       où la compression n'est activée que pour les fichiers html de la
 115       documentation d'Apache :</p>
 116
 117       <pre class="prettyprint lang-config">&lt;Directory "/your-server-root/manual"&gt;
 118     AddOutputFilterByType DEFLATE text/html
 119 &lt;/Directory&gt;</pre>
 120
 121
 122       <div class="note"><h3>Note</h3>
 123         Le filtre <code>DEFLATE</code> est toujours inséré après les
 124         filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les
 125         sous-requêtes internes.
 126       </div>
 127       <div class="note"><h3>Note</h3>
 128         La variable d'environnement <code>force-gzip</code>, définie à
 129         l'aide de la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>, permet d'ignorer la
 130         configuration de votre navigateur quant aux codages acceptés, et
 131         d'envoyer sans condition une sortie comprimée.
 132       </div>
 133
 134
 135     <h3><a name="inflate" id="inflate">Décompression de la sortie</a></h3>
 136       <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit aussi un filtre
 137       permettant de décomprimer un corps de réponse comprimé par gzip.
 138       Pour activer cette fonctionnalité, vous devez insérer le filtre
 139       <code>INFLATE</code> dans la chaîne de filtrage en sortie via la
 140       directive <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> ou
 141       <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, comme
 142       dans l'exemple suivant :</p>
 143
 144       <pre class="prettyprint lang-config">&lt;Location "/dav-area"&gt;
 145     ProxyPass "http://example.com/"
 146     SetOutputFilter INFLATE
 147 &lt;/Location&gt;</pre>
 148
 149
 150       <p>Dans cet exemple, les sorties comprimées par gzip en
 151       provenance de example.com seront décomprimées afin de pouvoir
 152       être éventuellement traitées par d'autres filtres.
 153       </p>
 154
 155
 156     <h3><a name="input" id="input">Décompression de l'entrée</a></h3>
 157       <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit également un filtre
 158       permettant de décomprimer un corps de requête comprimé par gzip.
 159       Pour activer cette fonctionnalité, vous devez insérer le filtre
 160       <code>DEFLATE</code> dans la chaîne de filtrage en entrée via la
 161       directive <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code> ou
 162       <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, comme
 163       dans l'exemple suivant :</p>
 164
 165       <pre class="prettyprint lang-config">&lt;Location "/dav-area"&gt;
 166     SetInputFilter DEFLATE
 167 &lt;/Location&gt;</pre>
 168
 169
 170       <p>Désormais, si une requête contient un en-tête
 171       <code>Content-Encoding: gzip</code>, son corps sera
 172       automatiquement décomprimé. Peu de navigateurs sont actuellement
 173       en mesure de comprimer les corps de requêtes. Cependant,
 174       certaines applications spécialisées supportent les requêtes
 175       comprimées, comme par exemple certains clients <a href="http://www.webdav.org">WebDAV</a>.</p>
 176
 177       <div class="warning"><h3>Note à propos de l'en-tête
 178       <code>Content-Length</code></h3>
 179         <p>Si vous évaluez vous-même la taille du corps de requête,
 180         <em>ne faites pas confiance à l'en-tête
 181         <code>Content-Length</code>!</em> L'en-tête
 182         Content-Length indique la longueur des données en provenance du
 183         client, et <em>non</em> la quantité d'octets que représente le
 184         flux de données décompressé.</p>
 185       </div>
 186
 187 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 188 <div class="section">
 189 <h2><a name="proxies" id="proxies">Prise en compte des serveurs mandataires</a> <a title="Lien permanent" href="#proxies" class="permalink">&para;</a></h2>
 190
 191     <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> envoie un en-tête de
 192     réponse HTTP <code>Vary: Accept-Encoding</code> pour avertir les
 193     mandataires qu'une réponse enregistrée dans le cache ne doit être
 194     envoyée qu'aux clients qui ont envoyé l'en-tête de requête
 195     <code>Accept-Encoding</code> approprié. Ceci permet d'éviter l'envoi
 196     d'un contenu comprimé à un client qui ne sera pas en mesure
 197     de l'interpréter.</p>
 198
 199     <p>Si vous avez défini des exclusions spécifiques dépendant, par
 200     exemple, de l'en-tête <code>User-Agent</code>, vous devez
 201     ajouter manuellement des données à l'en-tête <code>Vary</code> afin
 202     d'informer les mandataires des restrictions supplémentaires. Par
 203     exemple, dans la configuration classique où l'addition du filtre
 204     <code>DEFLATE</code> dépend du contenu de l'en-tête
 205     <code>User-Agent</code>, vous devez spécifier :</p>
 206
 207     <pre class="prettyprint lang-config">Header append Vary User-Agent</pre>
 208
 209
 210     <p>Si votre décision de comprimer le contenu dépend d'autres
 211     informations que celles contenues dans les en-têtes de la requête
 212     (par exemple la version HTTP), vous devez attribuer à l'en-tête
 213     <code>Vary</code> la valeur <code>*</code>, ce qui permet d'empêcher
 214     les mandataires compatibles de tout mettre en cache.</p>
 215
 216     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">Header set Vary *</pre>
 217 </div>
 218 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 219 <div class="section">
 220 <h2><a name="precompressed" id="precompressed">Servir du contenu précompressé</a> <a title="Lien permanent" href="#precompressed" class="permalink">&para;</a></h2>
 221
 222     <p>Comme <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> recompresse le contenu demandé à
 223     chaque requête, il est possible de gagner en performances en
 224     précompressant ce contenu, et en forçant mod_deflate à servir ce
 225     contenu précompressé sans avoir à le recompresser à chaque requête.
 226     Pour ce faire, utilisez une configuration du style :</p>
 227
 228     <pre class="prettyprint lang-config">&lt;IfModule mod_headers.c&gt;
 229     # Servir des fichiers JS et CSS compressés avec gzip, s'ils existent, et
 230     # si le client accepte gzip.
 231     RewriteCond "%{HTTP:Accept-encoding}" "gzip"
 232     RewriteCond "%{REQUEST_FILENAME}\.gz" "-s"
 233     RewriteRule "^(.*)\.(css|js)"              "$1\.$2\.gz" [QSA]
 234
 235     # Servir des types de contenus corrects, et empêcher mod_deflate
 236     # d'effectuer un double gzip.
 237     RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1]
 238     RewriteRule "\.js\.gz$"  "-" [T=text/javascript,E=no-gzip:1]
 239
 240
 241     &lt;FilesMatch "(\.js\.gz|\.css\.gz)$"&gt;
 242       # Servir le type de codage correct.
 243       Header append Content-Encoding gzip
 244
 245       # Force les mandataires à mettre en cache séparément les fichiers
 246       # css/js gzippés &amp; non gzippés.
 247       Header append Vary Accept-Encoding
 248     &lt;/FilesMatch&gt;
 249 &lt;/IfModule&gt;</pre>
 250
 251
 252 </div>
 253 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 254 <div class="directive-section"><h2><a name="deflatealteretag" id="deflatealteretag">Directive</a> <a name="DeflateAlterETag" id="DeflateAlterETag">DeflateAlterETag</a> <a title="Lien permanent" href="#deflatealteretag" class="permalink">&para;</a></h2>
 255 <table class="directive">
 256 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Comment l'en-tête sortant ETag doit être modifié au cours
 257 de la compression</td></tr>
 258 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateAlterETag AddSuffix|NoChange|Remove</code></td></tr>
 259 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateAlterETag AddSuffix</code></td></tr>
 260 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 261 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 262 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 263 </table>
 264     <p>La directive <code class="directive">DeflateAlterETag</code> permet de
 265     spécifier comment l'en-tête ETag doit être modifié lorsqu'une
 266     réponse est compressée.</p>
 267     <dl>
 268     <dt>AddSuffix</dt>
 269     <dd><p>Ajoute la méthode de compression à la fin de l'en-tête, ce
 270     qui a pour effet d'attribuer un en-tête ETag unique aux
 271     représentations compressées et non compressées. C'est l'option par
 272     défaut depuis la version 2.4.0, mais empêche de servir des
 273     codes d'état "HTTP Not Modified" (304) en réponse aux requêtes pour un
 274     contenu compressé.</p></dd>
 275     <dt>NoChange</dt>
 276     <dd><p>Ne modifie pas l'en-tête ETag dans une réponse compressée.
 277     C'était l'option par
 278     défaut avant la version 2.4.0, mais cela ne respectait pas la
 279     préconisation HTTP/1.1 selon laquelle chaque représentation de la
 280     même ressource doit posséder un en-tête ETag unique.</p></dd>
 281     <dt>Remove</dt>
 282     <dd><p>Supprime l'en-tête ETag dans les réponses compressées, ce qui
 283     a pour effet de rendre impossibles certaines requêtes
 284     conditionnelles, mais permet d'éviter les inconvénients des options
 285     précédentes.</p></dd>
 286     </dl>
 287
 288 </div>
 289 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 290 <div class="directive-section"><h2><a name="deflatebuffersize" id="deflatebuffersize">Directive</a> <a name="DeflateBufferSize" id="DeflateBufferSize">DeflateBufferSize</a> <a title="Lien permanent" href="#deflatebuffersize" class="permalink">&para;</a></h2>
 291 <table class="directive">
 292 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du fragment que zlib devra comprimer en une seule
 293 fois</td></tr>
 294 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateBufferSize <var>valeur</var></code></td></tr>
 295 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateBufferSize 8096</code></td></tr>
 296 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 297 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 298 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 299 </table>
 300     <p>La directive <code class="directive">DeflateBufferSize</code> permet de
 301     spécifier la taille en octets du fragment que zlib devra comprimer
 302     en une seule fois. Si la taille de la réponse compressée est supérieure à
 303     celle spécifiée par cette directive, httpd passera à un mode d'encodage
 304     fragmenté (l'en-tête HTTP <code>Transfer-Encoding</code> prend la valeur
 305     <code>Chunked</code>), ceci ayant comme effet de bord de ne définir aucun
 306     en-tête HTTP <code>Content-Length</code>. Il est important de connaître ce
 307     comportement, particulièrement lorsque httpd travaille derrière des
 308     mandataires inverses avec mise en cache, ou lorsque httpd est configuré pour
 309     utiliser <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> et <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> car
 310     les réponses HTTP sans en-tête <code>Content-Length</code> peuvent ne pas
 311     être mises en cache.</p>
 312
 313 </div>
 314 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 315 <div class="directive-section"><h2><a name="deflatecompressionlevel" id="deflatecompressionlevel">Directive</a> <a name="DeflateCompressionLevel" id="DeflateCompressionLevel">DeflateCompressionLevel</a> <a title="Lien permanent" href="#deflatecompressionlevel" class="permalink">&para;</a></h2>
 316 <table class="directive">
 317 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le niveau de compression que nous appliquons à la
 318 sortie</td></tr>
 319 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateCompressionLevel <var>valeur</var></code></td></tr>
 320 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>La valeur par défaut de zlib</code></td></tr>
 321 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 322 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 323 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 324 </table>
 325     <p>La directive <code class="directive">DeflateCompressionLevel</code>
 326     permet de spécifier le niveau de compression à utiliser ; plus
 327     grande est la valeur, meilleure sera la compression, mais plus grand
 328     sera aussi le temps CPU nécessaire pour effectuer le
 329     traitement.</p>
 330     <p>La valeur doit être comprise entre 1 (compression minimale) et 9
 331     (compression maximale).</p>
 332
 333 </div>
 334 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 335 <div class="directive-section"><h2><a name="deflatefilternote" id="deflatefilternote">Directive</a> <a name="DeflateFilterNote" id="DeflateFilterNote">DeflateFilterNote</a> <a title="Lien permanent" href="#deflatefilternote" class="permalink">&para;</a></h2>
 336 <table class="directive">
 337 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre le taux de compression sous la forme d'une note
 338 à des fins de journalisation</td></tr>
 339 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateFilterNote [<var>type</var>] <var>nom de la note</var></code></td></tr>
 340 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 341 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 342 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 343 </table>
 344     <p>La directive <code class="directive">DeflateFilterNote</code> permet de
 345     spécifier qu'une note à propos du taux de compression doit être
 346     attachée à la requête. Le nom de la note est passé sous la forme
 347     d'un argument de la directive. Vous pouvez utiliser cette note à des
 348     fins statistiques en enregistrant sa valeur dans votre <a href="../logs.html#accesslog">journal des accès</a>.</p>
 349
 350     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">      DeflateFilterNote ratio
 351
 352       LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
 353       CustomLog "logs/deflate_log" deflate</pre>
 354 </div>
 355
 356     <p>Pour extraire des informations plus précises de vos journaux,
 357     vous pouvez utiliser l'argument <var>type</var> pour spécifier le
 358     type de données de la note enregistrée dans le journal.
 359     <var>type</var> peut prendre une des valeurs suivantes :</p>
 360
 361     <dl>
 362       <dt><code>Input</code></dt>
 363       <dd>Enregistre dans la note la taille en octets du flux en entrée
 364       du filtre.</dd>
 365
 366       <dt><code>Output</code></dt>
 367       <dd>Enregistre dans la note la taille en octets du flux en sortie
 368       du filtre.</dd>
 369
 370       <dt><code>Ratio</code></dt>
 371       <dd>Enregistre le taux de compression (<code>sortie/entrée *
 372       100</code>) dans la note. Il s'agit de la valeur par défaut si
 373       l'argument <var>type</var> est omis.</dd>
 374     </dl>
 375
 376     <p>Vous pouvez donc configurer votre journalisation de la manière
 377     suivante :</p>
 378
 379     <div class="example"><h3>Journalisation détaillée</h3><pre class="prettyprint lang-config">DeflateFilterNote Input instream
 380 DeflateFilterNote Output outstream
 381 DeflateFilterNote Ratio ratio
 382
 383 LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
 384 CustomLog "logs/deflate_log" deflate</pre>
 385 </div>
 386
 387 <h3>Voir aussi</h3>
 388 <ul>
 389 <li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li>
 390 </ul>
 391 </div>
 392 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 393 <div class="directive-section"><h2><a name="deflateinflatelimitrequestbody" id="deflateinflatelimitrequestbody">Directive</a> <a name="DeflateInflateLimitRequestBody" id="DeflateInflateLimitRequestBody">DeflateInflateLimitRequestBody</a> <a title="Lien permanent" href="#deflateinflatelimitrequestbody" class="permalink">&para;</a></h2>
 394 <table class="directive">
 395 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale des corps de requête décompressés</td></tr>
 396 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateInflateLimitRequestBody <var>value</var></code></td></tr>
 397 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Aucune limite, mais LimitRequestBody s'applique après la
 398 compression</code></td></tr>
 399 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 400 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
 401 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 402 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 403 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
 404 Apache</td></tr>
 405 </table>
 406     <p>La directive
 407     <code class="directive">DeflateInflateLimitRequestBody</code> permet de
 408     spécifier la taille maximale d'un corps de requête décompressé. Si
 409     elle n'est pas définie, c'est la valeur de la directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> qui s'applique au corps
 410     de requête décompressé.</p>
 411
 412 </div>
 413 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 414 <div class="directive-section"><h2><a name="deflateinflateratioburst" id="deflateinflateratioburst">Directive</a> <a name="DeflateInflateRatioBurst" id="DeflateInflateRatioBurst">DeflateInflateRatioBurst</a> <a title="Lien permanent" href="#deflateinflateratioburst" class="permalink">&para;</a></h2>
 415 <table class="directive">
 416 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de fois que le ratio de décompression d'un
 417 corps de requête peut être dépassé</td></tr>
 418 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateInflateRatioBurst <var>value</var></code></td></tr>
 419 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateInflateRatioBurst 3</code></td></tr>
 420 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 421 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
 422 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 423 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 424 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
 425 Apache</td></tr>
 426 </table>
 427     <p>La directive <code class="directive">DeflateInflateRatioBurst</code> permet de
 428     spécifier le nombre maximal de fois que la valeur de la directive <code class="directive"><a href="#deflateinflateratiolimit">DeflateInflateRatioLimit</a></code> peut être dépassé
 429     avant l'arrêt du traitement de la requête.</p>
 430
 431 </div>
 432 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 433 <div class="directive-section"><h2><a name="deflateinflateratiolimit" id="deflateinflateratiolimit">Directive</a> <a name="DeflateInflateRatioLimit" id="DeflateInflateRatioLimit">DeflateInflateRatioLimit</a> <a title="Lien permanent" href="#deflateinflateratiolimit" class="permalink">&para;</a></h2>
 434 <table class="directive">
 435 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ratio de décompression maximum pour les corps de requêtes</td></tr>
 436 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateInflateRatioLimit <var>value</var></code></td></tr>
 437 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateInflateRatioLimit 200</code></td></tr>
 438 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 439 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
 440 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 441 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 442 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.10 du serveur HTTP
 443 Apache</td></tr>
 444 </table>
 445     <p>La directive <code class="directive">DeflateInflateRatioLimit</code> permet de
 446     définir le ratio maximum entre la taille d'un corps de requête compressé et
 447     sa taille décompressée. Ce ratio est vérifié au fur et à mesure de l'arrivée
 448     du corps de requête, et s'il est dépassé plus de <code class="directive"><a href="#deflateinflateratioburst">DeflateInflateRatioBurst</a></code> fois, le
 449     traitement de la requête est interrompu.</p>
 450
 451 </div>
 452 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 453 <div class="directive-section"><h2><a name="deflatememlevel" id="deflatememlevel">Directive</a> <a name="DeflateMemLevel" id="DeflateMemLevel">DeflateMemLevel</a> <a title="Lien permanent" href="#deflatememlevel" class="permalink">&para;</a></h2>
 454 <table class="directive">
 455 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité de mémoire utilisable par zlib pour la
 456 compression</td></tr>
 457 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateMemLevel <var>valeur</var></code></td></tr>
 458 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateMemLevel 9</code></td></tr>
 459 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 460 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 461 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 462 </table>
 463     <p>La directive <code class="directive">DeflateMemLevel</code> permet de
 464     spécifier la quantité de mémoire utilisable par zlib pour la
 465     compression (une valeur comprise entre 1 et 9).</p>
 466
 467 </div>
 468 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 469 <div class="directive-section"><h2><a name="deflatewindowsize" id="deflatewindowsize">Directive</a> <a name="DeflateWindowSize" id="DeflateWindowSize">DeflateWindowSize</a> <a title="Lien permanent" href="#deflatewindowsize" class="permalink">&para;</a></h2>
 470 <table class="directive">
 471 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille de la fenêtre de compression zlib</td></tr>
 472 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DeflateWindowSize <var>valeur</var></code></td></tr>
 473 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DeflateWindowSize 15</code></td></tr>
 474 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 475 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 476 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 477 </table>
 478     <p>La directive <code class="directive">DeflateWindowSize</code> permet de
 479     spécifier la fenêtre de compression zlib (une valeur comprise entre
 480     1 et 15). En général, plus grande sera la taille de la fenêtre, plus
 481     grand sera le taux de compression auquel on pourra s'attendre.</p>
 482
 483 </div>
 484 </div>
 485 <div class="bottomlang">
 486 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_deflate.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 487 <a href="../fr/mod/mod_deflate.html" title="Français">&nbsp;fr&nbsp;</a> |
 488 <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 489 <a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 490 </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&amp;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>
 491 <script type="text/javascript"><!--//--><![CDATA[//><!--
 492 var comments_shortname = 'httpd';
 493 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_deflate.html';
 494 (function(w, d) {
 495     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 496         d.write('<div id="comments_thread"><\/div>');
 497         var s = d.createElement('script');
 498         s.type = 'text/javascript';
 499         s.async = true;
 500         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 501         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 502     }
 503     else {
 504         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 505     }
 506 })(window, document);
 507 //--><!]]></script></div><div id="footer">
 508 <p class="apache">Copyright 2019 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 509 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
 510 if (typeof(prettyPrint) !== 'undefined') {
 511     prettyPrint();
 512 }
 513 //--><!]]></script>
 514 </body></html>