mod_deflate.xml.ko

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 151405 -->

<!--
 Copyright 2003-2004 The Apache Software Foundation

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_deflate.xml.meta">

<name>mod_deflate</name>
<description>郴侩阑 努扼捞攫飘肺 焊郴扁 傈俊 拘绵茄促</description>
<status>Extension</status>
<sourcefile>mod_deflate.c</sourcefile>
<identifier>deflate_module</identifier>

<summary>
    <p><module>mod_deflate</module> 葛碘篮 辑滚狼 免仿阑 匙飘亏栏肺
    努扼捞攫飘俊 焊郴扁 傈俊 拘绵窍绰 <code>DEFLATE</code> 免仿鞘磐甫
    力傍茄促.</p>
</summary>
<seealso><a href="../filter.html">鞘磐</a></seealso>

<section id="recommended"><title>鼻厘窍绰 汲沥</title>
    <p>鞭茄 荤恩阑 困茄 斑夯 汲沥捞促.</p>

    <example><title>老何 type父 拘绵</title>
      AddOutputFilterByType DEFLATE text/html text/plain text/xml
    </example>

    <p>酒贰 汲沥篮 夸距窍看瘤父 弊贰档 汗棱窍促. 汲沥阑 肯傈洒
    捞秦茄 饶 荤侩窍扼.</p>

    <example><title>捞固瘤甫 力寇茄 葛电 巴阑 拘绵</title>
      &lt;Location /&gt;<br />
      <indent>
        # 鞘磐甫 眠啊茄促<br />
        SetOutputFilter DEFLATE<br />
        <br />
        # Netscape 4.x俊 巩力啊 乐促...<br />
        BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
        <br />
        # Netscape 4.06-4.08俊 歹 巩力啊 乐促<br />
        BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
        <br />
        # MSIE篮 Netscape扼绊 磊脚阑 舅府瘤父, 巩力啊 绝促<br />
        # BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html<br />
        <br />
        # 林狼: 酒颇摹 2.0.48鳖瘤 mod_setenvif狼 滚弊锭巩俊<br />
        # 困狼 沥痹钎泅侥篮 悼累窍瘤 臼绰促. 盔窍绰 瓤苞甫<br />
        # 掘扁困秦 促澜苞 鞍捞 荐沥窍咯 荤侩茄促:<br />
        BrowserMatch \bMSI[E]           !no-gzip !gzip-only-text/html<br />
        <br />
        # 捞固瘤甫 拘绵窍瘤 臼绰促<br />
        SetEnvIfNoCase Request_URI \<br />
        <indent>
          \.(?:gif|jpe?g|png)$ no-gzip dont-vary<br />
        </indent>
        <br />
        # 橇废矫啊 肋给等 郴侩阑 傈崔窍瘤臼档废 茄促<br />
        Header append Vary User-Agent env=!dont-vary<br />
      </indent>
      &lt;/Location&gt;
    </example>

</section>

<section id="enable"><title>拘绵窍扁</title>

    <section id="output"><title>免仿 拘绵</title>
      <p><code>DEFLATE</code> <a href="../filter.html">鞘磐</a>啊
      拘绵阑 茄促. 促澜 瘤矫绢绰 瘤矫绢啊 乐绰 困摹狼 巩辑甫
      拘绵茄促:</p>

      <example>
        SetOutputFilter DEFLATE
      </example>

      <p>葛电 郴侩阑 拘绵窍搁 贸府窍瘤 给窍绰 宏扼快历啊 乐扁锭巩俊
      html 颇老父阑 拘绵窍扁困秦 (酒贰 曼绊)
      <code>gzip-only-text/html</code>阑 <code>1</code>肺 汲沥且瘤档
      葛弗促. 捞甫 <em><code>1</code>捞 酒囱 蔼栏肺</em> 汲沥窍搁
      公矫茄促.</p>
      
      <p>焊烹 漂喊茄 MIME type父 拘绵窍妨搁 <directive module="core"
      >AddOutputFilterByType</directive> 瘤矫绢甫 荤侩茄促.
      促澜 汲沥篮 html 颇老父阑 拘绵茄促:</p>

      <example>
        &lt;Directory "/your-server-root/manual"&gt;<br />
        <indent>
          AddOutputFilterByType DEFLATE text/html<br />
        </indent>
        &lt;/Directory&gt;
      </example>

      <p>拘绵茄 颇老阑 贸府窍瘤 给窍绰 宏扼快历俊霸绰 拘绵窍瘤臼绊
      焊郴辨困秦 <directive module="mod_setenvif"
      >BrowserMatch</directive> 瘤矫绢俊 <code>no-gzip</code>阑
      汲沥茄促. 弥利狼 搬苞甫 掘扁困秦 <code>no-gzip</code>苞
      <code>gzip-only-text/html</code>阑 鞍捞 荤侩且 荐 乐促.
      捞 版快 傈磊啊 饶磊甫 公矫茄促. 困 例狼 <a
      href="#recommended">汲沥 抗力</a> 老何甫 混旗焊磊:</p>

      <example>
        BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
        BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
        BrowserMatch \bMSIE             !no-gzip !gzip-only-text/html
      </example>

      <p>刚历 <code>User-Agent</code> 巩磊凯阑 焊绊 Netscape
      Navigator 滚傈 4.x牢瘤 八荤茄促. 捞 滚傈篮 <code>text/html</code>捞
      酒囱 type狼 拘绵阑 贸府窍瘤 给茄促. 滚傈 4.06, 4.07, 4.08篮
      html 颇老 拘绵阑 贸府窍绰措档 巩力啊 乐促. 弊贰辑 快府绰
      捞 版快 deflate 鞘磐甫 肯傈洒 荤侩窍瘤臼绰促.</p>

      <p>技锅掳 <directive module="mod_setenvif">BrowserMatch</directive>
      瘤矫绢绰 Microsoft Internet Explorer啊 磊脚阑 "Mozilla/4"肺
      舅府瘤父 拘绵等 夸没阑 贸府且 荐 乐扁锭巩俊 user agent
      眠螟阑 荐沥茄促. <code>User-Agent</code> 庆歹俊辑 "MSIE"
      (<code>\b</code>绰 "窜绢 版拌"甫 舵茄促) 巩磊凯阑 惯斑窍搁
      菊俊辑 汲沥茄 力距阑 乾促.</p>

      <note><title>林狼</title>
        <code>DEFLATE</code> 鞘磐绰 亲惑 PHP唱 SSI客 鞍篮 RESOURCE
        鞘磐 第俊 甸绢埃促. 肚, 郴何 窍困夸没(subrequest)俊 康氢阑
        林瘤 臼绰促.
      </note>
    </section>

    <section id="input"><title>涝仿 拘绵钱扁</title>
      <p><module>mod_deflate</module> 葛碘篮 gzip栏肺 拘绵等 夸没
      郴侩阑 仟绰 鞘磐档 力傍茄促. 捞 扁瓷阑 荤侩窍妨搁 促澜苞
      鞍捞 <directive module="core">SetInputFilter</directive>唱
      <directive module="mod_mime">AddInputFilter</directive>甫
      荤侩窍咯 涝仿鞘磐鉴辑俊 <code>DEFLATE</code> 鞘磐甫
      眠啊茄促.</p>

      <example>
        &lt;Location /dav-area&gt;<br />
        <indent>
          SetInputFilter DEFLATE<br />
        </indent>
        &lt;/Location&gt;
      </example>
      
      <p>夸没俊 <code>Content-Encoding: gzip</code> 庆歹啊 乐促搁
      磊悼栏肺 拘绵等 郴侩阑 乾促. gzip 夸没阑 且 荐 乐绰
      宏扼快历绰 靛拱促. 弊矾唱 绢恫 <a
      href="http://www.webdav.org">WebDAV</a> 努扼捞攫飘客 鞍篮
      漂喊茄 橇肺弊伐篮 夸没 拘绵阑 瘤盔茄促.</p>

      <note type="warning"><title>Content-Length俊 措茄 林狼</title>
        <p>夸没 郴侩阑 流立 混旗夯促搁, <em><code>Content-Length</code>
        庆歹甫 瓜瘤付扼!</em> Content-Length 庆歹绰 努扼捞攫飘啊
        焊辰 郴侩狼 辨捞捞瘤, 拘绵阑 乾 搬苞狼 官捞飘荐啊
        <em>酒聪促</em>.</p>
      </note>
    </section>
</section>

<section id="proxies"><title>橇废矫 辑滚 促风扁</title>

    <p><module>mod_deflate</module> 葛碘篮 橇废矫啊 磊脚捞 某浆茄
    览翠阑 利例茄 <code>Accept-Encoding</code> 夸没 庆歹甫 焊辰
    努扼捞攫飘俊霸父 焊郴档废 <code>Vary:
    Accept-Encoding</code> HTTP 览翠 庆歹甫 眠啊茄促. 弊贰辑
    拘绵等 郴侩阑 捞秦且 荐 绝绰 努扼捞攫飘俊 拘绵等 郴侩阑
    焊郴瘤臼档废 茄促.</p>

    <p>抗甫 甸绢, <code>User-Agent</code> 庆歹 殿俊 蝶扼 漂喊洒
    鞘磐 利侩阑 秒家茄促搁, 橇废矫俊霸 捞矾茄 力茄阑 舅妨林扁困秦
    流立 <code>Vary</code> 庆歹俊 眠啊秦具 茄促. 抗甫 甸绢,
    汲沥捞 <code>User-Agent</code>俊 蝶扼 <code>DEFLATE</code>
    鞘磐甫 眠啊茄促搁 促澜阑 荤侩茄促:</p>

    <example>
      Header append Vary User-Agent
    </example>
    
    <p>夸没 庆歹寇狼 促弗 沥焊俊 (<em>抗甫 甸绢</em>, HTTP 滚傈)
    蝶扼 拘绵 咯何啊 搬沥等促搁, <code>Vary</code> 庆歹蔼阑
    <code>*</code>肺 汲沥秦具 茄促. 弊矾搁 钎霖阑 蝶福绰 橇废矫绰
    某浆甫 窍瘤 臼霸 等促.</p>

    <example><title>抗力</title>
      Header set Vary *
    </example>
</section>

<directivesynopsis>
<name>DeflateFilterNote</name>
<description>拘绵伏阑 肺弊俊 扁废茄促</description>
<syntax>DeflateFilterNote [<var>type</var>] <var>notename</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility><var>type</var>篮 酒颇摹 2.0.45 何磐</compatibility>

<usage>
    <p><directive>DeflateFilterNote</directive> 瘤矫绢绰 夸没狼
    拘绵伏阑 肺弊俊 扁废窍绰 扁龋甫 瘤沥茄促. 扁龋 捞抚篮 瘤矫绢肺
    瘤沥茄 蔼捞促. 烹拌甫 困秦 <a href="../logs.html#accesslog">立辟
    肺弊</a>俊辑 扁龋甫 荤侩且 荐 乐促.</p>

    <example><title>抗力</title>
      DeflateFilterNote ratio<br />
      <br />
      LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate<br />
      CustomLog logs/deflate_log deflate
    </example>

    <p>肺弊俊辑 歹 沥犬茄 蔼阑 眠免窍妨搁 <var>type</var> 酒痹刚飘肺
    扁废且 磊丰甫 急琶茄促. <var>type</var>绰 促澜吝 窍唱捞促:</p>

    <dl>
      <dt><code>Input</code></dt>
      <dd>鞘磐 涝仿胶飘覆狼 官捞飘荐甫 历厘茄促.</dd>

      <dt><code>Output</code></dt>
      <dd>鞘磐 免仿胶飘覆狼 官捞飘荐甫 历厘茄促..</dd>

      <dt><code>Ratio</code></dt>
      <dd>拘绵伏阑 (<code>output/input * 100</code>) 历厘茄促.
       <var>type</var> 酒痹刚飘甫 积帆窍搁 荤侩窍绰 扁夯蔼捞促.</dd>
    </dl>

    <p>弊贰辑 捞犯霸 肺弊俊 扁废且 荐 乐促:</p>

    <example><title>沥剐茄 肺弊</title>
      DeflateFilterNote Input instream<br />
      DeflateFilterNote Output outstream<br />
      DeflateFilterNote Ratio ratio<br />
      <br />
      LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate<br />
      CustomLog logs/deflate_log deflate
    </example>
</usage>
<seealso><module>mod_log_config</module></seealso>
</directivesynopsis>

<directivesynopsis>
<name>DeflateBufferSize</name>
<description>zlib捞 茄锅俊 拘绵且 农扁</description>
<syntax>DeflateBufferSize <var>value</var></syntax>
<default>DeflateBufferSize 8096</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>DeflateBufferSize</directive> 瘤矫绢绰 zlib捞
    茄锅俊 拘绵且 官捞飘荐甫 瘤沥茄促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>DeflateWindowSize</name>
<description>Zlib 拘绵 window size</description>
<syntax>DeflateWindowSize <var>value</var></syntax>
<default>DeflateWindowSize 15</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>DeflateWindowSize</directive> 瘤矫绢绰 zlib
    拘绵 window size甫 (1苞 15 荤捞狼 蔼) 瘤沥茄促. 老馆利栏肺
    window size啊 努荐废 拘绵伏捞 刘啊茄促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>

<name>DeflateMemLevel</name>
<description>zlib捞 拘绵且锭 荤侩窍绰 皋葛府樊</description>
<syntax>DeflateMemLevel <var>value</var></syntax>
<default>DeflateMemLevel 9</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>DeflateMemLevel</directive> 瘤矫绢绰 zlib捞
    拘绵且锭 倔付父怒 皋葛府甫 荤侩且瘤 搬沥茄促. (1苞 9 荤捞狼
    蔼)</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>DeflateCompressionLevel</name>
<description>免仿阑 绢蠢沥档 拘绵窍绰啊</description>
<syntax>DeflateCompressionLevel <var>value</var></syntax>
<default>Zlib's default</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>酒颇摹 2.0.45 何磐</compatibility>

<usage>
    <p><directive>DeflateCompressionLevel</directive> 瘤矫绢绰
        荤侩且 拘绵荐霖阑 急琶茄促. 蔼捞 努荐废 拘绵伏捞 刘啊窍瘤父,
        CPU甫 歹 腹捞 荤侩茄促.</p>
    <p>(啊厘 代 拘绵) 1苞 (啊厘 腹捞 拘绵) 9 荤捞狼 蔼阑 瘤沥茄促.</p>
</usage>
</directivesynopsis>


</modulesynopsis>