rubbos/app/apache2/manual/mod/mod_deflate.html.en

   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="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_deflate - Apache HTTP Server</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  16 <p class="apache">Apache HTTP Server Version 2.0</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.0</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Apache Module mod_deflate</h1>
  23 <div class="toplang">
  24 <p><span>Available Languages: </span><a href="../en/mod/mod_deflate.html" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  26 <a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  27 </div>
  28 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Compress content before it is delivered to the
  29 client</td></tr>
  30 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  31 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>deflate_module</td></tr>
  32 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_deflate.c</td></tr></table>
  33 <h3>Summary</h3>
  34
  35     <p>The <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> module provides
  36     the <code>DEFLATE</code> output filter that allows output from
  37     your server to be compressed before being sent to the client over
  38     the network.</p>
  39 </div>
  40 <div id="quickview"><h3 class="directives">Directives</h3>
  41 <ul id="toc">
  42 <li><img alt="" src="../images/down.gif" /> <a href="#deflatebuffersize">DeflateBufferSize</a></li>
  43 <li><img alt="" src="../images/down.gif" /> <a href="#deflatecompressionlevel">DeflateCompressionLevel</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#deflatefilternote">DeflateFilterNote</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#deflatememlevel">DeflateMemLevel</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#deflatewindowsize">DeflateWindowSize</a></li>
  47 </ul>
  48 <h3>Topics</h3>
  49 <ul id="topics">
  50 <li><img alt="" src="../images/down.gif" /> <a href="#recommended">Sample Configurations</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#enable">Enabling Compression</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#proxies">Dealing with proxy servers</a></li>
  53 </ul><h3>See also</h3>
  54 <ul class="seealso">
  55 <li><a href="../filter.html">Filters</a></li>
  56 </ul></div>
  57 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  58 <div class="section">
  59 <h2><a name="recommended" id="recommended">Sample Configurations</a></h2>
  60     <p>This is a simple sample configuration for the impatient.</p>
  61
  62     <div class="example"><h3>Compress only a few types</h3><p><code>
  63       AddOutputFilterByType DEFLATE text/html text/plain text/xml
  64     </code></p></div>
  65
  66     <p>The following configuration, while resulting in more compressed content,
  67     is also much more complicated.  Do not use this unless you fully understand
  68     all the configuration details.</p>
  69
  70     <div class="example"><h3>Compress everything except images</h3><p><code>
  71       &lt;Location /&gt;<br />
  72       <span class="indent">
  73         # Insert filter<br />
  74         SetOutputFilter DEFLATE<br />
  75         <br />
  76         # Netscape 4.x has some problems...<br />
  77         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
  78         <br />
  79         # Netscape 4.06-4.08 have some more problems<br />
  80         BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
  81         <br />
  82         # MSIE masquerades as Netscape, but it is fine<br />
  83         # BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html<br />
  84         <br />
  85         # NOTE: Due to a bug in mod_setenvif up to Apache 2.0.48<br />
  86         # the above regex won't work. You can use the following<br />
  87         # workaround to get the desired effect:<br />
  88         BrowserMatch \bMSI[E]           !no-gzip !gzip-only-text/html<br />
  89         <br />
  90         # Don't compress images<br />
  91         SetEnvIfNoCase Request_URI \<br />
  92         <span class="indent">
  93           \.(?:gif|jpe?g|png)$ no-gzip dont-vary<br />
  94         </span>
  95         <br />
  96         # Make sure proxies don't deliver the wrong content<br />
  97         Header append Vary User-Agent env=!dont-vary<br />
  98       </span>
  99       &lt;/Location&gt;
 100     </code></p></div>
 101
 102 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 103 <div class="section">
 104 <h2><a name="enable" id="enable">Enabling Compression</a></h2>
 105
 106     <h3><a name="output" id="output">Output Compression</a></h3>
 107       <p>Compression is implemented by the <code>DEFLATE</code>
 108       <a href="../filter.html">filter</a>. The following directive
 109       will enable compression for documents in the container where it
 110       is placed:</p>
 111
 112       <div class="example"><p><code>
 113         SetOutputFilter DEFLATE
 114       </code></p></div>
 115
 116       <p>Some popular browsers cannot handle compression of all content
 117       so you may want to set the <code>gzip-only-text/html</code> note to
 118       <code>1</code> to only allow html files to be compressed (see
 119       below). If you set this to <em>anything but <code>1</code></em> it
 120       will be ignored.</p>
 121
 122       <p>If you want to restrict the compression to particular MIME types
 123       in general, you may use the <code class="directive"><a href="../mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> directive. Here is an example of
 124       enabling compression only for the html files of the Apache
 125       documentation:</p>
 126
 127       <div class="example"><p><code>
 128         &lt;Directory "/your-server-root/manual"&gt;<br />
 129         <span class="indent">
 130           AddOutputFilterByType DEFLATE text/html<br />
 131         </span>
 132         &lt;/Directory&gt;
 133       </code></p></div>
 134
 135       <p>For browsers that have problems even with compression of all file
 136       types, use the <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code> directive to set the <code>no-gzip</code>
 137       note for that particular browser so that no compression will be
 138       performed. You may combine <code>no-gzip</code> with <code>gzip-only-text/html</code> to get the best results. In that case
 139       the former overrides the latter. Take a look at the following
 140       excerpt from the <a href="#recommended">configuration example</a>
 141       defined in the section above:</p>
 142
 143       <div class="example"><p><code>
 144         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
 145         BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
 146         BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html
 147       </code></p></div>
 148
 149       <p>At first we probe for a <code>User-Agent</code> string that
 150       indicates a Netscape Navigator version of 4.x. These versions
 151       cannot handle compression of types other than
 152       <code>text/html</code>. The versions 4.06, 4.07 and 4.08 also
 153       have problems with decompressing html files. Thus, we completely
 154       turn off the deflate filter for them.</p>
 155
 156       <p>The third <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>
 157       directive fixes the guessed identity of the user agent, because
 158       the Microsoft Internet Explorer identifies itself also as "Mozilla/4"
 159       but is actually able to handle requested compression. Therefore we
 160       match against the additional string "MSIE" (<code>\b</code> means
 161       "word boundary") in the <code>User-Agent</code> Header and turn off
 162       the restrictions defined before.</p>
 163
 164       <div class="note"><h3>Note</h3>
 165         The <code>DEFLATE</code> filter is always inserted after RESOURCE
 166         filters like PHP or SSI. It never touches internal subrequests.
 167       </div>
 168
 169
 170     <h3><a name="input" id="input">Input Decompression</a></h3>
 171       <p>The <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> module also provides a filter for
 172       decompressing a gzip compressed request body . In order to activate
 173       this feature you have to insert the <code>DEFLATE</code> filter into
 174       the input filter chain using <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code> or <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, for example:</p>
 175
 176       <div class="example"><p><code>
 177         &lt;Location /dav-area&gt;<br />
 178         <span class="indent">
 179           SetInputFilter DEFLATE<br />
 180         </span>
 181         &lt;/Location&gt;
 182       </code></p></div>
 183
 184       <p>Now if a request contains a <code>Content-Encoding:
 185       gzip</code> header, the body will be automatically decompressed.
 186       Few browsers have the ability to gzip request bodies. However,
 187       some special applications actually do support request
 188       compression, for instance some <a href="http://www.webdav.org">WebDAV</a> clients.</p>
 189
 190       <div class="warning"><h3>Note on Content-Length</h3>
 191         <p>If you evaluate the request body yourself, <em>don't trust
 192         the <code>Content-Length</code> header!</em>
 193         The Content-Length header reflects the length of the
 194         incoming data from the client and <em>not</em> the byte count of
 195         the decompressed data stream.</p>
 196       </div>
 197
 198 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 199 <div class="section">
 200 <h2><a name="proxies" id="proxies">Dealing with proxy servers</a></h2>
 201
 202     <p>The <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> module sends a <code>Vary:
 203     Accept-Encoding</code> HTTP response header to alert proxies that
 204     a cached response should be sent only to clients that send the
 205     appropriate <code>Accept-Encoding</code> request header.  This
 206     prevents compressed content from being sent to a client that will
 207     not understand it.</p>
 208
 209     <p>If you use some special exclusions dependent
 210     on, for example, the <code>User-Agent</code> header, you must
 211     manually configure an addition to the <code>Vary</code> header
 212     to alert proxies of the additional restrictions.  For example,
 213     in a typical configuration where the addition of the <code>DEFLATE</code>
 214     filter depends on the <code>User-Agent</code>, you should add:</p>
 215
 216     <div class="example"><p><code>
 217       Header append Vary User-Agent
 218     </code></p></div>
 219
 220     <p>If your decision about compression depends on other information
 221     than request headers (<em>e.g.</em> HTTP version), you have to set the
 222     <code>Vary</code> header to the value <code>*</code>. This prevents
 223     compliant proxies from caching entirely.</p>
 224
 225     <div class="example"><h3>Example</h3><p><code>
 226       Header set Vary *
 227     </code></p></div>
 228 </div>
 229 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 230 <div class="directive-section"><h2><a name="DeflateBufferSize" id="DeflateBufferSize">DeflateBufferSize</a> <a name="deflatebuffersize" id="deflatebuffersize">Directive</a></h2>
 231 <table class="directive">
 232 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fragment size to be compressed at one time by zlib</td></tr>
 233 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateBufferSize <var>value</var></code></td></tr>
 234 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DeflateBufferSize 8096</code></td></tr>
 235 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 236 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 237 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 238 </table>
 239     <p>The <code class="directive">DeflateBufferSize</code> directive specifies
 240     the size in bytes of the fragments that zlib should compress at one
 241     time.</p>
 242
 243 </div>
 244 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 245 <div class="directive-section"><h2><a name="DeflateCompressionLevel" id="DeflateCompressionLevel">DeflateCompressionLevel</a> <a name="deflatecompressionlevel" id="deflatecompressionlevel">Directive</a></h2>
 246 <table class="directive">
 247 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How much compression do we apply to the output</td></tr>
 248 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateCompressionLevel <var>value</var></code></td></tr>
 249 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Zlib's default</code></td></tr>
 250 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 251 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 252 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 253 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>This directive is available since Apache 2.0.45</td></tr>
 254 </table>
 255     <p>The <code class="directive">DeflateCompressionLevel</code> directive specifies
 256         what level of compression should be used, the higher the value,
 257         the better the compression, but the more CPU time is required to
 258         achieve this.</p>
 259     <p>The value must between 1 (less compression) and 9 (more compression).</p>
 260
 261 </div>
 262 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 263 <div class="directive-section"><h2><a name="DeflateFilterNote" id="DeflateFilterNote">DeflateFilterNote</a> <a name="deflatefilternote" id="deflatefilternote">Directive</a></h2>
 264 <table class="directive">
 265 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Places the compression ratio in a note for logging</td></tr>
 266 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateFilterNote [<var>type</var>] <var>notename</var></code></td></tr>
 267 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 268 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 269 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 270 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td><var>type</var> is available since Apache 2.0.45</td></tr>
 271 </table>
 272     <p>The <code class="directive">DeflateFilterNote</code> directive
 273     specifies that a note about compression ratios should be attached
 274     to the request. The name of the note is the value specified for
 275     the directive. You can use that note for statistical purposes by
 276     adding the value to your <a href="../logs.html#accesslog">access log</a>.</p>
 277
 278     <div class="example"><h3>Example</h3><p><code>
 279       DeflateFilterNote ratio<br />
 280       <br />
 281       LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate<br />
 282       CustomLog logs/deflate_log deflate
 283     </code></p></div>
 284
 285     <p>If you want to extract more accurate values from your logs, you
 286     can use the <var>type</var> argument to specify the type of data
 287     left as note for logging. <var>type</var> can be one of:</p>
 288
 289     <dl>
 290       <dt><code>Input</code></dt>
 291       <dd>Store the byte count of the filter's input stream in the note.</dd>
 292
 293       <dt><code>Output</code></dt>
 294       <dd>Store the byte count of the filter's output stream in the note.</dd>
 295
 296       <dt><code>Ratio</code></dt>
 297       <dd>Store the compression ratio (<code>output/input * 100</code>)
 298       in the note. This is the default, if the <var>type</var> argument
 299       is omitted.</dd>
 300     </dl>
 301
 302     <p>Thus you may log it this way:</p>
 303
 304     <div class="example"><h3>Accurate Logging</h3><p><code>
 305       DeflateFilterNote Input instream<br />
 306       DeflateFilterNote Output outstream<br />
 307       DeflateFilterNote Ratio ratio<br />
 308       <br />
 309       LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate<br />
 310       CustomLog logs/deflate_log deflate
 311     </code></p></div>
 312
 313 <h3>See also</h3>
 314 <ul>
 315 <li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li>
 316 </ul>
 317 </div>
 318 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 319 <div class="directive-section"><h2><a name="DeflateMemLevel" id="DeflateMemLevel">DeflateMemLevel</a> <a name="deflatememlevel" id="deflatememlevel">Directive</a></h2>
 320 <table class="directive">
 321 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>How much memory should be used by zlib for compression</td></tr>
 322 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateMemLevel <var>value</var></code></td></tr>
 323 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DeflateMemLevel 9</code></td></tr>
 324 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 325 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 326 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 327 </table>
 328     <p>The <code class="directive">DeflateMemLevel</code> directive specifies
 329     how much memory should be used by zlib for compression
 330     (a value between 1 and 9).</p>
 331
 332 </div>
 333 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 334 <div class="directive-section"><h2><a name="DeflateWindowSize" id="DeflateWindowSize">DeflateWindowSize</a> <a name="deflatewindowsize" id="deflatewindowsize">Directive</a></h2>
 335 <table class="directive">
 336 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Zlib compression window size</td></tr>
 337 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DeflateWindowSize <var>value</var></code></td></tr>
 338 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DeflateWindowSize 15</code></td></tr>
 339 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 340 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 341 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_deflate</td></tr>
 342 </table>
 343     <p>The <code class="directive">DeflateWindowSize</code> directive specifies the
 344     zlib compression window size (a value between 1 and 15). Generally, the
 345     higher the window size, the higher can the compression ratio be expected.</p>
 346
 347 </div>
 348 </div>
 349 <div class="bottomlang">
 350 <p><span>Available Languages: </span><a href="../en/mod/mod_deflate.html" title="English">&nbsp;en&nbsp;</a> |
 351 <a href="../ja/mod/mod_deflate.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 352 <a href="../ko/mod/mod_deflate.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 353 </div><div id="footer">
 354 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 355 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
 356 </body></html>