Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 1437:8e7995bb8c6b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented proxy_request_buffering and friends.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 24 Mar 2015 15:17:21 +0300
parents 5addfab7e171
children 657885fd2b96
comparison
equal deleted inserted replaced
1436:2333e08e277d 1437:8e7995bb8c6b
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="35"> 13 rev="36">
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 passing 18 The <literal>ngx_http_proxy_module</literal> module allows passing
1461 </para> 1461 </para>
1462 1462
1463 </directive> 1463 </directive>
1464 1464
1465 1465
1466 <directive name="proxy_request_buffering">
1467 <syntax><value>on</value> | <value>off</value></syntax>
1468 <default>on</default>
1469 <context>http</context>
1470 <context>server</context>
1471 <context>location</context>
1472 <appeared-in>1.7.11</appeared-in>
1473
1474 <para>
1475 Enables or disables buffering of a client request body.
1476 </para>
1477
1478 <para>
1479 When buffering is enabled, the entire request body is
1480 <link doc="ngx_http_core_module.xml" id="client_body_buffer_size">read</link>
1481 from the client before sending the request to a proxied server.
1482 </para>
1483
1484 <para>
1485 When buffering is disabled, the request body is sent to the proxied server
1486 immediately as it is received.
1487 In this case, the request cannot be
1488 <link id="proxy_next_upstream">sent to the next server</link>
1489 if nginx already started sending the request body.
1490 </para>
1491
1492 <para>
1493 When HTTP/1.1 chunked transfer encoding is used
1494 to send the original request body,
1495 the request body will be buffered unless
1496 <link id="proxy_http_version">HTTP/1.1 is enabled</link> for proxying.
1497 </para>
1498
1499 </directive>
1500
1501
1466 <directive name="proxy_send_lowat"> 1502 <directive name="proxy_send_lowat">
1467 <syntax><value>size</value></syntax> 1503 <syntax><value>size</value></syntax>
1468 <default>0</default> 1504 <default>0</default>
1469 <context>http</context> 1505 <context>http</context>
1470 <context>server</context> 1506 <context>server</context>