Mercurial > hg > nginx-site
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 Fri Dec 21 08:55:43 2012 +0000 +++ b/xml/en/docs/http/ngx_http_proxy_module.xml Fri Dec 21 14:51:50 2012 +0000 @@ -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 @@ </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 @@ <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 Fri Dec 21 08:55:43 2012 +0000 +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml Fri Dec 21 14:51:50 2012 +0000 @@ -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 @@ </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 @@ <para> Позволяет переопределять или добавлять поля заголовка запроса, -передаваемые проксируемому серверу. +<link id="proxy_pass_request_headers">передаваемые</link> проксируемому серверу. В качестве значения можно использовать текст, переменные и их комбинации. Директивы наследуются с предыдущего уровня при условии, что на данном уровне не описаны свои директивы <literal>proxy_set_header</literal>.