granicus.if.org Git - apache/blob - docs/manual/mod/mod_cache.html.ja.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_cache - Apache HTTP サーバ</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
  16 <p class="apache">Apache HTTP サーバ バージョン 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン
  21             2.3</a> &gt; <a href="./">モジュール</a></div>
  22 <div id="page-content">
  23 <div id="preamble"><h1>Apache モジュール mod_cache</h1>
  24 <div class="toplang">
  25 <p><span>言語: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  26 <a href="../fr/mod/mod_cache.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  27 <a href="../ja/mod/mod_cache.html" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  29 </div>
  30 <div class="outofdate">この日本語訳はすでに古くなっている可能性があります。
  31           更新された内容を見るには英語版をご覧下さい。</div>
  32 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>URI をキーにしたコンテンツのキャッシュ</td></tr>
  33 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
  34 <tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>cache_module</td></tr>
  35 <tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_cache.c</td></tr></table>
  36 <h3>概要</h3>
  37
  38     <div class="warning">このモジュールは <code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code> や <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> ディレクティブを無視しますので、
  39     注意して使って下さい。クライアントのホスト名、アドレスや環境変数を使って
  40     アクセスを制限したいコンテンツに対してはキャッシュ機能を有効にするべきではありません。
  41     </div>
  42
  43     <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> はローカルのコンテンツやプロキシされた
  44     コンテンツをキャッシュするために使われる <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> 準拠の
  45     HTTP コンテンツキャッシュを実装しています。<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
  46     の動作にはストレージを管理するモジュールが必要です。標準
  47     Apache 配布には二つストレージ管理モジュールが含まれています:</p>
  48
  49     <dl>
  50     <dt><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></dt>
  51     <dd>ディスクを使用したストレージ管理機構を実装しています。</dd>
  52
  53     <dt><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code></dt>
  54     <dd>メモリを使用したストレージ管理機構を実装しています。
  55     <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> は次の二つのモードのどちらかで動作する
  56     ように設定できます: オープンされているファイル記述子をキャッシュするモードか、
  57     ヒープ上でのオブジェクトの自体をキャッシュをするモードです。
  58     <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> はローカルで生成されるコンテンツや、
  59     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> が
  60     <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> を使って設定されている
  61     ときの (つまり<dfn>リバースプロキシ</dfn> での) バックエンドサーバの
  62     コンテンツをキャッシュするのに使えます。</dd>
  63     </dl>
  64
  65     <p>コンテンツのキャッシュへの保存と取得は URI に基づいたキーが使われます。
  66     アクセス保護のかけられているコンテンツはキャッシュされません。</p>
  67     <p>より詳細な解説や例については<a href="../caching.html">キャッシュ機能</a>
  68     を参照してください。</p>
  69 </div>
  70 <div id="quickview"><h3 class="directives">ディレクティブ</h3>
  71 <ul id="toc">
  72 <li><img alt="" src="../images/down.gif" /> <a href="#cachedefaultexpire">CacheDefaultExpire</a></li>
  73 <li><img alt="" src="../images/down.gif" /> <a href="#cachedisable">CacheDisable</a></li>
  74 <li><img alt="" src="../images/down.gif" /> <a href="#cacheenable">CacheEnable</a></li>
  75 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignoreheaders">CacheIgnoreHeaders</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorenolastmod">CacheIgnoreNoLastMod</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorequerystring">CacheIgnoreQueryString</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#cachelastmodifiedfactor">CacheLastModifiedFactor</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#cachemaxexpire">CacheMaxExpire</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#cacheminexpire">CacheMinExpire</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#cachestorenostore">CacheStoreNoStore</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#cachestoreprivate">CacheStorePrivate</a></li>
  84 </ul>
  85 <h3>トピック</h3>
  86 <ul id="topics">
  87 <li><img alt="" src="../images/down.gif" /> <a href="#related">関連モジュールとディレクティブ</a></li>
  88 <li><img alt="" src="../images/down.gif" /> <a href="#sampleconf">サンプル設定</a></li>
  89 </ul><h3>参照</h3>
  90 <ul class="seealso">
  91 <li><a href="../caching.html">キャッシュ機能</a></li>
  92 </ul></div>
  93 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  94 <div class="section">
  95 <h2><a name="related" id="related">関連モジュールとディレクティブ</a></h2>
  96     <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></li><li><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_disk_cache.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="../mod/mod_disk_cache.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="../mod/mod_disk_cache.html#cacheminfilesize">CacheMinFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_disk_cache.html#cachemaxfilesize">CacheMaxFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_mem_cache.html#mcachesize">MCacheSize</a></code></li><li><code class="directive"><a href="../mod/mod_mem_cache.html#mcachemaxobjectcount">MCacheMaxObjectCount</a></code></li><li><code class="directive"><a href="../mod/mod_mem_cache.html#mcacheminobjectsize">MCacheMinObjectSize</a></code></li><li><code class="directive"><a href="../mod/mod_mem_cache.html#mcachemaxobjectsize">MCacheMaxObjectSize</a></code></li><li><code class="directive"><a href="../mod/mod_mem_cache.html#mcacheremovalalgorithm">MCacheRemovalAlgorithm</a></code></li><li><code class="directive"><a href="../mod/mod_mem_cache.html#mcachemaxstreamingbuffer">MCacheMaxStreamingBuffer</a></code></li></ul></td></tr></table>
  97 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  98 <div class="section">
  99 <h2><a name="sampleconf" id="sampleconf">サンプル設定</a></h2>
 100     <div class="example"><h3>Sample httpd.conf</h3><p><code>
 101       #<br />
 102       # Sample Cache Configuration<br />
 103       #<br />
 104       LoadModule cache_module modules/mod_cache.so<br />
 105       <br />
 106       &lt;IfModule mod_cache.c&gt;<br />
 107       <span class="indent">
 108         #LoadModule disk_cache_module modules/mod_disk_cache.so<br />
 109         # If you want to use mod_disk_cache instead of mod_mem_cache,<br />
 110         # uncomment the line above and comment out the LoadModule line below.<br />
 111         &lt;IfModule mod_disk_cache.c&gt;<br />
 112         <span class="indent">
 113           CacheRoot c:/cacheroot<br />
 114           CacheEnable disk  /<br />
 115           CacheDirLevels 5<br />
 116           CacheDirLength 3<br />
 117         </span>
 118         &lt;/IfModule&gt; <br />
 119         <br />
 120         LoadModule mem_cache_module modules/mod_mem_cache.so<br />
 121         &lt;IfModule mod_mem_cache.c&gt;<br />
 122         <span class="indent">
 123           CacheEnable mem  /<br />
 124           MCacheSize 4096<br />
 125           MCacheMaxObjectCount 100<br />
 126           MCacheMinObjectSize 1<br />
 127           MCacheMaxObjectSize 2048<br />
 128         </span>
 129         &lt;/IfModule&gt;<br />
 130         <br />
 131         # When acting as a proxy, don't cache the list of security updates<br />
 132         CacheDisable http://security.update.server/update-list/<br />
 133       </span>
 134       &lt;/IfModule&gt;
 135     </code></p></div>
 136 </div>
 137 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 138 <div class="directive-section"><h2><a name="CacheDefaultExpire" id="CacheDefaultExpire">CacheDefaultExpire</a> <a name="cachedefaultexpire" id="cachedefaultexpire">ディレクティブ</a></h2>
 139 <table class="directive">
 140 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>期日が指定されていないときにドキュメントをキャッシュするデフォルトの期間</td></tr>
 141 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheDefaultExpire <var>seconds</var></code></td></tr>
 142 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheDefaultExpire 3600 (1時間)</code></td></tr>
 143 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 144 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 145 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 146 </table>
 147     <p><code class="directive">CacheDefaultExpire</code> ディレクティブは、ドキュメントに
 148     有効期限 (expiry) や最終修正時刻 (last-modified) が指定されていない場合の
 149     デフォルトの時間を指定します。<code class="directive">CacheMaxExpire</code>
 150     ディレクティブで指定された値はこの設定を上書き<em>しません</em>。</p>
 151
 152     <div class="example"><p><code>
 153       CacheDefaultExpire 86400
 154     </code></p></div>
 155
 156 </div>
 157 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 158 <div class="directive-section"><h2><a name="CacheDisable" id="CacheDisable">CacheDisable</a> <a name="cachedisable" id="cachedisable">ディレクティブ</a></h2>
 159 <table class="directive">
 160 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>特定の URL をキャッシュしない</td></tr>
 161 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheDisable <var> url-string</var></code></td></tr>
 162 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 163 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 164 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 165 </table>
 166     <p><code class="directive">CacheDisable</code> ディレクティブで
 167     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> モジュールが <var>url-string</var> 以下の
 168     URL をキャッシュ<em>しない</em>ようにします。</p>
 169
 170     <div class="example"><h3>例</h3><p><code>
 171       CacheDisable /local_files
 172     </code></p></div>
 173
 174 </div>
 175 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 176 <div class="directive-section"><h2><a name="CacheEnable" id="CacheEnable">CacheEnable</a> <a name="cacheenable" id="cacheenable">ディレクティブ</a></h2>
 177 <table class="directive">
 178 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>指定したストレージ管理方式を使ってのキャッシュを有効にする</td></tr>
 179 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheEnable <var>cache_type</var> <var>url-string</var></code></td></tr>
 180 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 181 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 182 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 183 </table>
 184     <p><code class="directive">CacheEnable</code> ディレクティブで <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
 185     モジュールが <var>url-string</var> 以下の URL をキャッシュするようにします。
 186     キャッシュストレージ管理方式は <var>cache_type</var> 引数で指定します。
 187     <var>cache_type</var> <code> mem</code> で、
 188     <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> で実装されているメモリを使ったストレージ
 189     管理方式を使うように <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> に指示します。
 190     <var>cache_type</var> <code>disk</code> で、
 191     <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> で実装されているディスクを使ったストレージ
 192     管理を使うように <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> に指示します。
 193     <var>cache_type</var> <code>fd</code> は <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> に
 194     <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> により実装されているファイル記述子の
 195     キャッシュを使うように指示します。</p>
 196
 197     <p>(下の例のように) <code class="directive">CacheEnable</code> ディレクティブの
 198     URL 空間が重複しているときは、該当するストレージ方式を順に試して、
 199     実際にリクエストの処理ができると、その方式で処理します。
 200     ストレージ管理方式が実行される順番は設定ファイル中の
 201     <code class="directive">CacheEnable</code> の順番により決定されます。</p>
 202
 203     <div class="example"><p><code>
 204       CacheEnable  mem   /manual<br />
 205       CacheEnable  fd    /images<br />
 206       CacheEnable  disk  /<br />
 207     </code></p></div>
 208
 209     <p>フォワードプロクシサーバとして動作する場合、
 210     <var>url-string</var> を使って、キャッシュを有効にするリモートサイトや
 211     プロクシプロトコルを指定することもできます。</p>
 212
 213     <div class="example"><p><code>
 214       # Cache proxied url's<br />
 215       CacheEnable  disk  /<br /><br />
 216       # Cache FTP-proxied url's<br />
 217       CacheEnable  disk  ftp://<br /><br />
 218       # Cache content from www.apache.org<br />
 219       CacheEnable  disk  http://www.apache.org/<br />
 220     </code></p></div>
 221
 222
 223 </div>
 224 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 225 <div class="directive-section"><h2><a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a> <a name="cacheignorecachecontrol" id="cacheignorecachecontrol">ディレクティブ</a></h2>
 226 <table class="directive">
 227 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>キャッシュされているコンテンツを返さないようにクライアントから
 228 リクエストされても無視する</td></tr>
 229 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheIgnoreCacheControl On|Off</code></td></tr>
 230 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheIgnoreCacheControl Off</code></td></tr>
 231 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 232 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 233 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 234 </table>
 235     <p>Cache-Control: no-cache ヘッダや Pragma: no-store ヘッダのあるリクエストに
 236     対しては、通常キャッシュを使いません。<code class="directive">CacheIgnoreCacheControl</code>
 237     ディレクティブを使うと、この動作を上書きできます。
 238     <code class="directive">CacheIgnoreCacheControl</code> On とすると、
 239     リクエストに no-cache という値があっても、キャッシュを使ってドキュメントを
 240     返すようになります。認証を必要とするドキュメントは<em>決して</em>
 241     キャッシュされません。</p>
 242
 243     <div class="example"><p><code>
 244       CacheIgnoreCacheControl On
 245     </code></p></div>
 246
 247     <div class="warning"><h3>警告</h3>
 248        このディレクティブを使うと、ドキュメント取得時にキャッシュを使わないように
 249        クライアントがリクエストしているにもかかわらず、キャッシュを
 250        使うようになります。その結果、
 251        古いコンテンツが送られ続けることになってしまうかもしれません。
 252     </div>
 253
 254 <h3>参照</h3>
 255 <ul>
 256 <li><code class="directive"><a href="#cachestoreprivate">CacheStorePrivate</a></code></li>
 257 <li><code class="directive"><a href="#cachestorenostore">CacheStoreNoStore</a></code></li>
 258 </ul>
 259 </div>
 260 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 261 <div class="directive-section"><h2><a name="CacheIgnoreHeaders" id="CacheIgnoreHeaders">CacheIgnoreHeaders</a> <a name="cacheignoreheaders" id="cacheignoreheaders">ディレクティブ</a></h2>
 262 <table class="directive">
 263 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>指定された HTTP ヘッダをキャッシュに保存しない。
 264 </td></tr>
 265 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheIgnoreHeaders <var>header-string</var> [<var>header-string</var>] ...</code></td></tr>
 266 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheIgnoreHeaders None</code></td></tr>
 267 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 268 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 269 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 270 </table>
 271     <p>RFC 2616 によると、hop-by-hop HTTP ヘッダはキャッシュには保管されません。
 272     以下のヘッダは hop-by-hop ヘッダに該当しますので、
 273     <code class="directive">CacheIgnoreHeaders</code>
 274     の設定に<em>関係なく</em>キャッシュには保管されません:</p>
 275     <ul>
 276       <li><code>Connection</code></li>
 277       <li><code>Keep-Alive</code></li>
 278       <li><code>Proxy-Authenticate</code></li>
 279       <li><code>Proxy-Authorization</code></li>
 280       <li><code>TE</code></li>
 281       <li><code>Trailers</code></li>
 282       <li><code>Transfer-Encoding</code></li>
 283       <li><code>Upgrade</code></li>
 284     </ul>
 285
 286     <p><code class="directive">CacheIgnoreHeaders</code> で
 287     キャッシュに保管しない追加の HTTP ヘッダを指定します。
 288     例えば、クッキーをキャッシュに保管しないようにした方がよい場合も
 289     あるでしょう。</p>
 290
 291     <p><code class="directive">CacheIgnoreHeaders</code> の引数は、
 292     キャッシュに保管しない HTTP ヘッダを空白区切りにしたリスト形式です。
 293     キャッシュに保管しないヘッダが hop-by-hop ヘッダだけの場合
 294     (RFC 2616 準拠の動作のとき) は、
 295     <code class="directive">CacheIgnoreHeaders</code> を <code>None</code>
 296     に設定できます。</p>
 297
 298     <div class="example"><h3>例 1</h3><p><code>
 299       CacheIgnoreHeaders Set-Cookie
 300     </code></p></div>
 301
 302     <div class="example"><h3>例 2</h3><p><code>
 303       CacheIgnoreHeaders None
 304     </code></p></div>
 305
 306     <div class="warning"><h3>警告:</h3>
 307       <code>Expires</code> のような適切のキャッシュ管理のために必要な
 308       ヘッダが <code class="directive">CacheIgnoreHeaders</code> の設定により
 309       保管されていないときは、mod_cache の動作は定義されていません。
 310     </div>
 311
 312 </div>
 313 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 314 <div class="directive-section"><h2><a name="CacheIgnoreNoLastMod" id="CacheIgnoreNoLastMod">CacheIgnoreNoLastMod</a> <a name="cacheignorenolastmod" id="cacheignorenolastmod">ディレクティブ</a></h2>
 315 <table class="directive">
 316 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>応答に Last Modified が無くても気にしないようにする</td></tr>
 317 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheIgnoreNoLastMod On|Off</code></td></tr>
 318 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheIgnoreNoLastMod Off</code></td></tr>
 319 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 320 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 321 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 322 </table>
 323     <p>通常、Last-Modified による最終修正時刻の無いドキュメントはキャッシュ
 324     されません。(例えば <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> による処理のときなどに)
 325     Last-Modified 時刻が消去されたり、そもそも最初から提供されていない
 326     状況があります。<code class="directive">CacheIgnoreNoLastMod</code>
 327     ディレクティブを使うと、Last-Modified 日時が指定されていない
 328     ドキュメントでもキャッシュするように指定できます。ドキュメントに
 329     最終修正時刻 (Last-Modified) 有効期限 (expiry) がない場合は、有効期限の
 330     生成に <code class="directive">CacheDefaultExpire</code> が使われます。</p>
 331
 332     <div class="example"><p><code>
 333       CacheIgnoreNoLastMod On
 334     </code></p></div>
 335
 336 </div>
 337 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 338 <div class="directive-section"><h2><a name="CacheIgnoreQueryString" id="CacheIgnoreQueryString">CacheIgnoreQueryString</a> <a name="cacheignorequerystring" id="cacheignorequerystring">ディレクティブ</a></h2>
 339 <table class="directive">
 340 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>キャッシュ時にクエリーストリングを無視する</td></tr>
 341 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheIgnoreQueryString On|Off</code></td></tr>
 342 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheIgnoreQueryString Off</code></td></tr>
 343 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 344 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 345 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 346 </table>
 347     <p>クエリーストリング付のリクエストについては通常、クエリーストリングごとに
 348     個別にキャッシュされます。
 349     キャッシュされるのは有効期限が指定されている場合のみで、これは
 350     RFC 2616/13.9 に従ったものです。
 351     <code class="directive">CacheIgnoreQueryString</code> ディレクティブを使うと
 352     有効期限が指定されていなくてもキャッシュしますし、
 353     クエリーストリングが異なっていてもキャッシュを返します。
 354     このディレクティブが有効になっている場合、キャッシュ機能の側面からみると、
 355     あたかもリクエストにクエリーストリングがついていなかったかのように扱います。</p>
 356
 357     <div class="example"><p><code>
 358       CacheIgnoreQueryString On
 359     </code></p></div>
 360
 361
 362 </div>
 363 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 364 <div class="directive-section"><h2><a name="CacheLastModifiedFactor" id="CacheLastModifiedFactor">CacheLastModifiedFactor</a> <a name="cachelastmodifiedfactor" id="cachelastmodifiedfactor">ディレクティブ</a></h2>
 365 <table class="directive">
 366 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>LastModified の日付に基づいて有効期限 (expiry)
 367 を計算するための重みを指定する
 368 </td></tr>
 369 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheLastModifiedFactor <var>float</var></code></td></tr>
 370 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheLastModifiedFactor 0.1</code></td></tr>
 371 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 372 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 373 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 374 </table>
 375     <p>ドキュメントに Last-Modified の日付が無いけれども有効期限 (expiry)
 376     の日付があるというときに、有効期限を最終修正時刻からの経過時間として
 377     計算するようにできます。有効期限を次の計算式に従って生成するのですが、
 378     そのときに使われる <var>factor</var> を
 379     <code class="directive">CacheLastModifiedFactor</code> ディレクティブで指定します。
 380     </p>
 381
 382     <p><code>expiry-period = time-since-last-modified-date * <var>factor</var>
 383     expiry-date = current-date + expiry-period</code></p>
 384
 385     <p>例えば、ドキュメントが 10 時間前に最後に修正されていて、
 386     <var>factor</var> が 0.1 であれば、期日は 10*0.1 = 1 時間に
 387     設定されます。現在時刻が 3:00pm であれば、計算された期日は
 388     3:00pm + 1hour = 4:00pm になります。</p>
 389
 390     <p>期日が <code class="directive">CacheMaxExpire</code> で設定されている値
 391     より大きくなってしまっている場合は、<code class="directive">CacheMaxExpire</code>
 392     の設定値が優先されます。</p>
 393
 394     <div class="example"><p><code>
 395       CacheLastModifiedFactor 0.5
 396     </code></p></div>
 397
 398 </div>
 399 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 400 <div class="directive-section"><h2><a name="CacheMaxExpire" id="CacheMaxExpire">CacheMaxExpire</a> <a name="cachemaxexpire" id="cachemaxexpire">ディレクティブ</a></h2>
 401 <table class="directive">
 402 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ドキュメントをキャッシュする最大時間を秒数で表したもの</td></tr>
 403 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheMaxExpire <var>seconds</var></code></td></tr>
 404 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheMaxExpire 86400 (一日)</code></td></tr>
 405 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 406 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 407 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 408 </table>
 409     <p><code class="directive">CacheMaxExpire</code> ディレクティブは、
 410     キャッシュする HTTP ドキュメントを、元のサーバに問い合わせないまま最大何秒
 411     保持してもよいかを指定します。つまり、ドキュメントは最大でこの秒数間ぶん古く
 412     なることになります。この最大値は、<span class="transnote">(<em>訳注:</em> レスポンス中で)</span>ドキュメントと共に
 413     ドキュメントの期日が提供されている場合でも適用されます。</p>
 414
 415     <div class="example"><p><code>
 416       CacheMaxExpire 604800
 417     </code></p></div>
 418
 419 </div>
 420 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 421 <div class="directive-section"><h2><a name="CacheMinExpire" id="CacheMinExpire">CacheMinExpire</a> <a name="cacheminexpire" id="cacheminexpire">ディレクティブ</a></h2>
 422 <table class="directive">
 423 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ドキュメントをキャッシュする最小秒数</td></tr>
 424 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheMinExpire <var>seconds</var></code></td></tr>
 425 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheMinExpire 0</code></td></tr>
 426 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 427 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 428 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 429 </table>
 430     <p>キャッシュ可能な HTTP ドキュメントがあったときに、オリジンサーバに問い合わせることなく
 431     保持する秒数の最小値は <code class="directive">CacheMinExpire</code> ディレクティブを使って設定します。
 432     この値は、ドキュメントに妥当な有効期限が指定されていなかった場合にのみ使われます。</p>
 433
 434
 435     <div class="example"><p><code>
 436       CacheMinExpire 3600
 437     </code></p></div>
 438
 439 </div>
 440 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 441 <div class="directive-section"><h2><a name="CacheStoreNoStore" id="CacheStoreNoStore">CacheStoreNoStore</a> <a name="cachestorenostore" id="cachestorenostore">ディレクティブ</a></h2>
 442 <table class="directive">
 443 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>no-store と指定されているレスポンスのキャッシュを試みる。</td></tr>
 444 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheStoreNoStore On|Off</code></td></tr>
 445 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheStoreNoStore Off</code></td></tr>
 446 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 447 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 448 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 449 </table>
 450     <p>通常 Cache-Control: no-store ヘッダのついているレスポンスは
 451        キャッシュされません。<code class="directive">CacheStoreNoCache</code>
 452        ディレクティブでこの挙動を上書きできます。
 453        <code class="directive">CacheStoreNoCache</code> On で no-store ヘッダのついている
 454        リソースに対してもキャッシュを試みるようになります。
 455        ただし認証の求められるリソースは <em>決して</em> キャッシュされません。</p>
 456
 457     <div class="example"><p><code>
 458       CacheStoreNoStore On
 459     </code></p></div>
 460
 461     <div class="warning"><h3>警告:</h3>
 462        RFC 2616 に記載されているように no-store ディレクティブは、
 463        "不注意による機密情報の漏洩や残留 (バックアップテープ等) を防ぐ"
 464        目的で使われますが、このオプションを有効にすると、
 465        機密情報を保持することになってしまいます。
 466        ですので、ここで警告しておきます。
 467     </div>
 468
 469 <h3>参照</h3>
 470 <ul>
 471 <li><code class="directive"><a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></code></li>
 472 <li><code class="directive"><a href="#cachestoreprivate">CacheStorePrivate</a></code></li>
 473 </ul>
 474 </div>
 475 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 476 <div class="directive-section"><h2><a name="CacheStorePrivate" id="CacheStorePrivate">CacheStorePrivate</a> <a name="cachestoreprivate" id="cachestoreprivate">ディレクティブ</a></h2>
 477 <table class="directive">
 478 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>private と指定されているレスポンスのキャッシュを試みる。</td></tr>
 479 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CacheStorePrivate On|Off</code></td></tr>
 480 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>CacheStorePrivate Off</code></td></tr>
 481 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 482 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 483 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_cache</td></tr>
 484 </table>
 485     <p>通常 Cache-Control: private ヘッダのついているレスポンスは
 486        キャッシュされません。<code class="directive">CacheStorePrivate</code>
 487        ディレクティブでこの挙動を上書きできます。
 488        <code class="directive">CacheStorePrivate</code> On で private ヘッダのついている
 489        リソースに対してもキャッシュを試みるようになります。
 490        ただし認証の求められるリソースは <em>決して</em> キャッシュされません。</p>
 491
 492     <div class="example"><p><code>
 493       CacheStorePrivate On
 494     </code></p></div>
 495
 496     <div class="warning"><h3>警告:</h3>
 497        上流サーバがキャッシュしないように指定してきても、
 498        それを無視してキャッシュするようになります。
 499        望ましい挙動になるのは、本当に 'private' なキャッシュについてのみでしょう。
 500     </div>
 501
 502 <h3>参照</h3>
 503 <ul>
 504 <li><code class="directive"><a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></code></li>
 505 <li><code class="directive"><a href="#cachestorenostore">CacheStoreNoStore</a></code></li>
 506 </ul>
 507 </div>
 508 </div>
 509 <div class="bottomlang">
 510 <p><span>言語: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 511 <a href="../fr/mod/mod_cache.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 512 <a href="../ja/mod/mod_cache.html" title="Japanese">&nbsp;ja&nbsp;</a> |
 513 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 514 </div><div id="footer">
 515 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 516 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div>
 517 </body></html>