diff options
author | Graham Leggett <minfrin@apache.org> | 2011-02-13 02:03:29 +0000 |
---|---|---|
committer | Graham Leggett <minfrin@apache.org> | 2011-02-13 02:03:29 +0000 |
commit | 43fc2d47c7ec261abefc5bafecfdb9e66c48fd30 (patch) | |
tree | 292a3163b6a7f61348165fb3553cad73b2f03595 /docs/manual/mod/mod_cache.xml | |
parent | b591028272e05e03e6a0f575829afde0cf84ae01 (diff) | |
download | httpd-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.xml | 10 |
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 |