granicus.if.org Git - apache/blob - docs/manual/mod/mod_deflate.xml.ja

   1 <?xml version="1.0" encoding="iso-2022-jp"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <!-- English Revision: 1.21 (outdated: 1.22) -->
   5
   6 <!--
   7  Copyright 2002-2004 The Apache Software Foundation
   8
   9  Licensed under the Apache License, Version 2.0 (the "License");
  10  you may not use this file except in compliance with the License.
  11  You may obtain a copy of the License at
  12
  13      http://www.apache.org/licenses/LICENSE-2.0
  14
  15  Unless required by applicable law or agreed to in writing, software
  16  distributed under the License is distributed on an "AS IS" BASIS,
  17  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  See the License for the specific language governing permissions and
  19  limitations under the License.
  20 -->
  21
  22 <modulesynopsis metafile="mod_deflate.xml.meta">
  23
  24 <name>mod_deflate</name>
  25 <description>\e$B%/%i%$%"%s%H$XAw$i$l$kA0$K%3%s%F%s%D$r05=L$9$k\e(B</description>
  26 <status>Extension</status>
  27 <sourcefile>mod_deflate.c</sourcefile>
  28 <identifier>deflate_module</identifier>
  29
  30 <summary>
  31     <p><module>mod_deflate</module> \e$B%b%8%e!<%k$O\e(B <code>DEFLATE</code>
  32     \e$B=PNO%U%#%k%?$rDs6!$7$^$9!#$3$l$O%5!<%P$+$i$N=PNO$r!"%M%C%H%o!<%/$r\e(B
  33     \e$BDL$7$F%/%i%$%"%s%H$KAw$kA0$K05=L$9$k$3$H$r2DG=$K$7$^$9!#\e(B</p>
  34 </summary>
  35 <seealso><a href="../filter.html">Filters</a></seealso>
  36
  37 <section id="recommended"><title>\e$B?d>)@_Dj\e(B</title>
  38     <p>\e$B2<$K$;$C$+$A$J?M8~$1$N@_DjNc$r<($7$^$9!#$7$+$7$<$R;~4V$r<h$C$F\e(B
  39     \e$B2<5-$N>\:Y$b$*FI$_2<$5$$\e(B!</p>
  40
  41     <example><title>\e$B?t%?%$%W$N$_05=L$9$k\e(B</title>
  42       AddOutputFilterByType DEFLATE text/html text/plain text/xml
  43     </example>
  44
  45     <example><title>\e$B2hA|0J30A4$F05=L$9$k\e(B</title>
  46       &lt;Location /&gt;<br />
  47       <indent>
  48         # Insert filter<br />
  49         SetOutputFilter DEFLATE<br />
  50         <br />
  51         # Netscape 4.x has some problems...<br />
  52         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
  53         <br />
  54         # Netscape 4.06-4.08 have some more problems<br />
  55         BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
  56         <br />
  57         # MSIE masquerades as Netscape, but it is fine<br />
  58         # BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html<br />
  59         <br />
  60         # NOTE: Due to a bug in mod_setenvif up to Apache 2.0.48<br />
  61         # the above regex won't work. You can use the following<br />
  62         # workaround to get the desired effect:<br />
  63         BrowserMatch \bMSI[E]           !no-gzip !gzip-only-text/html<br />
  64         <br />
  65         # Don't compress images<br />
  66         SetEnvIfNoCase Request_URI \<br />
  67         <indent>
  68           \.(?:gif|jpe?g|png)$ no-gzip dont-vary<br />
  69         </indent>
  70         <br />
  71         # Make sure proxies don't deliver the wrong content<br />
  72         Header append Vary User-Agent env=!dont-vary<br />
  73       </indent>
  74       &lt;/Location&gt;
  75     </example>
  76
  77 </section>
  78
  79 <section id="enable"><title>\e$B05=L$rM-8z$K$9$k\e(B</title>
  80
  81     <section id="output"><title>Output Compression</title>
  82       <p>\e$B05=L5!G=$O\e(B <code>DEFLATE</code> <a href="../filter.html">\e$B%U%#%k%?\e(B</a>
  83       \e$B$K$h$j<BAu$5$l$F$$$^$9!#0J2<$N%G%#%l%/%F%#%V$O$=$N%G%#%l%/%F%#%V$N$"$k\e(B
  84       \e$B%3%s%F%JCf$N%I%-%e%a%s%H$r05=L$9$k$h$&$K$7$^$9\e(B:</p>
  85
  86       <example>
  87         SetOutputFilter DEFLATE
  88       </example>
  89
  90       <p>\e$B$h$/;H$o$l$F$$$k%V%i%&%6$G$O!"$9$Y$F$N%3%s%F%s%D$KBP$9$k\e(B
  91       \e$B05=L$r07$($k$o$1$G$O$"$j$^$;$s!#$G$9$+$i!"\e(B<code>gzip-only-text/html</code>
  92       \e$B%N!<%H$r\e(B <code>1</code> \e$B$K$7$F!"\e(Bhtml \e$B%U%!%$%k$KBP$7$F$N$_\e(B
  93       \e$B05=L$,F/$/$h$&$K$7$?J}$,$h$$$+$b$7$l$^$;$s\e(B (\e$B0J2<;2>H\e(B)
  94       \e$B$3$NCM$r\e(B <em><code>1</code> \e$B0J30$NCM\e(B</em>\e$B$K@_Dj$7$?>l9g$OL5;k$5$l$^$9!#\e(B</p>
  95
  96       <p>\e$BDL>o!"FCDj$N\e(BMIME\e$B%?%$%W$K$D$$$F$N$_05=L$7$?$$$N$G$"$l$P!"\e(B
  97       <directive module="core">AddOutputFilterByType</directive>
  98       \e$B%G%#%l%/%F%#%V$r;HMQ$7$^$9!#<!$K\e(B Apache \e$B$N%I%-%e%a%s%H$N\e(B html
  99       \e$B%U%!%$%k$N$_$N05=L$rM-8z$K$9$kNc$r<($7$^$9!#\e(B</p>
 100
 101       <example>
 102         &lt;Directory "/your-server-root/manual"&gt;<br />
 103         <indent>
 104           AddOutputFilterByType DEFLATE text/html<br />
 105         </indent>
 106         &lt;/Directory&gt;
 107       </example>
 108
 109       <p>\e$BA4$F$N%U%!%$%k%?%$%W$G$N05=L$KLdBj$rJz$($F$$$k%V%i%&%6$KBP$7$F$O!"\e(B
 110       <directive module="mod_setenvif">BrowserMatch</directive>
 111       \e$B%G%#%l%/%F%#%V$r;HMQ$7$F!"FCDj$N%V%i%&%6$K\e(B <code>no-gzip</code>
 112       \e$B%N!<%H$r%;%C%H$7!"05=L$,9T$J$o$l$J$$$h$&$K$7$^$9!#\e(B
 113       <code>no-gzip</code> \e$B$H\e(B <code>gzip-only-text/html</code>
 114       \e$B$rAH$_9g$o$;$k$3$H$G>e<j$/BP=h$G$-$^$9!#\e(B
 115       \e$B$3$N>l9g!"A0<T$,8e<T$r%*!<%P!<%i%$%I$7$^$9!#\e(B
 116       \e$B>e5-$N\e(B<a href="#recommended">\e$B@_DjNc\e(B</a>\e$B$NH4?h$r\e(B
 117       \e$B<!$K<($7$^$9$N$G$4Mw2<$5$$!#\e(B</p>
 118
 119       <example>
 120         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
 121         BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
 122         BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html
 123       </example>
 124
 125       <p>\e$B$^$:;O$a$K\e(B <code>User-Agent</code> \e$BJ8;zNs$+$i\e(B Netscape Navigator
 126       4.x \e$B$G$"$k$+$I$&$+$rD4$Y$^$9!#$3$l$i$N%P!<%8%g%s$G$O!"\e(B
 127       <code>text/html</code> \e$B0J30$N%?%$%W$N05=L$r07$&$3$H$,$G$-$^$;$s!#\e(B
 128       4.06, 4.07, 4.08 \e$B$O\e(B html \e$B%U%!%$%k$N?-D%$K$bLdBj$rJz$($F$$$^$9!#\e(B
 129       \e$B$G$9$+$i$3$l$i$KBP$7$F$O!"40A4$K\e(B deflate \e$B%U%#%k%?$r%*%U$K$7$^$9!#\e(B</p>
 130
 131       <p>3 \e$BHVL\$N\e(B <directive module="mod_setenvif">BrowserMatch</directive>
 132       \e$B%G%#%l%/%F%#%V$G!"?dB,$7$?%f!<%6!<%(!<%8%'%s%H$r=$@5$7$^$9!#\e(B
 133       \e$B$J$<$J$i\e(B Microsoft Internet Explorer \e$B$b\e(B "Mozilla/4" \e$B$HFCDj$5$l$^$9$,!"\e(B
 134       \e$B$3$l$i$O<B:]$K$O05=L$r07$&$3$H$,$G$-$k$+$i$G$9!#\e(B
 135       <code>User-Agent</code> \e$B%X%C%@$r\e(B "MSIE"
 136       (<code>\b</code> \e$B$O!VC18l$N6-3&!W$r0UL#$7$^$9\e(B) \e$B$NDI2CJ8;z$G8!::$7$F!"\e(B
 137       \e$B$3$l0JA0$K@_Dj$7$?@)8B$r:F$S2r=|$7$^$9!#\e(B</p>
 138
 139       <note><title>\e$BCm\e(B</title>
 140         <code>DEFLATE</code> \e$B%U%#%k%?$OI,$:!"\e(BPHP \e$B$d\e(B SSI \e$B$H$$$C$?\e(B RESOURCE
 141         \e$B%U%#%k%?$N8e$K$J$j$^$9!#\e(B
 142         DEFLATE \e$B%U%#%k%?$OFbItE*$J%5%V%j%/%(%9%H$r4XCN$7$^$;$s!#\e(B
 143       </note>
 144     </section>
 145
 146     <section id="input"><title>\e$BF~NO$N?-D%\e(B</title>
 147       <p><module>mod_deflate</module> \e$B%b%8%e!<%k$O!"\e(Bgzip
 148       \e$B$G05=L$5$l$?%j%/%(%9%HK\BN$r?-D%$9$k%U%#%k%?$bDs6!$7$F$$$^$9!#\e(B
 149       \e$B$3$N5!G=$rM-8z$K$9$k$K$O!"\e(B<directive module="core">SetInputFilter</directive>
 150       \e$B$+\e(B <directive module="mod_mime">AddInputFilter</directive> \e$B$r;HMQ$7$F!"\e(B
 151       <code>DEFLATE</code> \e$B%U%#%k%?$rF~NO%U%#%k%?%A%'%$%s$KAH$_9~$_$^$9!#\e(B
 152       \e$BNc$($P<!$N$h$&$K$J$j$^$9!#\e(B</p>
 153
 154       <example>
 155         &lt;Location /dav-area&gt;<br />
 156         <indent>
 157           SetInputFilter DEFLATE<br />
 158         </indent>
 159         &lt;/Location&gt;
 160       </example>
 161
 162       <p>\e$B$3$N@_Dj$G$"$l$P!"\e(B<code>Content-Encoding: gzip</code>
 163       \e$B%X%C%@$r4^$`%j%/%(%9%H$,Mh$k$H!"K\BN$O<+F0E*$K?-D%$5$l$^$9!#\e(B
 164       gzip \e$B%j%/%(%9%HK\BN$rAw?.$9$k%V%i%&%6$O$"$^$j$"$j$^$;$s!#\e(B
 165       \e$B$7$+$7!"Nc$($P\e(B <a href="http://www.webdav.org">WebDAV</a>
 166       \e$B%/%i%$%"%s%H$N4v$D$+$J$I!"FCJL$J%"%W%j%1!<%7%g%s$G%j%/%(%9%H$N\e(B
 167       \e$B05=L$r<B:]$K%5%]!<%H$7$F$$$k$b$N$b$"$j$^$9!#\e(B</p>
 168
 169       <note type="warning"><title>Content-Length \e$B$K4X$9$kCm0U\e(B</title>
 170         <p>\e$B%j%/%(%9%HK\BN$=$l<+BN$rI>2A$9$k>l9g$O!"\e(B<em><code>Content-Length</code>
 171         \e$B%X%C%@$r?.MQ$7$J$$$G$/$@$5$$\e(B</em>\e$B!#\e(BContent-Length \e$B%X%C%@$O!"\e(B
 172         \e$B%/%i%$%"%s%H$+$iAw?.$5$l$k%G!<%?$ND9$5$rH?1G$7$F$$$k$N$G$"$C$F!"\e(B
 173         \e$B?-D%$5$l$?%G!<%?%9%H%j!<%`$N\e(B<em>\e$B%P%$%H%+%&%s%H$G$O$"$j$^$;$s\e(B</em>\e$B!#\e(B</p>
 174       </note>
 175     </section>
 176 </section>
 177
 178 <section id="proxies"><title>Proxy \e$B%5!<%P$G$N07$$\e(B</title>
 179
 180     <p><module>mod_deflate</module> \e$B%b%8%e!<%k$O\e(B <code>Vary: Accept-Encoding</code>
 181     HTTP \e$B1~Ez%X%C%@$rAw?.$7$F!"E,@Z$J\e(B <code>Accept-Encoding</code>
 182     \e$B%j%/%(%9%H%X%C%@$rAw?.$9$k%/%i%$%"%s%H$KBP$7$F$N$_!"\e(B
 183     \e$B%W%m%/%7%5!<%P$,%-%c%C%7%e$7$?1~Ez$rAw?.$9$k$h$&$KCm0U$r4-5/$7$^$9!#\e(B
 184     \e$B$3$N$h$&$K$7$F!"05=L$r07$&$3$H$N$G$-$J$$%/%i%$%"%s%H$K\e(B
 185     \e$B05=L$5$l$?FbMF$,Aw$i$l$k$3$H$N$J$$$h$&$K$7$^$9!#\e(B</p>
 186
 187     <p>\e$B$b$7FCJL$K2?$+$K0MB8$7$F=|30$7$?$$>l9g!"Nc$($P\e(B <code>User-Agent</code>
 188     \e$B%X%C%@$J$I$K0MB8$7$F$$$k>l9g!"<jF0$G\e(B <code>Vary</code> \e$B%X%C%@$r@_Dj$7$F!"\e(B
 189     \e$BDI2C$N@)8B$K$D$$$F%W%m%/%7%5!<%P$KCm0U$r9T$J$&I,MW$,$"$j$^$9!#\e(B
 190     \e$BNc$($P\e(B <code>User-Agent</code> \e$B$K0MB8$7$F\e(B <code>DEFLATE</code>
 191     \e$B$rDI2C$9$kE57?E*$J@_Dj$G$O!"<!$N$h$&$KDI2C$9$k$3$H$K$J$j$^$9!#\e(B</p>
 192
 193     <example>
 194       Header append Vary User-Agent
 195     </example>
 196
 197     <p>\e$B%j%/%(%9%H%X%C%@0J30$N>pJs\e(B (<em>\e$BNc$($P\e(B</em> HTTP \e$B%P!<%8%g%s\e(B)
 198     \e$B$K0MB8$7$F05=L$9$k$+$I$&$+7h$a$k>l9g!"\e(B
 199     <code>Vary</code> \e$B%X%C%@$r\e(B <code>*</code> \e$B$K@_Dj$9$kI,MW$,$"$j$^$9!#\e(B
 200     \e$B$3$N$h$&$K$9$k$H!";EMM$K=`5r$7$?%W%m%/%7$O%-%c%C%7%e$rA4$/9T$J$o$J$/$J$j$^$9!#\e(B</p>
 201
 202     <example><title>\e$BNc\e(B</title>
 203       Header set Vary *
 204     </example>
 205 </section>
 206
 207 <directivesynopsis>
 208 <name>DeflateFilterNote</name>
 209 <description>\e$B%m%.%s%0MQ$K05=LHf$r%a%b$KDI2C\e(B</description>
 210 <syntax>DeflateFilterNote [<var>type</var>] <var>notename</var></syntax>
 211 <contextlist><context>server config</context>
 212 <context>virtual host</context></contextlist>
 213 <compatibility><var>type</var> is available since Apache 2.0.45</compatibility>
 214
 215 <usage>
 216     <p><directive>DeflateFilterNote</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 217     \e$B05=LHf$K4X$9$k%a%b$,%j%/%(%9%H$KIU2C$5$l$k$3$H$r;XDj$7$^$9!#\e(B
 218     \e$B%a%b\e(B (note) \e$B$NL>A0$O%G%#%l%/%F%#%V$K;XDj$5$l$?CM$G$9!#\e(B
 219     \e$B%a%b$O\e(B<a href="../logs.html#accesslog">\e$B%"%/%;%9%m%0\e(B</a>\e$B$K\e(B
 220     \e$BCM$r5-O?$7!"E}7W$r<h$kL\E*$K$b;H$($^$9!#\e(B</p>
 221
 222     <example><title>\e$BNc\e(B</title>
 223       DeflateFilterNote ratio<br />
 224       <br />
 225       LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate<br />
 226       CustomLog logs/deflate_log deflate
 227     </example>
 228
 229     <p>\e$B%m%0$+$i$b$C$H@:L)$JCM$rCj=P$7$?$$>l9g$O!"\e(B<var>type</var>
 230     \e$B0z?t$r;HMQ$7$F!"%G!<%?%?%$%W$r%m%0$N%a%b$H$7$F;D$9$h$&$K;XDj$G$-$^$9!#\e(B
 231     <var>type</var> \e$B$O<!$N$&$A$N0l$D$G$9!#\e(B</p>
 232
 233     <dl>
 234       <dt><code>Input</code></dt>
 235       <dd>\e$B%U%#%k%?$NF~NO%9%H%j!<%`$N%P%$%H%+%&%s%H$r%a%b$KJ]B8$9$k!#\e(B</dd>
 236
 237       <dt><code>Output</code></dt>
 238       <dd>\e$B%U%#%k%?$N=PNO%9%H%j!<%`$N%P%$%H%+%&%s%H$r%a%b$KJ]B8$9$k!#\e(B</dd>
 239
 240       <dt><code>Ratio</code></dt>
 241       <dd>\e$B05=LN(\e(B (<code>\e$B=PNO\e(B / \e$BF~NO\e(B * 100</code>) \e$B$r%a%b$KJ]B8$9$k!#\e(B
 242       <var>type</var> \e$B0z?t$r>JN,$7$?>l9g$O!"$3$l$,%G%U%)%k%H$H$J$j$^$9!#\e(B</dd>
 243     </dl>
 244
 245     <p>\e$B$^$H$a$k$H!"<!$N$h$&$K%m%0$r<h$k$3$H$K$J$k$G$7$g$&!#\e(B</p>
 246
 247     <example><title>\e$B@:L)$J%m%0:N<h\e(B</title>
 248       DeflateFilterNote Input instream<br />
 249       DeflateFilterNote Output outstream<br />
 250       DeflateFilterNote Ratio ratio<br />
 251       <br />
 252       LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate<br />
 253       CustomLog logs/deflate_log deflate
 254     </example>
 255 </usage>
 256 <seealso><module>mod_log_config</module></seealso>
 257 </directivesynopsis>
 258
 259 <directivesynopsis>
 260 <name>DeflateBufferSize</name>
 261 <description>zlib \e$B$,0lEY$K05=L$9$k2t$NBg$-$5\e(B</description>
 262 <syntax>DeflateBufferSize <var>value</var></syntax>
 263 <default>DeflateBufferSize 8096</default>
 264 <contextlist><context>server config</context>
 265 <context>virtual host</context></contextlist>
 266
 267 <usage>
 268     <p><directive>DeflateBufferSize</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 269     zlib \e$B$,0lEY$K05=L$9$k2t$NBg$-$5$r%P%$%HC10L$G;XDj$7$^$9!#\e(B</p>
 270 </usage>
 271 </directivesynopsis>
 272
 273 <directivesynopsis>
 274 <name>DeflateWindowSize</name>
 275 <description>Zlib \e$B$N05=LMQ%&%#%s%I%&$NBg$-$5\e(B</description>
 276 <syntax>DeflateWindowSize <var>value</var></syntax>
 277 <default>DeflateWindowSize 15</default>
 278 <contextlist><context>server config</context>
 279 <context>virtual host</context></contextlist>
 280
 281 <usage>
 282     <p><directive>DeflateWindowSize</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 283     zlib \e$B$N05=LMQ%&%#%s%I%&\e(B (\e$BLuCm\e(B: zlib \e$B$G;HMQ$5$l$kMzNr%P%C%U%!\e(B)
 284     \e$B$NBg$-$5$r;XDj$7$^$9\e(B (1 \e$B$+$i\e(B 15 \e$B$N4V$NCM\e(B)\e$B!#\e(B
 285     \e$B0lHLE*$KBg$-$J%&%#%s%I%&%5%$%:$r;HMQ$9$k$H05=LN($,8~>e$7$^$9!#\e(B
 286     (\e$BLuCm\e(B: 2 \e$B$rDl$H$9$kBP?t$NCM$K$J$j$^$9!#\e(B
 287     8 \e$B$+$i\e(B 15 \e$B$K$9$k$N$,NI$$$G$7$g$&!#\e(B)</p>
 288 </usage>
 289 </directivesynopsis>
 290
 291 <directivesynopsis>
 292 <name>DeflateMemLevel</name>
 293 <description>zlib \e$B$,05=L$K;H$&%a%b%j$N%l%Y%k$r;XDj\e(B</description>
 294 <syntax>DeflateMemLevel <var>value</var></syntax>
 295 <default>DeflateMemLevel 9</default>
 296 <contextlist><context>server config</context>
 297 <context>virtual host</context></contextlist>
 298
 299 <usage>
 300     <p><directive>DeflateMemLevel</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 301     zlib \e$B$,05=L$K;H$&%a%b%j$N%l%Y%k$r@_Dj$7$^$9\e(B (1 \e$B$+$i\e(B 9 \e$B$N4V$NCM\e(B)\e$B!#\e(B
 302     (\e$BLuCm\e(B: 2 \e$B$rDl$H$9$kBP?t$NCM$K$J$j$^$9!#\e(B
 303     8 \e$BDxEY$,NI$$$G$7$g$&!#\e(B)</p>
 304 </usage>
 305 </directivesynopsis>
 306
 307 <directivesynopsis>
 308 <name>DeflateCompressionLevel</name>
 309 <description>\e$B=PNO$KBP$7$F9T$J$&05=L$NDxEY\e(B</description>
 310 <syntax>DeflateCompressionLevel <var>value</var></syntax>
 311 <default>Zlib \e$B$N%G%U%)%k%H\e(B</default>
 312 <contextlist><context>server config</context><context>virtual host</context>
 313 </contextlist>
 314 <compatibility>This directive is available since Apache 2.0.45</compatibility>
 315
 316 <usage>
 317      <p><directive>DeflateCompressionLevel</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 318          \e$B05=L$NDxEY$r@_Dj$7$^$9!#Bg$-$JCM$G$O!"$h$j05=L$,9T$J$o$l$^$9$,!"\e(B
 319          CPU \e$B;q8;$r>CHq$7$^$9!#\e(B</p>
 320     <p>\e$BCM$O\e(B 1 (\e$BDc05=L\e(B) \e$B$+$i\e(B 9 (\e$B9b05=L\e(B) \e$B$G$9!#\e(B</p>
 321 </usage>
 322 </directivesynopsis>
 323
 324 </modulesynopsis>
 325