From: André Malo Date: Mon, 5 Jul 2004 19:15:55 +0000 (+0000) Subject: update transformation X-Git-Tag: pre_ajp_proxy~93 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e2b9bf02101df59258643b2e18e890828392a0b2;p=apache update transformation git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@104179 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_headers.html.en b/docs/manual/mod/mod_headers.html.en index 4b64e00496..560a308a59 100644 --- a/docs/manual/mod/mod_headers.html.en +++ b/docs/manual/mod/mod_headers.html.en @@ -45,6 +45,7 @@ is available only in Apache 2.0

Topics

top
@@ -68,6 +69,27 @@ is available only in Apache 2.0 reversed, the MirrorID header is set to "mirror 12".

top
+

Early and Late Processing

+

mod_headers can be applied either early or late + in the request. The normal mode is late, when Request Headers are + set immediately before running the content generator and Response + Headers just as the response is sent down the wire. Always use + Late mode in an operational server.

+ +

Early mode is designed as a test/debugging aid for developers. + Directives defined using the early keyword are set + right at the beginning of processing the request. This means + they can be used to simulate different requests and set up test + cases, but it also means that headers may be changed at any time + by other modules before generating a Response.

+ +

Because early directives are processed before the request path's + configuration is traversed, early headers can only be set in a + main server or virtual host context. Early directives cannot depend + on a request path, so they will fail in contexts such as + <Directory> or <Location>.

+
top
+

Examples

    @@ -140,7 +162,7 @@ is available only in Apache 2.0 +header [value] [early|env=[!]variable] @@ -232,15 +254,18 @@ is available only in Apache 2.0
    Description:Configure HTTP response headers
    Syntax:Header [condition] set|append|add|unset|echo -header [value] [env=[!]variable]
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Extension

The Header directive may be followed by an - additional argument, which may be used to specify conditions - under which the action will be taken. If the environment variable specified in the + an additional argument, which may be used to specify conditions under + which the action will be taken, or may be the keyword early + to specify early processing. If the + environment variable specified in the env=... argument exists (or if the environment variable does not exist and env=!... is specified) then the action specified by the Header directive will take effect. Otherwise, the directive will have no effect on the request.

-

The Header directives are processed just +

Except in early mode, 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.

@@ -251,7 +276,7 @@ is available only in Apache 2.0 +[value] [early|env=[!]variable] @@ -301,14 +326,17 @@ is available only in Apache 2.0
Description:Configure HTTP request headers
Syntax:RequestHeader set|append|add|unset header -[value] [env=[!]variable]
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Extension

The RequestHeader directive may be followed by an additional argument, which may be used to specify conditions under - which the action will be taken. If the environment + which the action will be taken, or may be the keyword early + to specify early processing. If the + environment variable specified in the env=... argument exists (or if the environment variable does not exist and env=!... is specified) then the action specified by the RequestHeader directive will take effect. Otherwise, the directive will have no effect on the request.

-

The RequestHeader directive is processed +

Except in early mode, the + RequestHeader directive is processed just before the request is run by its handler in the fixup phase. This should allow headers generated by the browser, or by Apache input filters to be overridden or modified.

diff --git a/docs/manual/mod/mod_headers.xml.ja b/docs/manual/mod/mod_headers.xml.ja index ff8a43432d..97d61188f9 100644 --- a/docs/manual/mod/mod_headers.xml.ja +++ b/docs/manual/mod/mod_headers.xml.ja @@ -1,7 +1,7 @@ - +