mod_cache.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_cache.xml.meta">

<name>mod_cache</name>
<description>Content cache keyed to URIs.</description>
<status>Experimental</status>
<sourcefile>mod_cache.c</sourcefile>
<identifier>cache_module</identifier>

<summary>
    <note type="warning">
      捞 葛碘篮 角氰利牢 惑怕捞促. 巩辑绰 酒流 累诀吝捞促...
    </note>

    <p><module>mod_cache</module>绰 鞍篮 哪腔磐俊 乐绰 郴侩捞唱
    橇废矫等 郴侩阑 某浆且 荐 乐绰 <a
    href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>
    龋券 HTTP 郴侩某浆甫 备泅茄促. <module>mod_cache</module>甫
    荤侩窍妨搁 历厘包府葛碘(storage management module)捞 鞘夸窍促.
    扁夯 酒颇摹 硅器夯俊绰 滴啊瘤 历厘包府葛碘捞 乐促:</p>
    <dl>
    <dt><module>mod_disk_cache</module></dt>
    <dd>绰 叼胶农扁馆 历厘包府磊甫 备泅茄促.</dd>

    <dt><module>mod_mem_cache</module></dt>
    <dd>绰 皋葛府扁馆 历厘包府磊甫 备泅茄促.
    <module>mod_mem_cache</module>绰 颇老扁贱磊甫 某浆窍芭唱
    赛(heap) 傍埃俊 按眉甫 某浆窍绰 滴啊瘤 规侥吝 茄啊瘤 规过栏肺
    悼累窍档废 汲沥且 荐 乐促. <module>mod_mem_cache</module>绰
    磊脚捞 积己茄 郴侩阑 某浆窍芭唱, (<dfn>开橇废矫(reverse proxy)</dfn>肺
    舅妨柳) <directive module="mod_proxy">ProxyPass</directive>甫
    荤侩窍咯 <module>mod_proxy</module>甫 困秦 缔窜 辑滚郴侩阑
    某浆且 荐 乐促.</dd>
    </dl>

    <p>郴侩阑 URI甫 配措肺 父电 虐肺 某浆俊 历厘窍绊 啊廉柯促.
    立辟焊龋啊 等 郴侩篮 某浆窍瘤臼绰促.</p>
</summary>

<section id="related"><title>包访等 葛碘苞 瘤矫绢</title>
    <related>
      <modulelist>
        <module>mod_disk_cache</module>
        <module>mod_mem_cache</module>
      </modulelist>
      <directivelist>
        <directive module="mod_disk_cache">CacheRoot</directive>
        <directive module="mod_disk_cache">CacheSize</directive>
        <directive module="mod_disk_cache">CacheGcInterval</directive>
        <directive module="mod_disk_cache">CacheDirLevels</directive>
        <directive module="mod_disk_cache">CacheDirLength</directive>
        <directive module="mod_disk_cache">CacheExpiryCheck</directive>
        <directive module="mod_disk_cache">CacheMinFileSize</directive>
        <directive module="mod_disk_cache">CacheMaxFileSize</directive>
        <directive module="mod_disk_cache">CacheTimeMargin</directive>
        <directive module="mod_disk_cache">CacheGcDaily</directive>
        <directive module="mod_disk_cache">CacheGcUnused</directive>
        <directive module="mod_disk_cache">CacheGcClean</directive>
        <directive module="mod_disk_cache">CacheGcMemUsage</directive>
        <directive module="mod_mem_cache">MCacheSize</directive>
        <directive module="mod_mem_cache">MCacheMaxObjectCount</directive>
        <directive module="mod_mem_cache">MCacheMinObjectSize</directive>
        <directive module="mod_mem_cache">MCacheMaxObjectSize</directive>
        <directive module="mod_mem_cache">MCacheRemovalAlgorithm</directive>
        <directive module="mod_mem_cache">MCacheMaxStreamingBuffer</directive>
      </directivelist>
    </related>
</section>

<section id="sampleconf"><title>汲沥抗</title>
    <example><title>Sample httpd.conf</title>
      #<br />
      # 抗力 某浆 汲沥<br />
      #<br />
      LoadModule cache_module modules/mod_cache.so<br />
      <br />
      &lt;IfModule mod_cache.c&gt;<br />
      <indent>
        #LoadModule disk_cache_module modules/mod_disk_cache.so<br />
        &lt;IfModule mod_disk_cache.c&gt;<br />
        <indent>
          CacheRoot c:/cacheroot<br />
          CacheSize 256<br />
          CacheEnable disk  /<br />
          CacheDirLevels 5<br />
          CacheDirLength 3<br />
        </indent>
        &lt;/IfModule&gt; <br />
        <br />
        LoadModule mem_cache_module modules/mod_mem_cache.so<br />
        &lt;IfModule mod_mem_cache.c&gt;<br />
        <indent>
          CacheEnable mem  /<br />
          MCacheSize 4096<br />
          MCacheMaxObjectCount 100<br />
          MCacheMinObjectSize 1<br />
          MCacheMaxObjectSize 2048<br />
        </indent>
        &lt;/IfModule&gt;<br />
      </indent>
      &lt;/IfModule&gt;
    </example>
</section>

<directivesynopsis>
<name>CacheEnable</name>
<description>瘤沥茄 历厘包府磊甫 荤侩窍咯 瘤沥茄 URL阑 某浆茄促</description>
<syntax>CacheEnable <var>cache_type</var> <var>url-string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>CacheEnable</directive> 瘤矫绢甫 荤侩窍搁
    <module>mod_cache</module>啊 <var>url-string</var> 捞窍
    url甸阑 某浆茄促. 某浆 历厘包府磊绰 <var>cache_type</var>
    酒痹刚飘肺 瘤沥茄促. <var>cache_type</var> <code>mem</code>篮
    <module>mod_mem_cache</module>啊 备泅窍绰 皋葛府扁馆
    历厘包府磊甫 荤侩茄促. <var>cache_type</var> <code>disk</code>绰
    <module>mod_disk_cache</module>啊 备泅窍绰 叼胶农扁馆
    历厘包府磊甫 荤侩茄促. <var>cache_type</var> <code>fd</code>绰
    <module>mod_mem_cache</module>啊 备泅窍绰 颇老扁贱磊 某浆甫
    荤侩茄促.</p>
    <p>(酒贰 抗客 鞍捞) URL 傍埃捞 促弗
    <directive>CacheEnable</directive> 瘤矫绢客 般摹搁 角力肺
    茄 历厘包府磊啊 夸没阑 贸府且锭鳖瘤 滴 历厘包府磊甫 葛滴
    角青茄促. 汲沥颇老俊辑 <directive>CacheEnable</directive>
    瘤矫绢狼 鉴辑措肺 历厘包府磊啊 角青等促.</p>

    <example>
      CacheEnable  mem   /manual<br />
      CacheEnable  fd    /images<br />
      CacheEnable  disk  /<br />
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CacheDisable</name>
<description>漂沥 URL阑 某浆窍瘤 臼绰促</description>
<syntax>CacheDisable <var> url-string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>CacheDisable</directive> 瘤矫绢甫 荤侩窍搁
    <module>mod_cache</module>啊 <var>url-string</var> 捞窍狼
    url甸阑 某浆窍瘤 <em>臼绰促</em>.</p>

    <example><title>抗力</title>
      CacheDisable /local_files
    </example>
</usage>

</directivesynopsis>
<directivesynopsis>
<name>CacheMaxExpire</name>
<description>巩辑甫 某浆窍绰 檬窜困 弥措矫埃</description>
<syntax>CacheMaxExpire <var>seconds</var></syntax>
<default>CacheMaxExpire 86400 (窍风)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>CacheMaxExpire</directive> 瘤矫绢绰 角力 辑滚甫
    八荤窍瘤臼绊 某浆啊瓷茄 HTTP 巩辑甫 蜡瘤且 荐 乐绰 檬窜困
    弥措矫埃阑 瘤沥茄促. 溜, 巩辑绰 弥措茄 捞 汲沥蔼父怒 坷贰登菌促.
    巩辑啊 父扁矫埃阑 瘤沥窍咯档 捞 弥措蔼阑 瘤挪促.</p>

    <example>
      CacheMaxExpire 604800
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CacheDefaultExpire</name>
<description>父扁矫埃阑 瘤沥窍瘤臼篮 巩辑甫 某浆且 扁夯 扁埃.</description>
<syntax>CacheDefaultExpire <var>seconds</var></syntax>
<default>CacheDefaultExpire 3600 (one hour)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive>CacheDefaultExpire</directive> 瘤矫绢绰 巩辑狼
    父扁矫埃苞 弥辟荐沥矫埃捞 绝绰 版快 巩辑甫 某浆且 檬窜困
    扁夯 矫埃阑 瘤沥茄促. <directive>CacheMaxExpire</directive>肺
    瘤沥茄 蔼捞 捞 汲沥阑 公矫窍瘤 <em>臼绰促</em>.</p>

    <example>
      CacheDefaultExpire 86400
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CacheIgnoreNoLastMod</name>
<description>览翠俊 Last Modified 庆歹啊 绝促绰 荤角阑 公矫茄促.</description>
<syntax>CacheIgnoreNoLastMod On|Off</syntax>
<default>CacheIgnoreNoLastMod Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p>焊烹 弥辟荐沥老捞 绝绰 巩辑绰 某浆窍瘤 臼绰促. 绢恫 版快
    弥辟荐沥老阑 (抗甫 甸绢 <module>mod_include</module> 贸府吝俊)
    哗芭唱 贸澜何磐 绝菌阑 荐啊 乐促.
    <directive>CacheIgnoreNoLastMod</directive> 瘤矫绢绰 弥辟荐沥老捞
    绝绰 巩辑档 馆靛矫 某浆窍档废 父电促. 巩辑俊 弥辟荐沥老苞
    父扁矫埃捞 绝绰 版快 <directive>CacheDefaultExpire</directive>
    瘤矫绢肺 瘤沥茄 蔼阑 父扁矫埃栏肺 荤侩茄促.</p>

    <example>
      CacheIgnoreNoLastMod On
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CacheIgnoreCacheControl</name>
<description>努扼捞攫飘啊 某浆窍瘤臼绰 郴侩阑 夸没窃阑 公矫茄促.</description>
<syntax>CacheIgnoreCacheControl On|Off</syntax>
<default>CacheIgnoreCacheControl Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p>焊烹 no-cache唱 no-store 庆歹蔼阑 啊柳 巩辑绰 某浆俊
    历厘窍瘤臼绰促. <directive>CacheIgnoreCacheControl</directive>
    瘤矫绢绰 捞繁 青悼阑 函版茄促.
    <directive>CacheIgnoreCacheControl</directive> On阑 荤侩窍搁
    辑滚绰 巩辑俊 no-cache唱 no-store 庆歹蔼捞 乐绢档 巩辑甫
    某浆茄促. 牢刘捞 鞘夸茄 巩辑绰 <em>例措肺</em> 某浆窍瘤
    臼绰促.</p>

    <example>
      CacheIgnoreCacheControl On
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CacheLastModifiedFactor</name>
<description>LastModified 矫埃栏肺 父扁矫埃阑 拌魂窍绰单 荤侩窍绰
拌荐.</description>
<syntax>CacheLastModifiedFactor <var>float</var></syntax>
<default>CacheLastModifiedFactor 0.1</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p>巩辑俊 父扁矫埃篮 绝瘤父 弥辟荐沥老捞 乐绰 版快 弥辟荐沥老
    捞饶 瘤抄 矫埃栏肺 父扁矫埃阑 拌魂茄促.
    <directive>CacheLastModifiedFactor</directive> 瘤矫绢绰
    父扁矫埃阑 拌魂窍绰 促澜 傍侥俊辑 荤侩且 <var>factor</var>甫
    瘤沥茄促:

    <code>expiry-period = time-since-last-modified-date * <var>factor</var>
    expiry-date = current-date + expiry-period</code>

    抗甫 甸绢, 巩辑啊 10 矫埃 傈俊 付瘤阜栏肺 荐沥登菌绊 <var>factor</var>啊
    0.1捞扼搁 父扁扁埃篮 10*01 = 1 矫埃捞 等促. 泅犁 矫埃捞
    3:00pm捞扼搁 父扁矫埃篮 3:00pm + 1矫埃 = 4:00pm捞促.

    父扁扁埃捞 <directive>CacheMaxExpire</directive> 焊促 辨促搁
    <directive>CacheMaxExpire</directive>甫 荤侩茄促.</p>

    <example>
      CacheLastModifiedFactor 0.5
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CacheForceCompletion</name>
<description>夸没捞 秒家登歹扼档 辑滚啊 颇老阑 拌加 某浆窍扁困秦
鞘夸茄 巩辑狼 辑厚胶伏.</description>
<syntax>CacheForceCompletion <var>Percentage</var></syntax>
<default>CacheForceCompletion 60</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p>焊烹 览翠阑 某浆窍绊 努扼捞攫飘肺 焊郴绰 档吝俊 夸没捞
    秒家登搁 览翠 贸府甫 吝窜登绊 某浆 亲格阑 瘤款促.
    <directive>CacheForceCompletion</directive> 瘤矫绢绰 夸没捞
    秒家登歹扼档 巩辑甫 拌加 某浆且 沥档甫 瘤沥茄促.</p>

    <p>沥档绰 归盒啦肺 唱鸥郴哥 <code>1</code>苞 <code>100</code>
    荤捞狼 蔼捞促. <code>0</code> 蔼阑 瘤沥窍搁 扁夯蔼阑 荤侩茄促.
    <code>100</code>篮 郴侩阑 葛滴 辑厚胶茄 巩辑父阑 某浆茄促.
    60苞 90 荤捞狼 蔼阑 眠玫茄促.</p>

    <example>
      CacheForceCompletion 80
    </example>

    <note type="warning"><title>林狼:</title>
      捞 扁瓷篮 泅犁 备泅登瘤 <em>臼疽促</em>.
    </note>
</usage>
</directivesynopsis>

</modulesynopsis>