From ebf09c6cc62acd9e2c7fbd8f7c9cbff72c92a063 Mon Sep 17 00:00:00 2001
From: Andre Malo This module provides directives to control and modify HTTP
@@ -17,92 +18,103 @@
or removed. The directives provided by mod_header can occur almost
- anywhere within the server configuration. They are valid in the
+ The directives provided by s to
- add table border
- nothing else ;-)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@97513 13f79535-47bb-0310-9956-ffa450edef68
---
docs/manual/mod/mod_headers.xml | 335 ++++++++++++++++----------------
1 file changed, 171 insertions(+), 164 deletions(-)
diff --git a/docs/manual/mod/mod_headers.xml b/docs/manual/mod/mod_headers.xml
index 84ba651e8c..71ab5ab4f0 100644
--- a/docs/manual/mod/mod_headers.xml
+++ b/docs/manual/mod/mod_headers.xml
@@ -4,12 +4,13 @@
.htaccess
files.
The directives are processed in the following order:
.htaccess
Order is important. These two headers have a different effect if reversed:
-This way round, the MirrorID header is not set. If reversed, - the MirrorID header is set to "mirror 12".
+This way round, the MirrorID
header is not set. If
+ reversed, the MirrorID header is set to "mirror 12".
MyHeader
, to the response including a
+ timestamp for when the request was received and how long it
+ took to begin serving the request. This header can be used by
+ the client to intuit load on the server or in isolating
+ bottlenecks between the client and the server.
+
+ results in this header being added to the response:
+ +results in this header being added to the response:
+ +MyHeader
on the response if and
+ only if header "MyRequestHeader" is present on the request. This
+ is useful for constructing headers in response to some client
+ stimulus. Note that this example requires the services of the
+ If the header MyRequestHeader: value
is present on
+ the HTTP request, the response will contain the following header:
set
append
add
append
should be
+ used instead.unset
This argument is followed by a header name, which can
include the final colon, but it is not required. Case is
ignored. For add
, append
and
- set
a value is given as the third argument. If
- value contains spaces, it should be surrounded by double
- quotes. For unset, no value should be given.
set
a value is given as the third argument. If
+ value contains spaces, it should be surrounded by double
+ quotes. For unset, no value should be given.
The
modified. The action it performs is determined by the first
argument. This can be one of the following values:
This argument is followed by a header name, which +
set
append
add
unset
echo
This argument is followed by a header name, which can include the final colon, but it is not required. Case is - ignored for set, append, add and unset. The header - name for echo is case sensitive and may be a regular - expression.
- -For add
, append
and
- set
a value is specified as the third
- argument. If value contains spaces, it should be
- surrounded by doublequotes. value may be a character
- string, a string containing format specifiers or a combination
- of both. The following format specifiers are supported in
- value:
%t: | The time the request was received in Universal -Coordinated Time since the epoch (Jan. 1, 1970) measured in -microseconds. The value is preceded by "t=". |
%D: | The time from when the request was received to -the time the headers are sent on the wire. This is a measure of the -duration of the request. The value is preceded by "D=". |
%{FOOBAR}e: | The contents of the environment -variable FOOBAR. |
set
, append
, add
+ and unset
. The header name for echo
+ is case sensitive and may be a regular expression.
+
+ For add
, append
and set
a
+ value is specified as the third argument. If value
+ contains spaces, it should be surrounded by doublequotes.
+ value may be a character string, a string containing format
+ specifiers or a combination of both. The following format specifiers
+ are supported in value:
%t |
+ The time the request was received in Universal Coordinated Time
+ since the epoch (Jan. 1, 1970) measured in microseconds. The value
+ is preceded by t= . |
%D |
+ The time from when the request was received to the time the
+ headers are sent on the wire. This is a measure of the duration
+ of the request. The value is preceded by D= . |
%{FOOBAR}e |
+ The contents of the environment
+ variable FOOBAR . |
When the add
, append
, or set
@@ -250,10 +257,10 @@ variable FOOBAR.
will take effect. Otherwise, the directive will have no effect
on the request.
The Header directives are processed just before the response - is sent to the network. These means that it is possible to set - and/or override most headers, except for those headers added by - the header filter.
+The