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

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