Permalink
Browse files

releng work for v0.06.

  • Loading branch information...
1 parent f901cec commit 1792f2d93a2bc42d712d05d348e44ac49869c511 @agentzh agentzh committed Dec 15, 2009
Showing with 39 additions and 25 deletions.
  1. +23 −13 README
  2. +16 −12 doc/readme.wiki
View
36 README
@@ -6,9 +6,9 @@ Name
installation instructions.
Version
- This document describes headers-more-nginx-module v0.05
+ This document describes headers-more-nginx-module v0.06
(<http://github.com/agentzh/headers-more-nginx-module/downloads>)
- released on Nov 18, 2009.
+ released on Dec 15, 2009.
Synopsis
# set the Server output header
@@ -77,7 +77,7 @@ Directives
default: *no*
- context: *http, server, location*
+ context: *http, server, location, if*
Adds or replaces the specified output headers when the response status
code matches the codes specified by the "-s" option *AND* the response
@@ -137,7 +137,7 @@ Directives
default: *no*
- context: *http, server, location*
+ context: *http, server, location, if*
Clears the specified output headers.
@@ -161,22 +161,24 @@ Directives
default: *no*
- context: *http, server, location*
+ context: *http, server, location, if*
Very much like more_set_headers except that it operates on input headers
(or request headers) and it only supports the "-t" option.
Behind the scene, use of this directive and its friend
- more_clear_input_headers will (lazily) register an "access phase"
- handler that modifies "r->headers_in" the way you specify.
+ more_clear_input_headers will (lazily) register a "rewrite phase"
+ handler that modifies "r->headers_in" the way you specify. Note that it
+ always run at the *end* of the "rewrite" so that it runs *after* the
+ standard rewrite module and works in subrequests as well.
more_clear_input_headers
syntax: *more_clear_input_headers [-t <content-type list>]...
<new-header>...*
default: *no*
- context: *http, server, location*
+ context: *http, server, location, if*
Clears the specified input headers.
@@ -202,12 +204,12 @@ Limitations
Installation
Grab the nginx source code from nginx.net (<http://nginx.net/>), for
- example, the version 0.8.28 (see nginx compatibility), and then build
+ example, the version 0.8.29 (see nginx compatibility), and then build
the source with this module:
- $ wget 'http://sysoev.ru/nginx/nginx-0.8.28.tar.gz'
- $ tar -xzvf nginx-0.8.28.tar.gz
- $ cd nginx-0.8.28/
+ $ wget 'http://sysoev.ru/nginx/nginx-0.8.29.tar.gz'
+ $ tar -xzvf nginx-0.8.29.tar.gz
+ $ cd nginx-0.8.29/
# Here we assume you would install you nginx under /opt/nginx/.
$ ./configure --prefix=/opt/nginx \
@@ -223,7 +225,7 @@ Installation
Compatibility
The following versions of Nginx should work with this module:
- * 0.8.x (last tested version is 0.8.28)
+ * 0.8.x (last tested version is 0.8.29)
* 0.7.x >= 0.7.44 (last tested version is 0.7.64)
@@ -248,6 +250,10 @@ Source Repository
(<http://github.com/agentzh/headers-more-nginx-module>).
ChangeLog
+ v0.06
+ * now the input header handler runs at the *end* of the "rewrite
+ phase" such that it works in subrequests by default.
+
v0.05
* fixed variables in more_set_input_headers by registering the handler
in the "access phase" instead of the "rewrite" phase.
@@ -342,6 +348,10 @@ See Also
"headers_more" module: Set and clear output headers...more than
'add'!" (<http://www.pubbs.net/nginx/200911/29942/>).
+ * The original blog post
+ (<http://agentzh.spaces.live.com/blog/cns!FF3A735632E41548!482.entry
+ >) about this module's initial development.
+
* The echo module for Nginx module's automated testing.
* The standard headers module.
View
28 doc/readme.wiki
@@ -6,7 +6,7 @@
= Version =
-This document describes headers-more-nginx-module [http://github.com/agentzh/headers-more-nginx-module/downloads v0.05] released on Nov 18, 2009.
+This document describes headers-more-nginx-module [http://github.com/agentzh/headers-more-nginx-module/downloads v0.06] released on Dec 15, 2009.
= Synopsis =
@@ -86,7 +86,7 @@ default apply to all the status codes, including <code>4xx</code> and <code>5xx<
'''default:''' ''no''
-'''context:''' ''http, server, location''
+'''context:''' ''http, server, location, if''
Adds or replaces the specified output headers when the response status code matches the codes specified by the <code>-s</code> option ''AND'' the response content type matches the types specified by the <code>-t</code> option.
@@ -142,7 +142,7 @@ Behind the scene, use of this directive and its friend [[#more_clear_headers|mor
'''default:''' ''no''
-'''context:''' ''http, server, location''
+'''context:''' ''http, server, location, if''
Clears the specified output headers.
@@ -171,18 +171,18 @@ See [[#more_set_headers|more_set_headers]] for more details.
'''default:''' ''no''
-'''context:''' ''http, server, location''
+'''context:''' ''http, server, location, if''
Very much like [[#more_set_headers|more_set_headers]] except that it operates on input headers (or request headers) and it only supports the <code>-t</code> option.
-Behind the scene, use of this directive and its friend [[#more_clear_input_headers|more_clear_input_headers]] will (lazily) register an "access phase" handler that modifies <code>r->headers_in</code> the way you specify.
+Behind the scene, use of this directive and its friend [[#more_clear_input_headers|more_clear_input_headers]] will (lazily) register a <code>rewrite phase</code> handler that modifies <code>r->headers_in</code> the way you specify. Note that it always run at the ''end'' of the <code>rewrite</code> so that it runs ''after'' the standard [[NginxHttpRewriteModule|rewrite module]] and works in subrequests as well.
== more_clear_input_headers ==
'''syntax:''' ''more_clear_input_headers [-t <content-type list>]... <new-header>...''
'''default:''' ''no''
-'''context:''' ''http, server, location''
+'''context:''' ''http, server, location, if''
Clears the specified input headers.
@@ -213,12 +213,12 @@ See [[#more_set_input_headers|more_set_input_headers]] for more details.
= Installation =
Grab the nginx source code from [http://nginx.net/ nginx.net], for example,
-the version 0.8.28 (see [[#Compatibility|nginx compatibility]]), and then build the source with this module:
+the version 0.8.29 (see [[#Compatibility|nginx compatibility]]), and then build the source with this module:
<geshi lang="bash">
- $ wget 'http://sysoev.ru/nginx/nginx-0.8.28.tar.gz'
- $ tar -xzvf nginx-0.8.28.tar.gz
- $ cd nginx-0.8.28/
+ $ wget 'http://sysoev.ru/nginx/nginx-0.8.29.tar.gz'
+ $ tar -xzvf nginx-0.8.29.tar.gz
+ $ cd nginx-0.8.29/
# Here we assume you would install you nginx under /opt/nginx/.
$ ./configure --prefix=/opt/nginx \
@@ -234,7 +234,7 @@ Download the latest version of the release tarball of this module from [http://g
The following versions of Nginx should work with this module:
-* '''0.8.x''' (last tested version is 0.8.28)
+* '''0.8.x''' (last tested version is 0.8.29)
* '''0.7.x >= 0.7.44''' (last tested version is 0.7.64)
Earlier versions of Nginx like 0.6.x and 0.5.x will ''not'' work.
@@ -254,8 +254,11 @@ Available on github at [http://github.com/agentzh/headers-more-nginx-module agen
= ChangeLog =
+== v0.06 ==
+* now the input header handler runs at the ''end'' of the <code>rewrite phase</code> such that it works in subrequests by default.
+
== v0.05 ==
-* fixed variables in more_set_input_headers by registering the handler in the "access phase" instead of the "rewrite" phase.
+* fixed variables in [[#more_set_input_headers|more_set_input_headers]] by registering the handler in the <code>access phase</code> instead of the <code>rewrite</code> phase.
= Test Suite =
@@ -327,6 +330,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
* The original thread on the Nginx mailing list that inspires this module's development: [http://www.pubbs.net/nginx/200910/6361/ "A question about add_header replication"].
* The orginal announcement thread on the Nginx mailing list: [http://www.pubbs.net/nginx/200911/29942/ "The "headers_more" module: Set and clear output headers...more than 'add'!"].
+* The original [http://agentzh.spaces.live.com/blog/cns!FF3A735632E41548!482.entry blog post] about this module's initial development.
* The [[NginxHttpEchoModule|echo module]] for Nginx module's automated testing.
* The standard [[NginxHttpHeadersModule|headers]] module.

0 comments on commit 1792f2d

Please sign in to comment.