From: Christophe Jaillet Date: Sat, 12 Jan 2019 08:32:14 +0000 (+0000) Subject: Remove the default CacheKeyBaseURL value, it doesn't have any. X-Git-Tag: 2.5.0-alpha2-ci-test-only~2213 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=628aad92fab114ab0063e058896b82e305dfca4a;p=thirdparty%2Fapache%2Fhttpd.git Remove the default CacheKeyBaseURL value, it doesn't have any. Improve syntax highlight and hyper-links. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1851152 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_cache.xml b/docs/manual/mod/mod_cache.xml index 4c91c35110d..c4d739162e2 100644 --- a/docs/manual/mod/mod_cache.xml +++ b/docs/manual/mod/mod_cache.xml @@ -179,7 +179,7 @@ LoadModule cache_module modules/mod_cache.so server, a significant number of requests might arrive during this time, and cause a thundering herd of requests to strike the backend suddenly and unpredictably.

-

To keep the thundering herd at bay, the CacheLock +

To keep the thundering herd at bay, the CacheLock directive can be used to define a directory in which locks are created for URLs in flight. The lock is used as a hint by other requests to either suppress an attempt to cache (someone else has @@ -213,8 +213,8 @@ LoadModule cache_module modules/mod_cache.so

As a further safety mechanism, locks have a configurable maximum age. Once this age has been reached, the lock is removed, and a new request is given the opportunity to create a new lock. This maximum age can be set using - the CacheLockMaxAge directive, and defaults to 5 - seconds. + the CacheLockMaxAge directive, and defaults + to 5 seconds.

@@ -250,8 +250,8 @@ LoadModule cache_module modules/mod_cache.so circumstances, an administrator is often forced to place independent reverse proxy servers either behind or in front of the caching server to achieve this.

-

To solve this problem the CacheQuickHandler - directive can be set to off, and the server will +

To solve this problem the CacheQuickHandler + directive can be set to off, and the server will process all phases normally handled by a non-cached request, including the authentication and authorization phases.

@@ -355,8 +355,8 @@ manager url-string. The cache storage manager is specified with the cache_type argument. The CacheEnable directive can alternatively be placed inside either - Location or - LocationMatch sections to indicate + Location or + LocationMatch sections to indicate the content is cacheable. cache_type disk instructs mod_cache to use the disk based storage manager @@ -370,8 +370,8 @@ manager actually processes the request. The order in which the storage managers are run is determined by the order of the CacheEnable directives in the configuration file. CacheEnable - directives within Location or - LocationMatch sections are processed + directives within Location or + LocationMatch sections are processed before globally defined CacheEnable directives.

When acting as a forward proxy server, url-string must @@ -438,7 +438,7 @@ CacheEnable disk http://.example.org/ -

If used in a Location directive, +

If used in a Location directive, the path needs to be specified below the Location, or if the word "on" is used, caching for the whole location will be disabled.

@@ -517,7 +517,7 @@ CacheEnable disk http://.example.org/

The CacheDefaultExpire directive specifies a default time, in seconds, to cache a document if neither an expiry date nor last-modified date are provided - with the document. The value specified with the CacheMaxExpire + with the document. The value specified with the CacheMaxExpire directive does not override this setting.

@@ -547,7 +547,7 @@ header. should be considered for caching, even without a last-modified date. If neither a last-modified date nor an expiry date are provided with the document then the value specified by the - CacheDefaultExpire directive will be used to + CacheDefaultExpire directive will be used to generate an expiration date.

@@ -565,7 +565,7 @@ header. -

Ordinarily, requests containing a Cache-Control: no-cache or +

Ordinarily, requests containing a Cache-Control: no-cache or Pragma: no-cache header value will not be served from the cache. The CacheIgnoreCacheControl directive allows this behavior to be overridden. CacheIgnoreCacheControl On @@ -640,7 +640,7 @@ LastModified date. expiry-date would be 3:00pm + 1hour = 4:00pm. If the expiry-period would be longer than that set by - CacheMaxExpire, then the latter takes + CacheMaxExpire, then the latter takes precedence.

@@ -786,7 +786,7 @@ LastModified date. -

Ordinarily, responses with Cache-Control: private header values will not +

Ordinarily, responses with Cache-Control: private header values will not be stored in the cache. The CacheStorePrivate directive allows this behavior to be overridden. CacheStorePrivate On @@ -819,7 +819,7 @@ LastModified date. -

Ordinarily, requests or responses with Cache-Control: no-store header +

Ordinarily, requests or responses with Cache-Control: no-store header values will not be stored in the cache. The CacheStoreNoStore directive allows this behavior to be overridden. CacheStoreNoStore On @@ -912,7 +912,7 @@ CacheLock on Apache HTTP Server 2.3.3 and later -

The CacheQuickHandler directive +

The CacheQuickHandler directive controls the phase in which the cache is handled.

In the default enabled configuration, the cache operates within the quick @@ -961,7 +961,7 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html Available in Apache 2.3.9 and later -

When the CacheHeader directive +

When the CacheHeader directive is switched on, an X-Cache header will be added to the response with the cache status of this response. If the normal handler is used, this directive may appear within a Directory @@ -1003,7 +1003,7 @@ CacheHeader on Available in Apache 2.3.9 and later -

When the CacheDetailHeader directive +

When the CacheDetailHeader directive is switched on, an X-Cache-Detail header will be added to the response containing the detailed reason for a particular caching decision.

@@ -1034,14 +1034,13 @@ CacheDetailHeader on CacheKeyBaseURL Override the base URL of reverse proxied cache keys. CacheKeyBaseURL URL -CacheKeyBaseURL http://example.com server config virtual host Available in Apache 2.3.9 and later -

When the CacheKeyBaseURL directive +

When the CacheKeyBaseURL directive is specified, the URL provided will be used as the base URL to calculate the URL of the cache keys in the reverse proxy configuration. When not specified, the scheme, hostname and port of the current virtual host is used to construct @@ -1074,7 +1073,7 @@ CacheKeyBaseURL http://www.example.com/ Available in Apache 2.3.9 and later -

When the CacheStaleOnError directive +

When the CacheStaleOnError directive is switched on, and when stale data is available in the cache, the cache will respond to 5xx responses from the backend by returning the stale data instead of the 5xx response. While the Cache-Control headers sent by clients will be respected,