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

   1 <?xml version="1.0" encoding="EUC-KR" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
   4 <!-- English revision: 1.18 -->
   5
   6 <!--
   7  Copyright 2003-2004 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>³»¿ëÀ» Å¬¶óÀÌ¾ðÆ®·Î º¸³»±â Àü¿¡ ¾ÐÃàÇÑ´Ù</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> ¸ðµâÀº ¼¹öÀÇ Ãâ·ÂÀ» ³×Æ®¿÷À¸·Î
  32     Å¬¶óÀÌ¾ðÆ®¿¡ º¸³»±â Àü¿¡ ¾ÐÃàÇÏ´Â <code>DEFLATE</code> Ãâ·ÂÇÊÅÍ¸¦
  33     Á¦°øÇÑ´Ù.</p>
  34 </summary>
  35 <seealso><a href="../filter.html">ÇÊÅÍ</a></seealso>
  36
  37 <section id="recommended"><title>±ÇÀåÇÏ´Â ¼³Á¤</title>
  38     <p>±ÞÇÑ »ç¶÷À» À§ÇÑ °ßº» ¼³Á¤ÀÌ´Ù. ±×·¯³ª ½Ã°£À» °¡Áö°í
  39     ¾Æ·¡ ÀÚ¼¼ÇÑ ¼³¸íÀ» ÀÐ±æ ¹Ù¶õ´Ù!</p>
  40
  41     <example><title>ÀÏºÎ type¸¸ ¾ÐÃà</title>
  42       AddOutputFilterByType DEFLATE text/html text/plain text/xml
  43     </example>
  44
  45     <example><title>ÀÌ¹ÌÁö¸¦ Á¦¿ÜÇÑ ¸ðµç °ÍÀ» ¾ÐÃà</title>
  46       &lt;Location /&gt;<br />
  47       <indent>
  48         # ÇÊÅÍ¸¦ Ãß°¡ÇÑ´Ù<br />
  49         SetOutputFilter DEFLATE<br />
  50         <br />
  51         # Netscape 4.x¿¡ ¹®Á¦°¡ ÀÖ´Ù...<br />
  52         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
  53         <br />
  54         # Netscape 4.06-4.08¿¡ ´õ ¹®Á¦°¡ ÀÖ´Ù<br />
  55         BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
  56         <br />
  57         # MSIEÀº Netscape¶ó°í ÀÚ½ÅÀ» ¾Ë¸®Áö¸¸, ¹®Á¦°¡ ¾ø´Ù<br />
  58         BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html<br />
  59         <br />
  60         # ÀÌ¹ÌÁö¸¦ ¾ÐÃàÇÏÁö ¾Ê´Â´Ù<br />
  61         SetEnvIfNoCase Request_URI \<br />
  62         <indent>
  63           \.(?:gif|jpe?g|png)$ no-gzip dont-vary<br />
  64         </indent>
  65         <br />
  66         # ÇÁ·Ï½Ã°¡ Àß¸øµÈ ³»¿ëÀ» Àü´ÞÇÏÁö¾Êµµ·Ï ÇÑ´Ù<br />
  67         Header append Vary User-Agent env=!dont-vary<br />
  68       </indent>
  69       &lt;/Location&gt;
  70     </example>
  71
  72 </section>
  73
  74 <section id="enable"><title>¾ÐÃàÇÏ±â</title>
  75
  76     <section id="output"><title>Ãâ·Â ¾ÐÃà</title>
  77       <p><code>DEFLATE</code> <a href="../filter.html">ÇÊÅÍ</a>°¡
  78       ¾ÐÃàÀ» ÇÑ´Ù. ´ÙÀ½ Áö½Ã¾î´Â Áö½Ã¾î°¡ ÀÖ´Â À§Ä¡ÀÇ ¹®¼¸¦
  79       ¾ÐÃàÇÑ´Ù:</p>
  80
  81       <example>
  82         SetOutputFilter DEFLATE
  83       </example>
  84
  85       <p>¸ðµç ³»¿ëÀ» ¾ÐÃàÇÏ¸é Ã³¸®ÇÏÁö ¸øÇÏ´Â ºê¶ó¿ìÀú°¡ ÀÖ±â¶§¹®¿¡
  86       html ÆÄÀÏ¸¸À» ¾ÐÃàÇÏ±âÀ§ÇØ (¾Æ·¡ Âü°í)
  87       <code>gzip-only-text/html</code>À» <code>1</code>·Î ¼³Á¤ÇÒÁöµµ
  88       ¸ð¸¥´Ù. ÀÌ¸¦ <em><code>1</code>ÀÌ ¾Æ´Ñ °ªÀ¸·Î</em> ¼³Á¤ÇÏ¸é
  89       ¹«½ÃÇÑ´Ù.</p>
  90
  91       <p>º¸Åë Æ¯º°ÇÑ MIME type¸¸ ¾ÐÃàÇÏ·Á¸é <directive module="core"
  92       >AddOutputFilterByType</directive> Áö½Ã¾î¸¦ »ç¿ëÇÑ´Ù.
  93       ´ÙÀ½ ¼³Á¤Àº html ÆÄÀÏ¸¸À» ¾ÐÃàÇÑ´Ù:</p>
  94
  95       <example>
  96         &lt;Directory "/your-server-root/manual"&gt;<br />
  97         <indent>
  98           AddOutputFilterByType DEFLATE text/html<br />
  99         </indent>
 100         &lt;/Directory&gt;
 101       </example>
 102
 103       <p>¾ÐÃàÇÑ ÆÄÀÏÀ» Ã³¸®ÇÏÁö ¸øÇÏ´Â ºê¶ó¿ìÀú¿¡°Ô´Â ¾ÐÃàÇÏÁö¾Ê°í
 104       º¸³»±æÀ§ÇØ <directive module="mod_setenvif"
 105       >BrowserMatch</directive> Áö½Ã¾î¿¡ <code>no-gzip</code>À»
 106       ¼³Á¤ÇÑ´Ù. ÃÖÀûÀÇ °á°ú¸¦ ¾ò±âÀ§ÇØ <code>no-gzip</code>°ú
 107       <code>gzip-only-text/html</code>À» °°ÀÌ »ç¿ëÇÒ ¼ö ÀÖ´Ù.
 108       ÀÌ °æ¿ì ÀüÀÚ°¡ ÈÄÀÚ¸¦ ¹«½ÃÇÑ´Ù. À§ ÀýÀÇ <a
 109       href="#recommended">¼³Á¤ ¿¹Á¦</a> ÀÏºÎ¸¦ »ìÆìº¸ÀÚ:</p>
 110
 111       <example>
 112         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
 113         BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
 114         BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html
 115       </example>
 116
 117       <p>¸ÕÀú <code>User-Agent</code> ¹®ÀÚ¿À» º¸°í Netscape
 118       Navigator ¹öÀü 4.xÀÎÁö °Ë»çÇÑ´Ù. ÀÌ ¹öÀüÀº <code>text/html</code>ÀÌ
 119       ¾Æ´Ñ typeÀÇ ¾ÐÃàÀ» Ã³¸®ÇÏÁö ¸øÇÑ´Ù. ¹öÀü 4.06, 4.07, 4.08Àº
 120       html ÆÄÀÏ ¾ÐÃàÀ» Ã³¸®ÇÏ´Â´ëµµ ¹®Á¦°¡ ÀÖ´Ù. ±×·¡¼ ¿ì¸®´Â
 121       ÀÌ °æ¿ì deflate ÇÊÅÍ¸¦ ¿ÏÀüÈ÷ »ç¿ëÇÏÁö¾Ê´Â´Ù.</p>
 122
 123       <p>¼¼¹øÂ° <directive module="mod_setenvif">BrowserMatch</directive>
 124       Áö½Ã¾î´Â Microsoft Internet Explorer°¡ ÀÚ½ÅÀ» "Mozilla/4"·Î
 125       ¾Ë¸®Áö¸¸ ¾ÐÃàµÈ ¿äÃ»À» Ã³¸®ÇÒ ¼ö ÀÖ±â¶§¹®¿¡ user agent
 126       ÃßÃøÀ» ¼öÁ¤ÇÑ´Ù. <code>User-Agent</code> Çì´õ¿¡¼ "MSIE"
 127       (<code>\b</code>´Â "´Ü¾î °æ°è"¸¦ ¶æÇÑ´Ù) ¹®ÀÚ¿À» ¹ß°ßÇÏ¸é
 128       ¾Õ¿¡¼ ¼³Á¤ÇÑ Á¦¾àÀ» Ç¬´Ù.</p>
 129
 130       <note><title>ÁÖÀÇ</title>
 131         <code>DEFLATE</code> ÇÊÅÍ´Â Ç×»ó PHP³ª SSI¿Í °°Àº RESOURCE
 132         ÇÊÅÍ µÚ¿¡ µé¾î°£´Ù. ¶Ç, ³»ºÎ ÇÏÀ§¿äÃ»(subrequest)¿¡ ¿µÇâÀ»
 133         ÁÖÁö ¾Ê´Â´Ù.
 134       </note>
 135     </section>
 136
 137     <section id="input"><title>ÀÔ·Â ¾ÐÃàÇ®±â</title>
 138       <p><module>mod_deflate</module> ¸ðµâÀº ¿äÃ»ÀÇ gzip ¾ÐÃàµÈ
 139       ³»¿ëÀ» Çª´Â ÇÊÅÍµµ Á¦°øÇÑ´Ù. ÀÌ ±â´ÉÀ» »ç¿ëÇÏ·Á¸é ´ÙÀ½°ú
 140       °°ÀÌ <directive module="core">SetInputFilter</directive>³ª
 141       <directive module="mod_mime">AddInputFilter</directive>¸¦
 142       »ç¿ëÇÏ¿© ÀÔ·ÂÇÊÅÍ¼ø¼¿¡ <code>DEFLATE</code> ÇÊÅÍ¸¦
 143       Ãß°¡ÇØ¾ßÇÑ´Ù:</p>
 144
 145       <example>
 146         &lt;Location /dav-area&gt;<br />
 147         <indent>
 148           SetInputFilter DEFLATE<br />
 149         </indent>
 150         &lt;/Location&gt;
 151       </example>
 152
 153       <p>¿äÃ»¿¡ <code>Content-Encoding: gzip</code> Çì´õ°¡ ÀÖ´Ù¸é
 154       ÀÚµ¿À¸·Î ¾ÐÃàµÈ ³»¿ëÀ» Ç¬´Ù. gzip ¿äÃ»À» ÇÒ ¼ö ÀÖ´Â
 155       ºê¶ó¿ìÀú´Â µå¹°´Ù. ±×·¯³ª ¾î¶² <a
 156       href="http://www.webdav.org">WebDAV</a> Å¬¶óÀÌ¾ðÆ®¿Í °°Àº
 157       Æ¯º°ÇÑ ÇÁ·Î±×·¥Àº ¿äÃ» ¾ÐÃàÀ» Áö¿øÇÑ´Ù.</p>
 158
 159       <note type="warning"><title>Content-Length¿¡ ´ëÇÑ ÁÖÀÇ</title>
 160         <p>¿äÃ» ³»¿ëÀ» Á÷Á¢ »ìÆìº»´Ù¸é, <em><code>Content-Length</code>
 161         Çì´õ¸¦ ¹ÏÁö¸¶¶ó!</em> Content-Length Çì´õ´Â Å¬¶óÀÌ¾ðÆ®°¡
 162         º¸³½ ³»¿ëÀÇ ±æÀÌÀÌÁö, ¾ÐÃàÀ» Ç¬ °á°úÀÇ ¹ÙÀÌÆ®¼ö°¡
 163         <em>¾Æ´Ï´Ù</em>.</p>
 164       </note>
 165     </section>
 166 </section>
 167
 168 <section id="proxies"><title>ÇÁ·Ï½Ã ¼¹ö ´Ù·ç±â</title>
 169
 170     <p><module>mod_deflate</module> ¸ðµâÀº ÇÁ·Ï½Ã°¡ ÀÚ½ÅÀÌ Ä³½¬ÇÑ
 171     ÀÀ´äÀ» ÀûÀýÇÑ <code>Accept-Encoding</code> ¿äÃ» Çì´õ¸¦ º¸³½
 172     Å¬¶óÀÌ¾ðÆ®¿¡°Ô¸¸ º¸³»µµ·Ï <code>Vary:
 173     Accept-Encoding</code> HTTP ÀÀ´ä Çì´õ¸¦ Ãß°¡ÇÑ´Ù. ±×·¡¼
 174     ¾ÐÃàµÈ ³»¿ëÀ» ÀÌÇØÇÒ ¼ö ¾ø´Â Å¬¶óÀÌ¾ðÆ®¿¡ ¾ÐÃàµÈ ³»¿ëÀ»
 175     º¸³»Áö¾Êµµ·Ï ÇÑ´Ù.</p>
 176
 177     <p>¿¹¸¦ µé¾î, <code>User-Agent</code> Çì´õ µî¿¡ µû¶ó Æ¯º°È÷
 178     ÇÊÅÍ Àû¿ëÀ» Ãë¼ÒÇÑ´Ù¸é, ÇÁ·Ï½Ã¿¡°Ô ÀÌ·¯ÇÑ Á¦ÇÑÀ» ¾Ë·ÁÁÖ±âÀ§ÇØ
 179     Á÷Á¢ <code>Vary</code> Çì´õ¿¡ Ãß°¡ÇØ¾ß ÇÑ´Ù. ¿¹¸¦ µé¾î,
 180     ¼³Á¤ÀÌ <code>User-Agent</code>¿¡ µû¶ó <code>DEFLATE</code>
 181     ÇÊÅÍ¸¦ Ãß°¡ÇÑ´Ù¸é ´ÙÀ½À» »ç¿ëÇÑ´Ù:</p>
 182
 183     <example>
 184       Header append Vary User-Agent
 185     </example>
 186
 187     <p>¿äÃ» Çì´õ¿ÜÀÇ ´Ù¸¥ Á¤º¸¿¡ (<em>¿¹¸¦ µé¾î</em>, HTTP ¹öÀü)
 188     µû¶ó ¾ÐÃà ¿©ºÎ°¡ °áÁ¤µÈ´Ù¸é, <code>Vary</code> Çì´õ°ªÀ»
 189     <code>*</code>·Î ¼³Á¤ÇØ¾ß ÇÑ´Ù. ±×·¯¸é Ç¥ÁØÀ» µû¸£´Â ÇÁ·Ï½Ã´Â
 190     Ä³½ÌÀ» ÇÏÁö ¾Ê°Ô µÈ´Ù.</p>
 191
 192     <example><title>¿¹Á¦</title>
 193       Header set Vary *
 194     </example>
 195 </section>
 196
 197 <directivesynopsis>
 198 <name>DeflateFilterNote</name>
 199 <description>¾ÐÃà·üÀ» ·Î±×¿¡ ±â·ÏÇÑ´Ù</description>
 200 <syntax>DeflateFilterNote [<var>type</var>] <var>notename</var></syntax>
 201 <contextlist><context>server config</context><context>virtual host</context>
 202 </contextlist>
 203 <compatibility><var>type</var> is available since Apache 2.0.45</compatibility>
 204
 205 <usage>
 206     <p><directive>DeflateFilterNote</directive> Áö½Ã¾î´Â ¿äÃ»ÀÇ
 207     ¾ÐÃà·üÀ» ·Î±×¿¡ ±â·ÏÇÏ´Â ±âÈ£¸¦ ÁöÁ¤ÇÑ´Ù. ±âÈ£ ÀÌ¸§Àº Áö½Ã¾î·Î
 208     ÁöÁ¤ÇÑ °ªÀÌ´Ù. Åë°è¸¦ À§ÇØ <a href="../logs.html#accesslog">Á¢±Ù
 209     ·Î±×</a>¿¡¼ ±âÈ£¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p>
 210
 211     <example><title>¿¹Á¦</title>
 212       DeflateFilterNote ratio<br />
 213       <br />
 214       LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate<br />
 215       CustomLog logs/deflate_log deflate
 216     </example>
 217
 218     <p>·Î±×¿¡¼ ´õ Á¤È®ÇÑ °ªÀ» ÃßÃâÇÏ·Á¸é <var>type</var> ¾Æ±Ô¸ÕÆ®·Î
 219     ±â·ÏÇÒ ÀÚ·á¸¦ ¼±ÅÃÇÑ´Ù. <var>type</var>´Â ´ÙÀ½Áß ÇÏ³ªÀÌ´Ù:</p>
 220
 221     <dl>
 222       <dt><code>Input</code></dt>
 223       <dd>ÇÊÅÍ ÀÔ·Â½ºÆ®¸²ÀÇ ¹ÙÀÌÆ®¼ö¸¦ ÀúÀåÇÑ´Ù.</dd>
 224
 225       <dt><code>Output</code></dt>
 226       <dd>ÇÊÅÍ Ãâ·Â½ºÆ®¸²ÀÇ ¹ÙÀÌÆ®¼ö¸¦ ÀúÀåÇÑ´Ù..</dd>
 227
 228       <dt><code>Ratio</code></dt>
 229       <dd>¾ÐÃà·üÀ» (<code>output/input * 100</code>) ÀúÀåÇÑ´Ù.
 230        <var>type</var> ¾Æ±Ô¸ÕÆ®¸¦ »ý·«ÇÏ¸é »ç¿ëÇÏ´Â ±âº»°ªÀÌ´Ù.</dd>
 231     </dl>
 232
 233     <p>±×·¡¼ ÀÌ·¸°Ô ·Î±×¿¡ ±â·ÏÇÒ ¼ö ÀÖ´Ù:</p>
 234
 235     <example><title>Á¤¹ÐÇÑ ·Î±×</title>
 236       DeflateFilterNote Input instream<br />
 237       DeflateFilterNote Output outstream<br />
 238       DeflateFilterNote Ratio ratio<br />
 239       <br />
 240       LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate<br />
 241       CustomLog logs/deflate_log deflate
 242     </example>
 243 </usage>
 244 <seealso><module>mod_log_config</module></seealso>
 245 </directivesynopsis>
 246
 247 <directivesynopsis>
 248 <name>DeflateBufferSize</name>
 249 <description>zlibÀÌ ÇÑ¹ø¿¡ ¾ÐÃàÇÒ Å©±â</description>
 250 <syntax>DeflateBufferSize <var>value</var></syntax>
 251 <default>DeflateBufferSize 8096</default>
 252 <contextlist><context>server config</context><context>virtual host</context>
 253 </contextlist>
 254
 255 <usage>
 256     <p><directive>DeflateBufferSize</directive> Áö½Ã¾î´Â zlibÀÌ
 257     ÇÑ¹ø¿¡ ¾ÐÃàÇÒ ¹ÙÀÌÆ®¼ö¸¦ ÁöÁ¤ÇÑ´Ù.</p>
 258 </usage>
 259 </directivesynopsis>
 260
 261 <directivesynopsis>
 262 <name>DeflateWindowSize</name>
 263 <description>Zlib ¾ÐÃà window size</description>
 264 <syntax>DeflateWindowSize <var>value</var></syntax>
 265 <default>DeflateWindowSize 15</default>
 266 <contextlist><context>server config</context><context>virtual host</context>
 267 </contextlist>
 268
 269 <usage>
 270     <p><directive>DeflateWindowSize</directive> Áö½Ã¾î´Â zlib
 271     ¾ÐÃà window size¸¦ (1°ú 15 »çÀÌÀÇ °ª) ÁöÁ¤ÇÑ´Ù. ÀÏ¹ÝÀûÀ¸·Î
 272     window size°¡ Å¬¼ö·Ï ¾ÐÃà·üÀÌ Áõ°¡ÇÑ´Ù.</p>
 273 </usage>
 274 </directivesynopsis>
 275
 276 <directivesynopsis>
 277
 278 <name>DeflateMemLevel</name>
 279 <description>zlibÀÌ ¾ÐÃàÇÒ¶§ »ç¿ëÇÏ´Â ¸Þ¸ð¸®·®</description>
 280 <syntax>DeflateMemLevel <var>value</var></syntax>
 281 <default>DeflateMemLevel 9</default>
 282 <contextlist><context>server config</context><context>virtual host</context>
 283 </contextlist>
 284
 285 <usage>
 286     <p><directive>DeflateMemLevel</directive> Áö½Ã¾î´Â zlibÀÌ
 287     ¾ÐÃàÇÒ¶§ ¾ó¸¶¸¸Å ¸Þ¸ð¸®¸¦ »ç¿ëÇÒÁö °áÁ¤ÇÑ´Ù. (1°ú 9 »çÀÌÀÇ
 288     °ª)</p>
 289 </usage>
 290 </directivesynopsis>
 291
 292 <directivesynopsis>
 293 <name>DeflateCompressionLevel</name>
 294 <description>Ãâ·ÂÀ» ¾ó¸¸Å ¾ÐÃàÇÏ´Â°¡</description>
 295 <syntax>DeflateCompressionLevel <var>value</var></syntax>
 296 <default>Zlib's default</default>
 297 <contextlist><context>server config</context><context>virtual host</context>
 298 </contextlist>
 299 <compatibility>This directive is available since Apache 2.0.45</compatibility>
 300
 301 <usage>
 302     <p><directive>DeflateCompressionLevel</directive> Áö½Ã¾î´Â
 303         »ç¿ëÇÒ ¾ÐÃà¼öÁØÀ» ¼±ÅÃÇÑ´Ù. °ªÀÌ Å¬¼ö·Ï ¾ÐÃà·üÀÌ Áõ°¡ÇÏÁö¸¸,
 304         CPU¸¦ ´õ ¸¹ÀÌ »ç¿ëÇÑ´Ù.</p>
 305     <p>(°¡Àå ´ú ¾ÐÃà) 1°ú (°¡Àå ¸¹ÀÌ ¾ÐÃà) 9 »çÀÌÀÇ °ªÀ» ÁöÁ¤ÇÑ´Ù.</p>
 306 </usage>
 307 </directivesynopsis>
 308
 309
 310 </modulesynopsis>
 311