mod_cache_disk.html.en revision 4aa603e6448b99f9371397d439795c91a93637ea
4b22b9337f359bfd063322244f5336cc7c6ffcfars<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
cda73f64f20b8a0afc4909f5ea1f055ec7913856Toomas Soome<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
4b22b9337f359bfd063322244f5336cc7c6ffcfars XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
4b22b9337f359bfd063322244f5336cc7c6ffcfars This file is generated from xml source: DO NOT EDIT
4b22b9337f359bfd063322244f5336cc7c6ffcfars XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<title>mod_cache_disk - Apache HTTP Server</title>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
4b22b9337f359bfd063322244f5336cc7c6ffcfars<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
4b22b9337f359bfd063322244f5336cc7c6ffcfars<script src="/style/scripts/prettify.min.js" type="text/javascript">
4b22b9337f359bfd063322244f5336cc7c6ffcfars<link href="/images/favicon.ico" rel="shortcut icon" /></head>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<p><span>Available Languages: </span><a href="/en/mod/mod_cache_disk.html" title="English"> en </a> |
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="/fr/mod/mod_cache_disk.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="/ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="/ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Disk based storage module for the HTTP caching filter.</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>cache_disk_module</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_cache_disk.c</td></tr></table>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p><code class="module"><a href="/mod/mod_cache_disk.html">mod_cache_disk</a></code> implements a disk based storage
4b22b9337f359bfd063322244f5336cc7c6ffcfars manager for <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The headers and bodies of cached responses are stored separately on
4b22b9337f359bfd063322244f5336cc7c6ffcfars disk, in a directory structure derived from the md5 hash of the cached
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>Multiple content negotiated responses can be stored concurrently,
4b22b9337f359bfd063322244f5336cc7c6ffcfars however the caching of partial content is not yet supported by this
4b22b9337f359bfd063322244f5336cc7c6ffcfars module.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>Atomic cache updates to both header and body files are achieved
4b22b9337f359bfd063322244f5336cc7c6ffcfars without the need for locking by storing the device and inode numbers of
4b22b9337f359bfd063322244f5336cc7c6ffcfars the body file within the header file. This has the side effect that
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome cache entries manually moved into the cache will be ignored.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The <code class="program"><a href="/programs/htcacheclean.html">htcacheclean</a></code> tool is provided to list cached
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome URLs, remove cached URLs, or to maintain the size of the disk cache
4b22b9337f359bfd063322244f5336cc7c6ffcfars within size and/or inode limits. The tool can be run on demand, or
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome can be daemonized to offer continuous monitoring of directory sizes.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p><code class="module"><a href="/mod/mod_cache_disk.html">mod_cache_disk</a></code> requires the services of
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>, which must be
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome loaded before mod_cache_disk.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p><code class="module"><a href="/mod/mod_cache_disk.html">mod_cache_disk</a></code> uses the sendfile feature to
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome serve files from the cache when supported by the platform, and
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome when enabled with <code class="directive"><a href="/mod/core.html#enablesendfile">EnableSendfile</a></code>.
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome However, per-directory and .htaccess configuration of
4b22b9337f359bfd063322244f5336cc7c6ffcfars <code class="directive"><a href="/mod/core.html#enablesendfile">EnableSendfile</a></code> are ignored by
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <code class="module"><a href="/mod/mod_cache_disk.html">mod_cache_disk</a></code> as the corresponding settings are not
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome available to the module when a request is being served from the
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div id="quickview"><h3 class="directives">Directives</h3>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><img alt="" src="/images/down.gif" /> <a href="#cachedirlength">CacheDirLength</a></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><img alt="" src="/images/down.gif" /> <a href="#cachedirlevels">CacheDirLevels</a></li>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<li><img alt="" src="/images/down.gif" /> <a href="#cachemaxfilesize">CacheMaxFileSize</a></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><img alt="" src="/images/down.gif" /> <a href="#cacheminfilesize">CacheMinFileSize</a></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><img alt="" src="/images/down.gif" /> <a href="#cachereadsize">CacheReadSize</a></li>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<li><img alt="" src="/images/down.gif" /> <a href="#cachereadtime">CacheReadTime</a></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><img alt="" src="/images/down.gif" /> <a href="#cacheroot">CacheRoot</a></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><code class="module"><a href="/mod/mod_cache_socache.html">mod_cache_socache</a></code></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<li><a href="/caching.html">Caching Guide</a></li>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="directive-section"><h2><a name="CacheDirLength" id="CacheDirLength">CacheDirLength</a> <a name="cachedirlength" id="cachedirlength">Directive</a></h2>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of characters in subdirectory names</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDirLength <var>length</var></code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheDirLength 2</code></td></tr>
cda73f64f20b8a0afc4909f5ea1f055ec7913856Toomas Soome<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
cda73f64f20b8a0afc4909f5ea1f055ec7913856Toomas Soome<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>The <code class="directive">CacheDirLength</code> directive sets the number
4b22b9337f359bfd063322244f5336cc7c6ffcfars of characters for each subdirectory name in the cache hierarchy. It can
4b22b9337f359bfd063322244f5336cc7c6ffcfars be used in conjunction with <code class="directive">CacheDirLevels</code> to
4b22b9337f359bfd063322244f5336cc7c6ffcfars determine the approximate structure of your cache hierarchy.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>A high value for <code class="directive">CacheDirLength</code> combined
4b22b9337f359bfd063322244f5336cc7c6ffcfars with a low value for <code class="directive">CacheDirLevels</code> will result in
4b22b9337f359bfd063322244f5336cc7c6ffcfars a relatively flat hierarchy, with a large number of subdirectories at each
4b22b9337f359bfd063322244f5336cc7c6ffcfars level.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>The result of <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code>* <code class="directive">CacheDirLength</code>
4b22b9337f359bfd063322244f5336cc7c6ffcfars must not be higher than 20.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="directive-section"><h2><a name="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a> <a name="cachedirlevels" id="cachedirlevels">Directive</a></h2>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of levels of subdirectories in the
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDirLevels <var>levels</var></code></td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheDirLevels 2</code></td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>The <code class="directive">CacheDirLevels</code> directive sets the number
4b22b9337f359bfd063322244f5336cc7c6ffcfars of subdirectory levels in the cache. Cached data will be saved this
4b22b9337f359bfd063322244f5336cc7c6ffcfars many directory levels below the <code class="directive"><a href="#cacheroot">CacheRoot</a></code> directory.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>A high value for <code class="directive">CacheDirLevels</code> combined
4b22b9337f359bfd063322244f5336cc7c6ffcfars with a low value for <code class="directive">CacheDirLength</code> will result in
4b22b9337f359bfd063322244f5336cc7c6ffcfars a relatively deep hierarchy, with a small number of subdirectories at each
4b22b9337f359bfd063322244f5336cc7c6ffcfars level.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars <p>The result of <code class="directive">CacheDirLevels</code>*
4b22b9337f359bfd063322244f5336cc7c6ffcfars <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> must
4b22b9337f359bfd063322244f5336cc7c6ffcfars not be higher than 20.</p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="directive-section"><h2><a name="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a> <a name="cachemaxfilesize" id="cachemaxfilesize">Directive</a></h2>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The maximum size (in bytes) of a document to be placed in the
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheMaxFileSize <var>bytes</var></code></td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheMaxFileSize 1000000</code></td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The <code class="directive">CacheMaxFileSize</code> directive sets the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome maximum size, in bytes, for a document to be considered for storage in
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome the cache.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <pre class="prettyprint lang-config"> CacheMaxFileSize 64000</pre>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="directive-section"><h2><a name="CacheMinFileSize" id="CacheMinFileSize">CacheMinFileSize</a> <a name="cacheminfilesize" id="cacheminfilesize">Directive</a></h2>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of a document to be placed in the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheMinFileSize <var>bytes</var></code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheMinFileSize 1</code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The <code class="directive">CacheMinFileSize</code> directive sets the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome minimum size, in bytes, for a document to be considered for storage
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome in the cache.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <pre class="prettyprint lang-config"> CacheMinFileSize 64</pre>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="directive-section"><h2><a name="CacheReadSize" id="CacheReadSize">CacheReadSize</a> <a name="cachereadsize" id="cachereadsize">Directive</a></h2>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum size (in bytes) of the document to read and be cached
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheReadSize <var>bytes</var></code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheReadSize 0</code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The <code class="directive">CacheReadSize</code> directive sets the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome minimum amount of data, in bytes, to be read from the backend before the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome data is sent to the client. The default of zero causes all data read of
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome any size to be passed downstream to the client immediately as it arrives.
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome Setting this to a higher value causes the disk cache to buffer at least
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome this amount before sending the result to the client. This can improve
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome performance when caching content from a reverse proxy.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>This directive only takes effect when the data is being saved to the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome cache, as opposed to data being served from the cache.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <pre class="prettyprint lang-config"> CacheReadSize 102400</pre>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<div class="directive-section"><h2><a name="CacheReadTime" id="CacheReadTime">CacheReadTime</a> <a name="cachereadtime" id="cachereadtime">Directive</a></h2>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The minimum time (in milliseconds) that should elapse while reading
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheReadTime <var>milliseconds</var></code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheReadTime 0</code></td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The <code class="directive">CacheReadTime</code> directive sets the minimum amount
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome of elapsed time that should pass before making an attempt to send data
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome downstream to the client. During the time period, data will be buffered
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome before sending the result to the client. This can improve performance when
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome caching content from a reverse proxy.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The default of zero disables this option.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>This directive only takes effect when the data is being saved to the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome cache, as opposed to data being served from the cache. It is recommended
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome that this option be used alongside the
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <code class="directive"><a href="#cachereadsize">CacheReadSize</a></code> directive to
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome ensure that the server does not buffer excessively should data arrive faster
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome than expected.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <pre class="prettyprint lang-config"> CacheReadTime 1000</pre>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<div class="directive-section"><h2><a name="CacheRoot" id="CacheRoot">CacheRoot</a> <a name="cacheroot" id="cacheroot">Directive</a></h2>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The directory root under which cache files are
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheRoot <var>directory</var></code></td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
4b22b9337f359bfd063322244f5336cc7c6ffcfars<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <p>The <code class="directive">CacheRoot</code> directive defines the name of
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome the directory on the disk to contain cache files. If the <code class="module"><a href="/mod/mod_cache_disk.html">mod_cache_disk</a></code> module has been loaded or compiled in to the
4b22b9337f359bfd063322244f5336cc7c6ffcfars Apache server, this directive <em>must</em> be defined. Failing to
4b22b9337f359bfd063322244f5336cc7c6ffcfars provide a value for <code class="directive">CacheRoot</code> will result in
4b22b9337f359bfd063322244f5336cc7c6ffcfars a configuration file processing error. The <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code> and <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> directives define
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome the structure of the directories under the specified root directory.</p>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome <pre class="prettyprint lang-config"> CacheRoot c:/cacheroot</pre>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<p><span>Available Languages: </span><a href="/en/mod/mod_cache_disk.html" title="English"> en </a> |
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="/fr/mod/mod_cache_disk.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="/ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
4b22b9337f359bfd063322244f5336cc7c6ffcfars<a href="/ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
4b22b9337f359bfd063322244f5336cc7c6ffcfars</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
4b22b9337f359bfd063322244f5336cc7c6ffcfarsvar comments_shortname = 'httpd';
4b22b9337f359bfd063322244f5336cc7c6ffcfarsvar comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache_disk.html';
4b22b9337f359bfd063322244f5336cc7c6ffcfars(function(w, d) {
4b22b9337f359bfd063322244f5336cc7c6ffcfars if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
4b22b9337f359bfd063322244f5336cc7c6ffcfars d.write('<div id="comments_thread"><\/div>');
4b22b9337f359bfd063322244f5336cc7c6ffcfars var s = d.createElement('script');
4b22b9337f359bfd063322244f5336cc7c6ffcfars s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome})(window, document);
4b22b9337f359bfd063322244f5336cc7c6ffcfars<p class="apache">Copyright 2014 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>
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soomeif (typeof(prettyPrint) !== 'undefined') {
5ffb0c9b03b5149ff4f5821a62be4a52408ada2aToomas Soome prettyPrint();