d5082de325fb6351c6bd34d28df0b43ec5a8ac90erikabele<?xml version="1.0" encoding="UTF-8" ?>

d5082de325fb6351c6bd34d28df0b43ec5a8ac90erikabele<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>

fd9abdda70912b99b24e3bf1a38f26fde908a74cnd

5a58787efeb02a1c3f06569d019ad81fd2efa06end

5a58787efeb02a1c3f06569d019ad81fd2efa06end<modulesynopsis metafile="mod_cache.xml.meta">

3f08db06526d6901aa08c110b5bc7dde6bc39905nd

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<name>mod_cache</name>

a0e183666b44ebb43fdfeffe78d36c6134a59d4dyoshiki<description>URI をキーにしたコンテンツのキャッシュ</description>

9124bd631acffcf0a44789785377735f172b4b7fgryzor<status>Extension</status>

7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<sourcefile>mod_cache.c</sourcefile>

52ea316008e2581c8113441c9c341e5c65225f6anilgun<identifier>cache_module</identifier>

f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<summary>

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <note type="warning">このモジュールは <directive

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen module="mod_authz_host">Allow</directive> や <directive

d5082de325fb6351c6bd34d28df0b43ec5a8ac90erikabele module="mod_authz_host">Deny</directive> ディレクティブを無視しますので、

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen 注意して使って下さい。クライアントのホスト名、アドレスや環境変数を使って

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen アクセスを制限したいコンテンツに対してはキャッシュ機能を有効にするべきではありません。

d5082de325fb6351c6bd34d28df0b43ec5a8ac90erikabele </note>

1ef822109accf82b8861e22d92fea722f57ae537nd

1ef822109accf82b8861e22d92fea722f57ae537nd <p><module>mod_cache</module> はローカルのコンテンツやプロキシされた

1ef822109accf82b8861e22d92fea722f57ae537nd コンテンツをキャッシュするために使われる <a

5ae30adbe59946de742ab0cd6be3b7457471a698takashi href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> 準拠の

1ef822109accf82b8861e22d92fea722f57ae537nd HTTP コンテンツキャッシュを実装しています。<module>mod_cache</module>

d0d5f51413c1693ffbc910e54253a243889ee571lgentis の動作にはストレージを管理するモジュールが必要です。標準

1ef822109accf82b8861e22d92fea722f57ae537nd Apache 配布には二つストレージ管理モジュールが含まれています:</p>

1ef822109accf82b8861e22d92fea722f57ae537nd

5a58787efeb02a1c3f06569d019ad81fd2efa06end <dl>

5a58787efeb02a1c3f06569d019ad81fd2efa06end <dt><module>mod_disk_cache</module></dt>

5a58787efeb02a1c3f06569d019ad81fd2efa06end <dd>ディスクを使用したストレージ管理機構を実装しています。</dd>

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf <dt><module>mod_mem_cache</module></dt>

5a58787efeb02a1c3f06569d019ad81fd2efa06end <dd>メモリを使用したストレージ管理機構を実装しています。

5a58787efeb02a1c3f06569d019ad81fd2efa06end <module>mod_mem_cache</module> は次の二つのモードのどちらかで動作する

5a58787efeb02a1c3f06569d019ad81fd2efa06end ように設定できます: オープンされているファイル記述子をキャッシュするモードか、

30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh ヒープ上でのオブジェクトの自体をキャッシュをするモードです。

5a58787efeb02a1c3f06569d019ad81fd2efa06end <module>mod_mem_cache</module> はローカルで生成されるコンテンツや、

5a58787efeb02a1c3f06569d019ad81fd2efa06end <module>mod_proxy</module> が

5a58787efeb02a1c3f06569d019ad81fd2efa06end <directive module="mod_proxy">ProxyPass</directive> を使って設定されている

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen ときの (つまり<dfn>リバースプロキシ</dfn> での) バックエンドサーバの

d5082de325fb6351c6bd34d28df0b43ec5a8ac90erikabele コンテンツをキャッシュするのに使えます。</dd>

5a58787efeb02a1c3f06569d019ad81fd2efa06end </dl>

5a58787efeb02a1c3f06569d019ad81fd2efa06end

5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>コンテンツのキャッシュへの保存と取得は URI に基づいたキーが使われます。

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen アクセス保護のかけられているコンテンツはキャッシュされません。</p>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <p>より詳細な解説や例については<a href="/caching.html">キャッシュ機能</a>

d5082de325fb6351c6bd34d28df0b43ec5a8ac90erikabele を参照してください。</p>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen</summary>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<seealso><a href="/caching.html">キャッシュ機能</a></seealso>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<section id="related"><title>関連モジュールとディレクティブ</title>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <related>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <modulelist>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <module>mod_disk_cache</module>

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh <module>mod_mem_cache</module>

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh </modulelist>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directivelist>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_disk_cache">CacheRoot</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_disk_cache">CacheDirLevels</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_disk_cache">CacheDirLength</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_disk_cache">CacheMinFileSize</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_disk_cache">CacheMaxFileSize</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_mem_cache">MCacheSize</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_mem_cache">MCacheMaxObjectCount</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_mem_cache">MCacheMinObjectSize</directive>

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh <directive module="mod_mem_cache">MCacheMaxObjectSize</directive>

419d55842022e9e257941bfe226549661fb2c6c7humbedooh <directive module="mod_mem_cache">MCacheRemovalAlgorithm</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <directive module="mod_mem_cache">MCacheMaxStreamingBuffer</directive>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen </directivelist>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen </related>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen</section>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<section id="sampleconf"><title>サンプル設定</title>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <example><title>Sample httpd.conf</title>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen #<br />

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh # Sample Cache Configuration<br />

419d55842022e9e257941bfe226549661fb2c6c7humbedooh #<br />

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen LoadModule cache_module modules/mod_cache.so<br />

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <br />

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen &lt;IfModule mod_cache.c&gt;<br />

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <indent>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen #LoadModule disk_cache_module modules/mod_disk_cache.so<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl # If you want to use mod_disk_cache instead of mod_mem_cache,<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl # uncomment the line above and comment out the LoadModule line below.<br />

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh &lt;IfModule mod_disk_cache.c&gt;<br />

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh <indent>

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl CacheRoot c:/cacheroot<br />

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf CacheEnable disk /<br />

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf CacheDirLevels 5<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl CacheDirLength 3<br />

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf </indent>

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl &lt;/IfModule&gt; <br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl <br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl LoadModule mem_cache_module modules/mod_mem_cache.so<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl &lt;IfModule mod_mem_cache.c&gt;<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl <indent>

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl CacheEnable mem /<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl MCacheSize 4096<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl MCacheMaxObjectCount 100<br />

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf MCacheMinObjectSize 1<br />

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh MCacheMaxObjectSize 2048<br />

419d55842022e9e257941bfe226549661fb2c6c7humbedooh </indent>

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf &lt;/IfModule&gt;<br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl <br />

f61ec47ec494705bd2d02b5b6fe021e5c193f2c8noodl # When acting as a proxy, don't cache the list of security updates<br />

82178a3043043b8813c0d7288a06ca1b7d110d4atakashi CacheDisable http://security.update.server/update-list/<br />

5a58787efeb02a1c3f06569d019ad81fd2efa06end </indent>

5a58787efeb02a1c3f06569d019ad81fd2efa06end &lt;/IfModule&gt;

9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf </example>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen</section>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<directivesynopsis>

9fc1345bb54ea7f68c2e59ff3a618c1237a30918yoshiki<name>CacheEnable</name>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<description>指定したストレージ管理方式を使ってのキャッシュを有効にする</description>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<syntax>CacheEnable <var>cache_type</var> <var>url-string</var></syntax>

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh<contextlist><context>server config</context><context>virtual host</context>

419d55842022e9e257941bfe226549661fb2c6c7humbedooh</contextlist>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<usage>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <p><directive>CacheEnable</directive> ディレクティブで <module>mod_cache</module>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen モジュールが <var>url-string</var> 以下の URL をキャッシュするようにします。

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen キャッシュストレージ管理方式は <var>cache_type</var> 引数で指定します。

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <var>cache_type</var> <code> mem</code> で、

e9425c93ba098a7844e138a61e1be5f46d2aa2ddnd <module>mod_mem_cache</module> で実装されているメモリを使ったストレージ

4aa603e6448b99f9371397d439795c91a93637eand 管理方式を使うように <module>mod_cache</module> に指示します。

419d55842022e9e257941bfe226549661fb2c6c7humbedooh <var>cache_type</var> <code>disk</code> で、

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <module>mod_disk_cache</module> で実装されているディスクを使ったストレージ

6479b1452f7ec14b0127746014e88595d6ace7d6erikabele 管理を使うように <module>mod_cache</module> に指示します。

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <var>cache_type</var> <code>fd</code> は <module>mod_cache</module> に

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <module>mod_mem_cache</module> により実装されているファイル記述子の

5a58787efeb02a1c3f06569d019ad81fd2efa06end キャッシュを使うように指示します。</p>

5a58787efeb02a1c3f06569d019ad81fd2efa06end

5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>(下の例のように) <directive>CacheEnable</directive> ディレクティブの

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen URL 空間が重複しているときは、該当するストレージ方式を順に試して、

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen 実際にリクエストの処理ができると、その方式で処理します。

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen ストレージ管理方式が実行される順番は設定ファイル中の

255ed74976dd24871155a672050d5c61ee2c3a92slive <directive>CacheEnable</directive> の順番により決定されます。</p>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <example>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen CacheEnable mem /manual<br />

1f1b6bf13313fdd14a45e52e553d3ff28689b717coar CacheEnable fd /images<br />

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh CacheEnable disk /<br />

15292da5451dea4ad10c12d35d9addc88be302c5humbedooh </example>

4aa603e6448b99f9371397d439795c91a93637eand

419d55842022e9e257941bfe226549661fb2c6c7humbedooh <p>フォワードプロクシサーバとして動作する場合、

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen <var>url-string</var> を使って、キャッシュを有効にするリモートサイトや

570774ea3ec6ce8795d6db447049c9393266b660rbowen プロクシプロトコルを指定することもできます。</p>

570774ea3ec6ce8795d6db447049c9393266b660rbowen

570774ea3ec6ce8795d6db447049c9393266b660rbowen <example>

570774ea3ec6ce8795d6db447049c9393266b660rbowen # Cache proxied url's<br />

570774ea3ec6ce8795d6db447049c9393266b660rbowen CacheEnable disk /<br /><br />

570774ea3ec6ce8795d6db447049c9393266b660rbowen # Cache FTP-proxied url's<br />

570774ea3ec6ce8795d6db447049c9393266b660rbowen CacheEnable disk ftp://<br /><br />

570774ea3ec6ce8795d6db447049c9393266b660rbowen # Cache content from www.apache.org<br />

5a58787efeb02a1c3f06569d019ad81fd2efa06end CacheEnable disk http://www.apache.org/<br />

5a58787efeb02a1c3f06569d019ad81fd2efa06end </example>

5a58787efeb02a1c3f06569d019ad81fd2efa06end

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen</usage>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen</directivesynopsis>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<directivesynopsis>

48ccea56fcdba3161aaf11b8157aa5d58e22bc32jailletc<name>CacheDisable</name>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<description>特定の URL をキャッシュしない</description>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<syntax>CacheDisable <var> url-string</var></syntax>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen<contextlist><context>server config</context><context>virtual host</context>

47bbfaa3a2ea0afb775a3aa3e7dbf8a71ea1b966rbowen</contextlist>

5a58787efeb02a1c3f06569d019ad81fd2efa06end

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<usage>

a0e183666b44ebb43fdfeffe78d36c6134a59d4dyoshiki <p><directive>CacheDisable</directive> ディレクティブで

9124bd631acffcf0a44789785377735f172b4b7fgryzor <module>mod_cache</module> モジュールが <var>url-string</var> 以下の

7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd URL をキャッシュ<em>しない</em>ようにします。</p>

52ea316008e2581c8113441c9c341e5c65225f6anilgun

f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung <example><title>例</title>

ed62c84ee0911cfebbd8da319ac00757b555707chumbedooh CacheDisable /local_files

0d0ba3a410038e179b695446bb149cce6264e0abnd </example>

ed62c84ee0911cfebbd8da319ac00757b555707chumbedooh</usage>

cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh

0d0ba3a410038e179b695446bb149cce6264e0abnd</directivesynopsis>

cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh<directivesynopsis>

ed62c84ee0911cfebbd8da319ac00757b555707chumbedooh<name>CacheMaxExpire</name>

0d0ba3a410038e179b695446bb149cce6264e0abnd<description>ドキュメントをキャッシュする最大時間を秒数で表したもの</description>

0d0ba3a410038e179b695446bb149cce6264e0abnd<syntax>CacheMaxExpire <var>seconds</var></syntax>

0d0ba3a410038e179b695446bb149cce6264e0abnd<default>CacheMaxExpire 86400 (一日)</default>

ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh<contextlist><context>server config</context><context>virtual host</context>

0d0ba3a410038e179b695446bb149cce6264e0abnd</contextlist>

0d0ba3a410038e179b695446bb149cce6264e0abnd

0d0ba3a410038e179b695446bb149cce6264e0abnd<usage>

ed62c84ee0911cfebbd8da319ac00757b555707chumbedooh <p><directive>CacheMaxExpire</directive> ディレクティブは、

0d0ba3a410038e179b695446bb149cce6264e0abnd キャッシュする HTTP ドキュメントを、元のサーバに問い合わせないまま最大何秒

0d0ba3a410038e179b695446bb149cce6264e0abnd 保持してもよいかを指定します。つまり、ドキュメントは最大でこの秒数間ぶん古く

30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh なることになります。この最大値は、<transnote>レスポンス中で</transnote>ドキュメントと共に

205f749042ed530040a4f0080dbcb47ceae8a374rjung ドキュメントの期日が提供されている場合でも適用されます。</p>

af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen

0d0ba3a410038e179b695446bb149cce6264e0abnd <example>

7fec19672a491661b2fe4b29f685bc7f4efa64d4nd CacheMaxExpire 604800

7fec19672a491661b2fe4b29f685bc7f4efa64d4nd </example>

7fec19672a491661b2fe4b29f685bc7f4efa64d4nd</usage>

5a58787efeb02a1c3f06569d019ad81fd2efa06end</directivesynopsis>

<directivesynopsis>

<name>CacheMinExpire</name>

<description>ドキュメントをキャッシュする最小秒数</description>

<syntax>CacheMinExpire <var>seconds</var></syntax>

<default>CacheMinExpire 0</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>キャッシュ可能な HTTP ドキュメントがあったときに、オリジンサーバに問い合わせることなく

保持する秒数の最小値は <directive>CacheMinExpire</directive> ディレクティブを使って設定します。

この値は、ドキュメントに妥当な有効期限が指定されていなかった場合にのみ使われます。</p>

<example>

CacheMinExpire 3600

</example>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheDefaultExpire</name>

<description>期日が指定されていないときにドキュメントをキャッシュするデフォルトの期間</description>

<syntax>CacheDefaultExpire <var>seconds</var></syntax>

<default>CacheDefaultExpire 3600 (1時間)</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p><directive>CacheDefaultExpire</directive> ディレクティブは、ドキュメントに

有効期限 (expiry) や最終修正時刻 (last-modified) が指定されていない場合の

デフォルトの時間を指定します。<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>通常、Last-Modified による最終修正時刻の無いドキュメントはキャッシュ

されません。(例えば <module>mod_include</module> による処理のときなどに)

Last-Modified 時刻が消去されたり、そもそも最初から提供されていない

状況があります。<directive>CacheIgnoreNoLastMod</directive>

ディレクティブを使うと、Last-Modified 日時が指定されていない

ドキュメントでもキャッシュするように指定できます。ドキュメントに

最終修正時刻 (Last-Modified) 有効期限 (expiry) がない場合は、有効期限の

生成に <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>Cache-Control: no-cache ヘッダや Pragma: no-store ヘッダのあるリクエストに

対しては、通常キャッシュを使いません。<directive>CacheIgnoreCacheControl</directive>

ディレクティブを使うと、この動作を上書きできます。

<directive>CacheIgnoreCacheControl</directive> On とすると、

リクエストに no-cache という値があっても、キャッシュを使ってドキュメントを

返すようになります。認証を必要とするドキュメントは<em>決して</em>

キャッシュされません。</p>

<example>

CacheIgnoreCacheControl On

</example>

<note type="warning"><title>警告</title>

このディレクティブを使うと、ドキュメント取得時にキャッシュを使わないように

クライアントがリクエストしているにもかかわらず、キャッシュを

使うようになります。その結果、

古いコンテンツが送られ続けることになってしまうかもしれません。

</note>

</usage>

<seealso><directive module="mod_cache">CacheStorePrivate</directive></seealso>

<seealso><directive module="mod_cache">CacheStoreNoStore</directive></seealso>

</directivesynopsis>

<directivesynopsis>

<name>CacheIgnoreQueryString</name>

<description>キャッシュ時にクエリーストリングを無視する</description>

<syntax>CacheIgnoreQueryString On|Off</syntax>

<default>CacheIgnoreQueryString Off</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>クエリーストリング付のリクエストについては通常、クエリーストリングごとに

個別にキャッシュされます。

キャッシュされるのは有効期限が指定されている場合のみで、これは

RFC 2616/13.9 に従ったものです。

<directive>CacheIgnoreQueryString</directive> ディレクティブを使うと

有効期限が指定されていなくてもキャッシュしますし、

クエリーストリングが異なっていてもキャッシュを返します。

このディレクティブが有効になっている場合、キャッシュ機能の側面からみると、

あたかもリクエストにクエリーストリングがついていなかったかのように扱います。</p>

<example>

CacheIgnoreQueryString On

</example>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheLastModifiedFactor</name>

<description>LastModified の日付に基づいて有効期限 (expiry)

を計算するための重みを指定する

</description>

<syntax>CacheLastModifiedFactor <var>float</var></syntax>

<default>CacheLastModifiedFactor 0.1</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>ドキュメントに Last-Modified の日付が無いけれども有効期限 (expiry)

の日付があるというときに、有効期限を最終修正時刻からの経過時間として

計算するようにできます。有効期限を次の計算式に従って生成するのですが、

そのときに使われる <var>factor</var> を

<directive>CacheLastModifiedFactor</directive> ディレクティブで指定します。

</p>

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

expiry-date = current-date + expiry-period</code></p>

<p>例えば、ドキュメントが 10 時間前に最後に修正されていて、

<var>factor</var> が 0.1 であれば、期日は 10*0.1 = 1 時間に

設定されます。現在時刻が 3:00pm であれば、計算された期日は

3:00pm + 1hour = 4:00pm になります。</p>

<p>期日が <directive>CacheMaxExpire</directive> で設定されている値

より大きくなってしまっている場合は、<directive>CacheMaxExpire</directive>

の設定値が優先されます。</p>

<example>

CacheLastModifiedFactor 0.5

</example>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheIgnoreHeaders</name>

<description>指定された HTTP ヘッダをキャッシュに保存しない。

</description>

<syntax>CacheIgnoreHeaders <var>header-string</var> [<var>header-string</var>] ...</syntax>

<default>CacheIgnoreHeaders None</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>RFC 2616 によると、hop-by-hop HTTP ヘッダはキャッシュには保管されません。

以下のヘッダは hop-by-hop ヘッダに該当しますので、

<directive>CacheIgnoreHeaders</directive>

の設定に<em>関係なく</em>キャッシュには保管されません:</p>

<ul>

<li><code>Connection</code></li>

<li><code>Keep-Alive</code></li>

<li><code>Proxy-Authenticate</code></li>

<li><code>Proxy-Authorization</code></li>

<li><code>TE</code></li>

<li><code>Trailers</code></li>

<li><code>Transfer-Encoding</code></li>

<li><code>Upgrade</code></li>

</ul>

<p><directive>CacheIgnoreHeaders</directive> で

キャッシュに保管しない追加の HTTP ヘッダを指定します。

例えば、クッキーをキャッシュに保管しないようにした方がよい場合も

あるでしょう。</p>

<p><directive>CacheIgnoreHeaders</directive> の引数は、

キャッシュに保管しない HTTP ヘッダを空白区切りにしたリスト形式です。

キャッシュに保管しないヘッダが hop-by-hop ヘッダだけの場合

(RFC 2616 準拠の動作のとき) は、

<directive>CacheIgnoreHeaders</directive> を <code>None</code>

に設定できます。</p>

<example><title>例 1</title>

CacheIgnoreHeaders Set-Cookie

</example>

<example><title>例 2</title>

CacheIgnoreHeaders None

</example>

<note type="warning"><title>警告:</title>

<code>Expires</code> のような適切のキャッシュ管理のために必要な

ヘッダが <directive>CacheIgnoreHeaders</directive> の設定により

保管されていないときは、mod_cache の動作は定義されていません。

</note>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheStorePrivate</name>

<description>private と指定されているレスポンスのキャッシュを試みる。</description>

<syntax>CacheStorePrivate On|Off</syntax>

<default>CacheStorePrivate Off</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>通常 Cache-Control: private ヘッダのついているレスポンスは

キャッシュされません。<directive>CacheStorePrivate</directive>

ディレクティブでこの挙動を上書きできます。

<directive>CacheStorePrivate</directive> On で private ヘッダのついている

リソースに対してもキャッシュを試みるようになります。

ただし認証の求められるリソースは <em>決して</em> キャッシュされません。</p>

<example>

CacheStorePrivate On

</example>

<note type="warning"><title>警告:</title>

上流サーバがキャッシュしないように指定してきても、

それを無視してキャッシュするようになります。

望ましい挙動になるのは、本当に 'private' なキャッシュについてのみでしょう。

</note>

</usage>

<seealso><directive module="mod_cache">CacheIgnoreCacheControl</directive></seealso>

<seealso><directive module="mod_cache">CacheStoreNoStore</directive></seealso>

</directivesynopsis>

<directivesynopsis>

<name>CacheStoreNoStore</name>

<description>no-store と指定されているレスポンスのキャッシュを試みる。</description>

<syntax>CacheStoreNoStore On|Off</syntax>

<default>CacheStoreNoStore Off</default>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>通常 Cache-Control: no-store ヘッダのついているレスポンスは

キャッシュされません。<directive>CacheStoreNoCache</directive>

ディレクティブでこの挙動を上書きできます。

<directive>CacheStoreNoCache</directive> On で no-store ヘッダのついている

リソースに対してもキャッシュを試みるようになります。

ただし認証の求められるリソースは <em>決して</em> キャッシュされません。</p>

<example>

CacheStoreNoStore On

</example>

<note type="warning"><title>警告:</title>

RFC 2616 に記載されているように no-store ディレクティブは、

"不注意による機密情報の漏洩や残留 (バックアップテープ等) を防ぐ"

目的で使われますが、このオプションを有効にすると、

機密情報を保持することになってしまいます。

ですので、ここで警告しておきます。

</note>

</usage>

<seealso><directive module="mod_cache">CacheIgnoreCacheControl</directive></seealso>

<seealso><directive module="mod_cache">CacheStorePrivate</directive></seealso>

</directivesynopsis>

</modulesynopsis>