granicus.if.org Git - apache/blob - docs/manual/mod/mod_cache_disk.xml.ja

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <!-- English Revision: 515267:1330964 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <modulesynopsis metafile="mod_cache_disk.xml.meta">
  24
  25 <name>mod_cache_disk</name>
  26 <description>URI をキーにしたコンテンツキャッシュストレージ管理</description>
  27 <status>Extension</status>
  28 <sourcefile>mod_cache_disk.c</sourcefile>
  29 <identifier>cache_disk_module</identifier>
  30
  31 <summary>
  32     <p><module>mod_cache_disk</module> はディスクを使用したストレージ
  33     管理機構を実装しています。主に
  34     <module>mod_cache</module> と組み合わせて使われます。</p>
  35
  36     <p>コンテンツのキャッシュへの保存と取得は URI に基づいたキーが使われます。
  37     アクセス保護のかけられているコンテンツはキャッシュされません。</p>
  38
  39     <p>キャッシュの大きさを最大レベルで維持するために
  40     <program>htcacheclean</program> を使うことができます。</p>
  41
  42     <note><title>注:</title>
  43       <p><module>mod_cache_disk</module> は
  44       <module>mod_cache</module> を必要とします</p>
  45     </note>
  46 </summary>
  47
  48 <directivesynopsis>
  49 <name>CacheReadSize</name>
  50 <description>The minimum size (in bytes) of the document to read and be cached before sending the data downstream</description>
  51 <contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>
  52 <usage><p>Documentation not yet translated. Please see English version of document.</p></usage>
  53 </directivesynopsis>
  54
  55 <directivesynopsis>
  56 <name>CacheReadTime</name>
  57 <description>The minimum time (in milliseconds) that should elapse while reading before data is sent downstream</description>
  58 <contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>
  59 <usage><p>Documentation not yet translated. Please see English version of document.</p></usage>
  60 </directivesynopsis>
  61
  62 <directivesynopsis>
  63 <name>CacheRoot</name>
  64 <description>キャッシュファイルが保管されるルートディレクトリ</description>
  65 <syntax>CacheRoot <var>directory</var></syntax>
  66 <contextlist><context>server config</context><context>virtual host</context>
  67 </contextlist>
  68
  69 <usage>
  70     <p><directive>CacheRoot</directive> ディレクティブはキャッシュファイルを
  71     保管するためのディスク上のディレクトリを指定します。<module
  72     >mod_cache_disk</module> モジュールが Apache サーバにロードされて
  73     いるか、組み込まれていれば、このディレクティブは<em>必ず</em>
  74     定義しなければなりません。
  75     <directive>CacheRoot</directive> の値を指定しなければ、
  76     設定ファイルの処理でエラーになります。<directive
  77     module="mod_cache_disk">CacheDirLevels</directive> ディレクティブと <directive
  78     module="mod_cache_disk">CacheDirLength</directive> ディレクティブが
  79     指定されたルートディレクトリ下のディレクトリ構成を定義します。</p>
  80
  81     <example>
  82       CacheRoot c:/cacheroot
  83     </example>
  84 </usage>
  85 </directivesynopsis>
  86
  87 <directivesynopsis>
  88 <name>CacheDirLevels</name>
  89 <description>キャッシュのサブディレクトリの深さの数</description>
  90 <syntax>CacheDirLevels <var>levels</var></syntax>
  91 <default>CacheDirLevels 2</default>
  92 <contextlist><context>server config</context><context>virtual host</context>
  93 </contextlist>
  94
  95 <usage>
  96     <p><directive>CacheDirLevels</directive> ディレクティブはキャッシュの
  97     サブディレクトリの深さを設定します。キャッシュデータは <directive
  98     module="mod_cache_disk">CacheRoot</directive> ディレクトリから
  99     このディレクトリの深さ分下のディレクトリに保存されます。</p>
 100     <p><directive>CacheDirLevels</directive> が大きくて
 101     <directive>CacheDirLength</directive> が小さい場合、
 102     比較的深い階層になりますが、
 103     各階層のサブディレクトリの数は少なくなります。</p>
 104
 105     <note>
 106       <p><directive>CacheDirLevels</directive>*
 107       <directive module="mod_cache_disk">CacheDirLength</directive> の
 108       結果は 20 以内でなければなりません。</p>
 109     </note>
 110
 111 </usage>
 112 </directivesynopsis>
 113
 114 <directivesynopsis>
 115 <name>CacheDirLength</name>
 116 <description>サブディレクトリ名の文字数</description>
 117 <syntax>CacheDirLength <var>length</var></syntax>
 118 <default>CacheDirLength 2</default>
 119 <contextlist><context>server config</context><context>virtual host</context>
 120 </contextlist>
 121
 122 <usage>
 123     <p><directive>CacheDirLength</directive> ディレクティブはキャッシュ
 124     階層の各サブディレクトリの文字数を設定します。
 125     <directive>CacheDirLevels</directive> と組み合わせて設定することで、
 126     キャッシュ階層のおおよその構造を決めることができます。</p>
 127     <p><directive>CacheDirLength</directive> が大きくて
 128     <directive>CacheDirLevels</directive> が小さい場合、
 129     比較的浅い階層になりますが、
 130     各階層のサブディレクトリの数は多くなります。</p>
 131
 132     <note>
 133       <p><directive>CacheDirLevels</directive>*
 134       <directive module="mod_cache_disk">CacheDirLength</directive> の
 135       結果は 20 以内でなければなりません。</p>
 136     </note>
 137
 138 </usage>
 139 </directivesynopsis>
 140
 141 <directivesynopsis>
 142 <name>CacheMinFileSize</name>
 143 <description>キャッシュに保管されるドキュメントの最小限の (バイトでの) 大きさ</description>
 144 <syntax>CacheMinFileSize <var>bytes</var></syntax>
 145 <default>CacheMinFileSize 1</default>
 146 <contextlist><context>server config</context><context>virtual host</context>
 147 </contextlist>
 148
 149 <usage>
 150     <p><directive>CacheMinFileSize</directive> ディレクティブは、ドキュメントを
 151     キャッシュするかどうかを判定する、最小のサイズをバイト数で設定します。</p>
 152
 153     <example>
 154       CacheMinFileSize 64
 155     </example>
 156 </usage>
 157 </directivesynopsis>
 158
 159 <directivesynopsis>
 160 <name>CacheMaxFileSize</name>
 161 <description>キャッシュに保管されるドキュメントの最大の (バイトでの) サイズ</description>
 162 <syntax>CacheMaxFileSize <var>bytes</var></syntax>
 163 <default>CacheMaxFileSize 1000000</default>
 164 <contextlist><context>server config</context><context>virtual host</context>
 165 </contextlist>
 166
 167 <usage>
 168     <p><directive>CacheMaxFileSize</directive> ディレクティブは、ドキュメントを
 169     キャッシュするかどうかを判定する、最大のサイズをバイト数で設定します。</p>
 170
 171     <example>
 172       CacheMaxFileSize 64000
 173     </example>
 174 </usage>
 175 </directivesynopsis>
 176
 177 </modulesynopsis>