changeset 789:1063836dacea

Documented "proxy_pass_request_body/headers" directives.
author Vladimir Homutov <vl@nginx.com>
date Fri, 21 Dec 2012 14:51:50 +0000
parents 753ed7df8910
children ae776a353984
files xml/en/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml
diffstat 2 files changed, 108 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -991,6 +991,58 @@ a connection is closed.
 </directive>
 
 
+<directive name="proxy_pass_request_body">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>on</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+If disabled, the original request body will not be passed
+to the proxied server.
+<example>
+location /x-accel-redirect-here/ {
+    proxy_method GET;
+    proxy_pass_request_body off;
+    proxy_set_header Content-Length "";
+
+    proxy_pass ...
+}
+</example>
+See also the <link id="proxy_set_header"/> and
+<link id="proxy_pass_request_headers"/> directives.
+</para>
+
+</directive>
+
+
+<directive name="proxy_pass_request_headers">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>on</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+If disabled, header fields of the original request will not be passed to the
+proxied server.
+<example>
+location /x-accel-redirect-here/ {
+    proxy_method GET;
+    proxy_pass_request_headers off;
+    proxy_pass_request_body off;
+
+    proxy_pass ...
+}
+</example>
+See also the <link id="proxy_set_header"/> and
+<link id="proxy_pass_request_body"/> directives.
+</para>
+
+</directive>
+
+
 <directive name="proxy_redirect">
 <syntax><literal>default</literal></syntax>
 <syntax><literal>off</literal></syntax>
@@ -1169,7 +1221,7 @@ A <value>value</value> can contain text,
 
 <para>
 Allows to redefine or append fields to the request header
-passed to the proxied server.
+<link id="proxy_pass_request_headers">passed</link> to the proxied server.
 A <value>value</value> can contain text, variables, and their combination.
 These directives are inherited from the previous level if and
 only if there are no
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -989,6 +989,58 @@ proxy_pass $request;
 </directive>
 
 
+<directive name="proxy_pass_request_body">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>on</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Если запрещено, то исходное тело запроса не будет передано
+на проксируемый сервер.
+<example>
+location /x-accel-redirect-here/ {
+    proxy_method GET;
+    proxy_pass_request_body off;
+    proxy_set_header Content-Length "";
+
+    proxy_pass ...
+}
+</example>
+См. также директивы <link id="proxy_set_header"/> и
+<link id="proxy_pass_request_headers"/>.
+</para>
+
+</directive>
+
+
+<directive name="proxy_pass_request_headers">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>on</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Если запрещено, то поля заголовка исходного запроса не будут переданы на
+проксируемый сервер.
+<example>
+location /x-accel-redirect-here/ {
+    proxy_method GET;
+    proxy_pass_request_headers off;
+    proxy_pass_request_body off;
+
+    proxy_pass ...
+}
+</example>
+См. также директивы <link id="proxy_set_header"/> и
+<link id="proxy_pass_request_body"/>.
+</para>
+
+</directive>
+
+
 <directive name="proxy_redirect">
 <syntax><literal>default</literal></syntax>
 <syntax><literal>off</literal></syntax>
@@ -1168,7 +1220,7 @@ proxy_redirect / /;
 
 <para>
 Позволяет переопределять или добавлять поля заголовка запроса,
-передаваемые проксируемому серверу.
+<link id="proxy_pass_request_headers">передаваемые</link> проксируемому серверу.
 В качестве значения можно использовать текст, переменные и их комбинации.
 Директивы наследуются с предыдущего уровня при условии, что на данном
 уровне не описаны свои директивы <literal>proxy_set_header</literal>.