summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_cache.xml
diff options
context:
space:
mode:
authorGraham Leggett <minfrin@apache.org>2011-02-13 02:03:29 +0000
committerGraham Leggett <minfrin@apache.org>2011-02-13 02:03:29 +0000
commit43fc2d47c7ec261abefc5bafecfdb9e66c48fd30 (patch)
tree292a3163b6a7f61348165fb3553cad73b2f03595 /docs/manual/mod/mod_cache.xml
parentb591028272e05e03e6a0f575829afde0cf84ae01 (diff)
downloadhttpd-43fc2d47c7ec261abefc5bafecfdb9e66c48fd30.tar.gz
mod_cache: When a request other than GET or HEAD arrives, we must
invalidate existing cache entities as per RFC2616 13.10. PR 15868. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1070179 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_cache.xml')
-rw-r--r--docs/manual/mod/mod_cache.xml10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/manual/mod/mod_cache.xml b/docs/manual/mod/mod_cache.xml
index e73e2d93ee..97d7c11760 100644
--- a/docs/manual/mod/mod_cache.xml
+++ b/docs/manual/mod/mod_cache.xml
@@ -302,13 +302,15 @@
</example>
<p>Based on the caching decision made, the reason is also written to the
- subprocess environment under one the following three keys, as appropriate:</p>
+ subprocess environment under one the following four keys, as appropriate:</p>
<dl>
<dt>cache-hit</dt><dd>The response was served from cache.</dd>
<dt>cache-revalidate</dt><dd>The response was stale and was successfully
revalidated, then served from cache.</dd>
<dt>cache-miss</dt><dd>The response was served from the upstream server.</dd>
+ <dt>cache-invalidate</dt><dd>The cached entity was invalidated by a request
+ method other than GET or HEAD.</dd>
</dl>
<p>This makes it possible to support conditional logging of cached requests
@@ -318,10 +320,14 @@
CustomLog cached-requests.log common env=cache-hit<br />
CustomLog uncached-requests.log common env=cache-miss<br />
CustomLog revalidated-requests.log common env=cache-revalidate<br />
+ CustomLog invalidated-requests.log common env=cache-invalidate<br />
</example>
+ <p>For module authors, a hook called <var>cache_status</var> is available,
+ allowing modules to respond to the caching outcomes above in customised
+ ways.</p>
</section>
-
+
<directivesynopsis>
<name>CacheEnable</name>
<description>Enable caching of specified URLs using a specified storage