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