diff options
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 |