Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 789:1063836dacea

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented "proxy_pass_request_body/headers" directives.
author Vladimir Homutov <vl@nginx.com>
date Fri, 21 Dec 2012 14:51:50 +0000
parents 180a64c709d8
children ae776a353984
comparison
equal deleted inserted replaced
788:753ed7df8910 789:1063836dacea
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_proxy_module" 10 <module name="Module ngx_http_proxy_module"
11 link="/en/docs/http/ngx_http_proxy_module.html" 11 link="/en/docs/http/ngx_http_proxy_module.html"
12 lang="en" 12 lang="en"
13 rev="4"> 13 rev="5">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_proxy_module</literal> module allows to pass 18 The <literal>ngx_http_proxy_module</literal> module allows to pass
989 </para> 989 </para>
990 990
991 </directive> 991 </directive>
992 992
993 993
994 <directive name="proxy_pass_request_body">
995 <syntax><literal>on</literal> | <literal>off</literal></syntax>
996 <default>on</default>
997 <context>http</context>
998 <context>server</context>
999 <context>location</context>
1000
1001 <para>
1002 If disabled, the original request body will not be passed
1003 to the proxied server.
1004 <example>
1005 location /x-accel-redirect-here/ {
1006 proxy_method GET;
1007 proxy_pass_request_body off;
1008 proxy_set_header Content-Length "";
1009
1010 proxy_pass ...
1011 }
1012 </example>
1013 See also the <link id="proxy_set_header"/> and
1014 <link id="proxy_pass_request_headers"/> directives.
1015 </para>
1016
1017 </directive>
1018
1019
1020 <directive name="proxy_pass_request_headers">
1021 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1022 <default>on</default>
1023 <context>http</context>
1024 <context>server</context>
1025 <context>location</context>
1026
1027 <para>
1028 If disabled, header fields of the original request will not be passed to the
1029 proxied server.
1030 <example>
1031 location /x-accel-redirect-here/ {
1032 proxy_method GET;
1033 proxy_pass_request_headers off;
1034 proxy_pass_request_body off;
1035
1036 proxy_pass ...
1037 }
1038 </example>
1039 See also the <link id="proxy_set_header"/> and
1040 <link id="proxy_pass_request_body"/> directives.
1041 </para>
1042
1043 </directive>
1044
1045
994 <directive name="proxy_redirect"> 1046 <directive name="proxy_redirect">
995 <syntax><literal>default</literal></syntax> 1047 <syntax><literal>default</literal></syntax>
996 <syntax><literal>off</literal></syntax> 1048 <syntax><literal>off</literal></syntax>
997 <syntax><value>redirect</value> <value>replacement</value></syntax> 1049 <syntax><value>redirect</value> <value>replacement</value></syntax>
998 <default>default</default> 1050 <default>default</default>
1167 <context>server</context> 1219 <context>server</context>
1168 <context>location</context> 1220 <context>location</context>
1169 1221
1170 <para> 1222 <para>
1171 Allows to redefine or append fields to the request header 1223 Allows to redefine or append fields to the request header
1172 passed to the proxied server. 1224 <link id="proxy_pass_request_headers">passed</link> to the proxied server.
1173 A <value>value</value> can contain text, variables, and their combination. 1225 A <value>value</value> can contain text, variables, and their combination.
1174 These directives are inherited from the previous level if and 1226 These directives are inherited from the previous level if and
1175 only if there are no 1227 only if there are no
1176 <literal>proxy_set_header</literal> 1228 <literal>proxy_set_header</literal>
1177 directives defined on the current level. 1229 directives defined on the current level.