nginx-site: xml/en/docs/http/ngx_http_fastcgi

annotate xml/en/docs/http/ngx_http_fastcgi_module.xml @ 2457:3896055c397e

Fixed descriptions of $proxy_protocol_addr and $proxy_protocol_port.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Thu, 31 Oct 2019 15:35:51 +0300
parents	d765ffffd08c
children	a5bbfdf88bbd

rev	line source
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1 <?xml version="1.0"?>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	2
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 575 diff changeset	3 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 575 diff changeset	4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 575 diff changeset	5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 575 diff changeset	6 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 575 diff changeset	7
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	9
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	10 <module name="Module ngx_http_fastcgi_module"
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	11 link="/en/docs/http/ngx_http_fastcgi_module.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	12 lang="en"
2254 d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	13 rev="51">
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	15 <section id="summary">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	16
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	17 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	18 The <literal>ngx_http_fastcgi_module</literal> module allows passing
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	19 requests to a FastCGI server.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	20 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	21
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	22 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	23
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	24
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	25 <section id="example" name="Example Configuration">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	26
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	27 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	28 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	29 location / {
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	30 fastcgi_pass localhost:9000;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	31 fastcgi_index index.php;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	32
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	33 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	34 fastcgi_param QUERY_STRING $query_string;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	35 fastcgi_param REQUEST_METHOD $request_method;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	36 fastcgi_param CONTENT_TYPE $content_type;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	37 fastcgi_param CONTENT_LENGTH $content_length;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	38 }
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	39 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	40 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	41
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	42 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	43
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	44
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	45 <section id="directives" name="Directives">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	46
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	47 <directive name="fastcgi_bind">
1885 6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1838 diff changeset	48 <syntax>
6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1838 diff changeset	49 <value>address</value>
6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1838 diff changeset	50 [<literal>transparent</literal>] \|
6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1838 diff changeset	51 <literal>off</literal></syntax>
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	52 <default/>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	53 <context>http</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	54 <context>server</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	55 <context>location</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	56 <appeared-in>0.8.22</appeared-in>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	57
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	58 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	59 Makes outgoing connections to a FastCGI server originate
1748 be371be7a5c8 Documented optional port for proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1731 diff changeset	60 from the specified local IP address with an optional port (1.11.2).
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	61 Parameter value can contain variables (1.3.12).
815 ed29fd8be462 _bind: variables support and inheritance. Ruslan Ermilov <ru@nginx.com>* parents: 793 diff changeset	62 The special value <literal>off</literal> (1.3.12) cancels the effect
ed29fd8be462 _bind: variables support and inheritance. Ruslan Ermilov <ru@nginx.com>* parents: 793 diff changeset	63 of the <literal>fastcgi_bind</literal> directive
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	64 inherited from the previous configuration level, which allows the
1748 be371be7a5c8 Documented optional port for proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1731 diff changeset	65 system to auto-assign the local IP address and port.
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	66 </para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	67
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	68 <para id="fastcgi_bind_transparent">
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	69 The <literal>transparent</literal> parameter (1.11.0) allows
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	70 outgoing connections to a FastCGI server originate
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	71 from a non-local IP address,
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	72 for example, from a real IP address of a client:
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	73 <example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	74 fastcgi_bind $remote_addr transparent;
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	75 </example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	76 In order for this parameter to work,
2090 a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 2083 diff changeset	77 it is usually necessary to run nginx worker processes with the
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 2083 diff changeset	78 <link doc="../ngx_core_module.xml" id="user">superuser</link> privileges.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 2083 diff changeset	79 On Linux it is not required (1.13.8) as if
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 2083 diff changeset	80 the <literal>transparent</literal> parameter is specified, worker processes
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 2083 diff changeset	81 inherit the <literal>CAP_NET_RAW</literal> capability from the master process.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 2083 diff changeset	82 It is also necessary to configure kernel routing table
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	83 to intercept network traffic from the FastCGI server.
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	84 </para>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	85
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	86 </directive>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	87
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	88
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	89 <directive name="fastcgi_buffer_size">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	90 <syntax><value>size</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	91 <default>4k\|8k</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	92 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	93 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	94 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	95
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	96 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	97 Sets the <value>size</value> of the buffer used for reading the first part
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	98 of the response received from the FastCGI server.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	99 This part usually contains a small response header.
1550 305f2c338181 Fixed description of default value of proxy_buffer_size and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1542 diff changeset	100 By default, the buffer size is equal to one memory page.
305f2c338181 Fixed description of default value of proxy_buffer_size and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1542 diff changeset	101 This is either 4K or 8K, depending on a platform.
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	102 It can be made smaller, however.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	103 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	104
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	105 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	106
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	107
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	108 <directive name="fastcgi_buffering">
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	109 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	110 <default>on</default>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	111 <context>http</context>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	112 <context>server</context>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	113 <context>location</context>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	114 <appeared-in>1.5.6</appeared-in>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	115
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	116 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	117 Enables or disables buffering of responses from the FastCGI server.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	118 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	119
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	120 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	121 When buffering is enabled, nginx receives a response from the FastCGI server
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	122 as soon as possible, saving it into the buffers set by the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	123 <link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/> directives.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	124 If the whole response does not fit into memory, a part of it can be saved
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	125 to a <link id="fastcgi_temp_path">temporary file</link> on the disk.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	126 Writing to temporary files is controlled by the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	127 <link id="fastcgi_max_temp_file_size"/> and
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	128 <link id="fastcgi_temp_file_write_size"/> directives.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	129 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	130
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	131 <para>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	132 When buffering is disabled, the response is passed to a client synchronously,
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	133 immediately as it is received.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	134 nginx will not try to read the whole response from the FastCGI server.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	135 The maximum size of the data that nginx can receive from the server
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	136 at a time is set by the <link id="fastcgi_buffer_size"/> directive.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	137 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	138
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	139 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	140 Buffering can also be enabled or disabled by passing
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	141 “<literal>yes</literal>” or “<literal>no</literal>” in the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	142 <header>X-Accel-Buffering</header> response header field.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	143 This capability can be disabled using the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	144 <link id="fastcgi_ignore_headers"/> directive.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	145 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	146
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	147 </directive>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	148
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	149
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	150 <directive name="fastcgi_buffers">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	151 <syntax><value>number</value> <value>size</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	152 <default>8 4k\|8k</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	153 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	154 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	155 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	156
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	157 <para>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	158 Sets the <value>number</value> and <value>size</value> of the
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	159 buffers used for reading a response from the FastCGI server,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	160 for a single connection.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	161 By default, the buffer size is equal to one memory page.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	162 This is either 4K or 8K, depending on a platform.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	163 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	164
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	165 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	166
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	167
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	168 <directive name="fastcgi_busy_buffers_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	169 <syntax><value>size</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	170 <default>8k\|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	171 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	172 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	173 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	174
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	175 <para>
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	176 When <link id="fastcgi_buffering">buffering</link> of responses from the FastCGI
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	177 server is enabled, limits the total <value>size</value> of buffers that
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	178 can be busy sending a response to the client while the response is not
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	179 yet fully read.
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	180 In the meantime, the rest of the buffers can be used for reading the response
4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	181 and, if needed, buffering part of the response to a temporary file.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	182 By default, <value>size</value> is limited by the size of two buffers set by the
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	183 <link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/> directives.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	184 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	185
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	186 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	187
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	188
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	189 <directive name="fastcgi_cache">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	190 <syntax><value>zone</value> \| <literal>off</literal></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	191 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	192 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	193 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	194 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	195
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	196 <para>
575 ebcb351d9eb3 Consistently using the term "shared memory zone". Ruslan Ermilov <ru@nginx.com> parents: 509 diff changeset	197 Defines a shared memory zone used for caching.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	198 The same zone can be used in several places.
1382 94cac978bda3 Documented variables support in proxy_cache and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1379 diff changeset	199 Parameter value can contain variables (1.7.9).
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	200 The <literal>off</literal> parameter disables caching inherited
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	201 from the previous configuration level.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	202 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	203
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	204 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	205
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	206
1909 399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	207 <directive name="fastcgi_cache_background_update">
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	208 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	209 <default>off</default>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	210 <context>http</context>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	211 <context>server</context>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	212 <context>location</context>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	213 <appeared-in>1.11.10</appeared-in>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	214
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	215 <para>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	216 Allows starting a background subrequest
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	217 to update an expired cache item,
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	218 while a stale cached response is returned to the client.
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	219 Note that it is necessary to
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	220 <link id="fastcgi_cache_use_stale_updating">allow</link>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	221 the usage of a stale cached response when it is being updated.
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	222 </para>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	223
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	224 </directive>
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	225
399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	226
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	227 <directive name="fastcgi_cache_bypass">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	228 <syntax><value>string</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	229 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	230 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	231 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	232 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	233
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	234 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	235 Defines conditions under which the response will not be taken from a cache.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	236 If at least one value of the string parameters is not empty and is not
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	237 equal to “0” then the response will not be taken from the cache:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	238 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	239 fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	240 fastcgi_cache_bypass $http_pragma $http_authorization;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	241 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	242 Can be used along with the <link id="fastcgi_no_cache"/> directive.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	243 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	244
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	245 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	246
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	247
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	248 <directive name="fastcgi_cache_key">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	249 <syntax><value>string</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	250 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	251 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	252 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	253 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	254
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	255 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	256 Defines a key for caching, for example
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	257 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	258 fastcgi_cache_key localhost:9000$request_uri;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	259 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	260 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	261
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	262 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	263
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	264
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	265 <directive name="fastcgi_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	266 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	267 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	268 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	269 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	270 <context>location</context>
310 86732337c730 Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout, Ruslan Ermilov <ru@nginx.com> parents: 302 diff changeset	271 <appeared-in>1.1.12</appeared-in>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	272
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	273 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	274 When enabled, only one request at a time will be allowed to populate
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	275 a new cache element identified according to the <link id="fastcgi_cache_key"/>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	276 directive by passing a request to a FastCGI server.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	277 Other requests of the same cache element will either wait
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	278 for a response to appear in the cache or the cache lock for
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	279 this element to be released, up to the time set by the
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	280 <link id="fastcgi_cache_lock_timeout"/> directive.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	281 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	282
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	283 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	284
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	285
1379 91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	286 <directive name="fastcgi_cache_lock_age">
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	287 <syntax><value>time</value></syntax>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	288 <default>5s</default>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	289 <context>http</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	290 <context>server</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	291 <context>location</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	292 <appeared-in>1.7.8</appeared-in>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	293
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	294 <para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	295 If the last request passed to the FastCGI server
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	296 for populating a new cache element
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	297 has not completed for the specified <value>time</value>,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	298 one more request may be passed to the FastCGI server.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	299 </para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	300
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	301 </directive>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	302
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	303
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	304 <directive name="fastcgi_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	305 <syntax><value>time</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	306 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	307 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	308 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	309 <context>location</context>
310 86732337c730 Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout, Ruslan Ermilov <ru@nginx.com> parents: 302 diff changeset	310 <appeared-in>1.1.12</appeared-in>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	311
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	312 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	313 Sets a timeout for <link id="fastcgi_cache_lock"/>.
1379 91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	314 When the <value>time</value> expires,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	315 the request will be passed to the FastCGI server,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	316 however, the response will not be cached.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	317 <note>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	318 Before 1.7.8, the response could be cached.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	319 </note>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	320 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	321
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	322 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	323
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	324
1838 0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	325 <directive name="fastcgi_cache_max_range_offset">
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	326 <syntax><value>number</value></syntax>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	327 <default/>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	328 <context>http</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	329 <context>server</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	330 <context>location</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	331 <appeared-in>1.11.6</appeared-in>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	332
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	333 <para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	334 Sets an offset in bytes for byte-range requests.
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	335 If the range is beyond the offset,
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	336 the range request will be passed to the FastCGI server
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	337 and the response will not be cached.
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	338 </para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	339
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	340 </directive>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	341
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	342
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	343 <directive name="fastcgi_cache_methods">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	344 <syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	345 <literal>GET</literal> \|
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	346 <literal>HEAD</literal> \|
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	347 <literal>POST</literal>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	348 ...</syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	349 <default>GET HEAD</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	350 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	351 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	352 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	353 <appeared-in>0.7.59</appeared-in>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	354
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	355 <para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	356 If the client request method is listed in this directive then
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	357 the response will be cached.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	358 “<literal>GET</literal>” and “<literal>HEAD</literal>” methods are always
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	359 added to the list, though it is recommended to specify them explicitly.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	360 See also the <link id="fastcgi_no_cache"/> directive.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	361 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	362
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	363 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	364
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	365
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	366 <directive name="fastcgi_cache_min_uses">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	367 <syntax><value>number</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	368 <default>1</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	369 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	370 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	371 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	372
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	373 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	374 Sets the <value>number</value> of requests after which the response
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	375 will be cached.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	376 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	377
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	378 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	379
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	380
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	381 <directive name="fastcgi_cache_path">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	382 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	383 <value>path</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	384 [<literal>levels</literal>=<value>levels</value>]
1384 66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	385 [<literal>use_temp_path</literal>=<literal>on</literal>\|<literal>off</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	386 <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	387 [<literal>inactive</literal>=<value>time</value>]
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	388 [<literal>max_size</literal>=<value>size</value>]
1810 bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	389 [<literal>manager_files</literal>=<value>number</value>]
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	390 [<literal>manager_sleep</literal>=<value>time</value>]
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	391 [<literal>manager_threshold</literal>=<value>time</value>]
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	392 [<literal>loader_files</literal>=<value>number</value>]
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	393 [<literal>loader_sleep</literal>=<value>time</value>]
1582 8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	394 [<literal>loader_threshold</literal>=<value>time</value>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	395 [<literal>purger</literal>=<literal>on</literal>\|<literal>off</literal>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	396 [<literal>purger_files</literal>=<value>number</value>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	397 [<literal>purger_sleep</literal>=<value>time</value>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	398 [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	399 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	400 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	401
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	402 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	403 Sets the path and other parameters of a cache.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	404 Cache data are stored in files.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	405 Both the key and file name in a cache are a result of
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	406 applying the MD5 function to the proxied URL.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	407
1796 1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1748 diff changeset	408 The <literal>levels</literal> parameter defines hierarchy levels of a cache:
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1748 diff changeset	409 from 1 to 3, each level accepts values 1 or 2.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	410 For example, in the following configuration
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	411 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	412 fastcgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	413 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	414 file names in a cache will look like this:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	415 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	416 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	417 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	418 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	419
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	420 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	421 A cached response is first written to a temporary file,
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	422 and then the file is renamed.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	423 Starting from version 0.8.9, temporary files and the cache can be put on
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	424 different file systems.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	425 However, be aware that in this case a file is copied
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	426 across two file systems instead of the cheap renaming operation.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	427 It is thus recommended that for any given location both cache and a directory
1384 66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	428 holding temporary files
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	429 are put on the same file system.
1384 66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	430 A directory for temporary files is set based on
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	431 the <literal>use_temp_path</literal> parameter (1.7.10).
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	432 If this parameter is omitted or set to the value <literal>on</literal>,
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	433 the directory set by the <link id="fastcgi_temp_path"/> directive
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	434 for the given location will be used.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	435 If the value is set to <literal>off</literal>,
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	436 temporary files will be put directly in the cache directory.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	437 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	438
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	439 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	440 In addition, all active keys and information about data are stored
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	441 in a shared memory zone, whose <value>name</value> and <value>size</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	442 are configured by the <literal>keys_zone</literal> parameter.
1189 f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	443 One megabyte zone can store about 8 thousand keys.
2069 fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	444 <note>
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	445 As part of
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	446 <commercial_version>commercial subscription</commercial_version>,
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	447 the shared memory zone also stores extended
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	448 cache <link doc="ngx_http_api_module.xml" id="http_caches_">information</link>,
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	449 thus, it is required to specify a larger zone size for the same number of keys.
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	450 For example,
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	451 one megabyte zone can store about 4 thousand keys.
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286). Yaroslav Zhuravlev <yar@nginx.com> parents: 1991 diff changeset	452 </note>
1189 f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	453 </para>
f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	454
f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	455 <para>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	456 Cached data that are not accessed during the time specified by the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	457 <literal>inactive</literal> parameter get removed from the cache
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	458 regardless of their freshness.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	459 By default, <literal>inactive</literal> is set to 10 minutes.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	460 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	461
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	462 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	463 The special “cache manager” process monitors the maximum cache size set
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	464 by the <literal>max_size</literal> parameter.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	465 When this size is exceeded, it removes the least recently used data.
1810 bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	466 The data is removed in iterations configured by
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	467 <literal>manager_files</literal>,
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	468 <literal>manager_threshold</literal>, and
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	469 <literal>manager_sleep</literal> parameters (1.11.5).
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	470 During one iteration no more than <literal>manager_files</literal> items
1812 35ec213c16cf Removed extraneous whitespace. Ruslan Ermilov <ru@nginx.com> parents: 1810 diff changeset	471 are deleted (by default, 100).
1810 bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	472 The duration of one iteration is limited by the
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	473 <literal>manager_threshold</literal> parameter (by default, 200 milliseconds).
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	474 Between iterations, a pause configured by the <literal>manager_sleep</literal>
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	475 parameter (by default, 50 milliseconds) is made.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	476 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	477
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	478 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	479 A minute after the start the special “cache loader” process is activated.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	480 It loads information about previously cached data stored on file system
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	481 into a cache zone.
1810 bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	482 The loading is also done in iterations.
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	483 During one iteration no more than <literal>loader_files</literal> items
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	484 are loaded (by default, 100).
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	485 Besides, the duration of one iteration is limited by the
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	486 <literal>loader_threshold</literal> parameter (by default, 200 milliseconds).
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	487 Between iterations, a pause configured by the <literal>loader_sleep</literal>
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	488 parameter (by default, 50 milliseconds) is made.
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	489 </para>
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	490
1582 8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	491 <para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	492 Additionally,
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	493 the following parameters are available as part of our
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	494 <commercial_version>commercial subscription</commercial_version>:
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	495 </para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	496
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	497 <para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	498 <list type="tag">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	499
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	500 <tag-name id="purger">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	501 <literal>purger</literal>=<literal>on</literal>\|<literal>off</literal>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	502 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	503 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	504 Instructs whether cache entries that match a
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	505 <link id="fastcgi_cache_purge">wildcard key</link>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	506 will be removed from the disk by the cache purger (1.7.12).
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	507 Setting the parameter to <literal>on</literal>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	508 (default is <literal>off</literal>)
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	509 will activate the “cache purger” process that
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	510 permanently iterates through all cache entries
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	511 and deletes the entries that match the wildcard key.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	512 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	513
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	514 <tag-name id="purger_files">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	515 <literal>purger_files</literal>=<value>number</value>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	516 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	517 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	518 Sets the number of items that will be scanned during one iteration (1.7.12).
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	519 By default, <literal>purger_files</literal> is set to 10.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	520 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	521
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	522 <tag-name id="purger_threshold">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	523 <literal>purger_threshold</literal>=<value>number</value>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	524 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	525 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	526 Sets the duration of one iteration (1.7.12).
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	527 By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	528 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	529
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	530 <tag-name id="purger_sleep">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	531 <literal>purger_sleep</literal>=<value>number</value>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	532 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	533 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	534 Sets a pause between iterations (1.7.12).
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	535 By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	536 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	537
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	538 </list>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	539 </para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	540
1973 3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	541 <para>
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	542 <note>
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	543 In versions 1.7.3, 1.7.7, and 1.11.10 cache header format has been changed.
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	544 Previously cached responses will be considered invalid
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	545 after upgrading to a newer nginx version.
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	546 </note>
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	547 </para>
3460bd328287 Documented cache version change in proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1956 diff changeset	548
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	549 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	550
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	551
1028 e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	552 <directive name="fastcgi_cache_purge">
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	553 <syntax>string ...</syntax>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	554 <default/>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	555 <context>http</context>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	556 <context>server</context>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	557 <context>location</context>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	558 <appeared-in>1.5.7</appeared-in>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	559
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	560 <para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	561 Defines conditions under which the request will be considered a cache
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	562 purge request.
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	563 If at least one value of the string parameters is not empty and is not equal
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	564 to “0” then the cache entry with a corresponding
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	565 <link id="fastcgi_cache_key">cache key</link> is removed.
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	566 The result of successful operation is indicated by returning
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	567 the <http-status code="204" text="No Content"/> response.
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	568 </para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	569
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	570 <para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	571 If the <link id="fastcgi_cache_key">cache key</link> of a purge request ends
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	572 with an asterisk (“<literal>*</literal>”), all cache entries matching the
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	573 wildcard key will be removed from the cache.
1582 8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	574 However, these entries will remain on the disk until they are deleted
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	575 for either <link id="fastcgi_cache_path">inactivity</link>,
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	576 or processed by the <link id="purger">cache purger</link> (1.7.12),
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	577 or a client attempts to access them.
1028 e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	578 </para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	579
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	580 <para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	581 Example configuration:
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	582 <example>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	583 fastcgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	584
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	585 map $request_method $purge_method {
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	586 PURGE 1;
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	587 default 0;
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	588 }
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	589
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	590 server {
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	591 ...
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	592 location / {
1185 f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	593 fastcgi_pass backend;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	594 fastcgi_cache cache_zone;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	595 fastcgi_cache_key $uri;
1028 e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	596 fastcgi_cache_purge $purge_method;
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	597 }
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	598 }
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	599 </example>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	600 <note>
1128 1594ed379f1f De-i18n'ed <commercial_version/>. Ruslan Ermilov <ru@nginx.com> parents: 1088 diff changeset	601 This functionality is available as part of our
1594ed379f1f De-i18n'ed <commercial_version/>. Ruslan Ermilov <ru@nginx.com> parents: 1088 diff changeset	602 <commercial_version>commercial subscription</commercial_version>.
1028 e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	603 </note>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	604 </para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	605
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	606 </directive>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	607
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	608
1011 2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	609 <directive name="fastcgi_cache_revalidate">
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	610 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	611 <default>off</default>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	612 <context>http</context>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	613 <context>server</context>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	614 <context>location</context>
1015 af77dd40abeb Documented the appearance of "fastcgi_" and "proxy_cache_revalidate". Vladimir Homutov <vl@nginx.com> parents: 1011 diff changeset	615 <appeared-in>1.5.7</appeared-in>
1011 2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	616
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	617 <para>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	618 Enables revalidation of expired cache items using conditional requests with
1246 5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1189 diff changeset	619 the <header>If-Modified-Since</header> and <header>If-None-Match</header>
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1189 diff changeset	620 header fields.
1011 2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	621 </para>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	622
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	623 </directive>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	624
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	625
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	626 <directive name="fastcgi_cache_use_stale">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	627 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	628 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	629 <literal>timeout</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	630 <literal>invalid_header</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	631 <literal>updating</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	632 <literal>http_500</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	633 <literal>http_503</literal> \|
917 e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	634 <literal>http_403</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	635 <literal>http_404</literal> \|
1956 dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	636 <literal>http_429</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	637 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	638 ...</syntax>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	639 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	640 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	641 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	642 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	643
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	644 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	645 Determines in which cases a stale cached response can be used
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	646 when an error occurs during communication with the FastCGI server.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	647 The directive’s parameters match the parameters of the
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	648 <link id="fastcgi_next_upstream"/> directive.
505 837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	649 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	650
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	651 <para>
1542 a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	652 The <literal>error</literal> parameter also permits
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	653 using a stale cached response if a FastCGI server to process a request
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	654 cannot be selected.
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	655 </para>
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	656
1909 399d0e188195 Documented proxy_cache_background_update and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	657 <para id="fastcgi_cache_use_stale_updating">
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	658 Additionally, the <literal>updating</literal> parameter permits
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	659 using a stale cached response if it is currently being updated.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	660 This allows minimizing the number of accesses to FastCGI servers
505 837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	661 when updating cached data.
1912 ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	662 </para>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	663
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	664 <para>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	665 Using a stale cached response
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	666 can also be enabled directly in the response header
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	667 for a specified number of seconds after the response became stale (1.11.10).
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	668 This has lower priority than using the directive parameters.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	669 <list type="bullet" compact="no">
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	670
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	671 <listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	672 The
1910 41cf2c2d8c5c Cache: support for stale-while-revalidate and stale-if-error. Yaroslav Zhuravlev <yar@nginx.com> parents: 1909 diff changeset	673 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
1912 ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	674 extension of the <header>Cache-Control</header> header field permits
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	675 using a stale cached response if it is currently being updated.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	676 </listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	677
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	678 <listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	679 The
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	680 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	681 extension of the <header>Cache-Control</header> header field permits
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	682 using a stale cached response in case of an error.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	683 </listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	684
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1910 diff changeset	685 </list>
505 837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	686 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	687
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	688 <para>
509 0e55c9a48da9 Trimmed space at EOL. Ruslan Ermilov <ru@nginx.com> parents: 508 diff changeset	689 To minimize the number of accesses to FastCGI servers when
505 837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	690 populating a new cache element, the <link id="fastcgi_cache_lock"/>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	691 directive can be used.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	692 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	693
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	694 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	695
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	696
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	697 <directive name="fastcgi_cache_valid">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	698 <syntax>[<value>code</value> ...] <value>time</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	699 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	700 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	701 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	702 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	703
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	704 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	705 Sets caching time for different response codes.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	706 For example, the following directives
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	707 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	708 fastcgi_cache_valid 200 302 10m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	709 fastcgi_cache_valid 404 1m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	710 </example>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	711 set 10 minutes of caching for responses with codes 200 and 302
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	712 and 1 minute for responses with code 404.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	713 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	714
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	715 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	716 If only caching <value>time</value> is specified
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	717 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	718 fastcgi_cache_valid 5m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	719 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	720 then only 200, 301, and 302 responses are cached.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	721 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	722
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	723 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	724 In addition, the <literal>any</literal> parameter can be specified
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	725 to cache any responses:
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	726 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	727 fastcgi_cache_valid 200 302 10m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	728 fastcgi_cache_valid 301 1h;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	729 fastcgi_cache_valid any 1m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	730 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	731 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	732
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	733 <para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	734 Parameters of caching can also be set directly
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	735 in the response header.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	736 This has higher priority than setting of caching time using the directive.
1349 97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	737 <list type="bullet" compact="no">
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	738
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	739 <listitem>
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	740 The <header>X-Accel-Expires</header> header field sets caching time of a
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	741 response in seconds.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	742 The zero value disables caching for a response.
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	743 If the value starts with the <literal>@</literal> prefix, it sets an absolute
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	744 time in seconds since Epoch, up to which the response may be cached.
1349 97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	745 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	746
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	747 <listitem>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	748 If the header does not include the <header>X-Accel-Expires</header> field,
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	749 parameters of caching may be set in the header fields
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	750 <header>Expires</header> or <header>Cache-Control</header>.
1349 97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	751 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	752
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	753 <listitem>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	754 If the header includes the <header>Set-Cookie</header> field, such a
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	755 response will not be cached.
1349 97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	756 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	757
1353 25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	758 <listitem>
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	759 If the header includes the <header>Vary</header> field
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	760 with the special value “<literal>*</literal>”, such a
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	761 response will not be cached (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	762 If the header includes the <header>Vary</header> field
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	763 with another value, such a response will be cached
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	764 taking into account the corresponding request header fields (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	765 </listitem>
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	766
1349 97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	767 </list>
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	768 Processing of one or more of these response header fields can be disabled
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	769 using the <link id="fastcgi_ignore_headers"/> directive.
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	770 </para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	771
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	772 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	773
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	774
862 6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	775 <directive name="fastcgi_catch_stderr">
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	776 <syntax><value>string</value></syntax>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	777 <default/>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	778 <context>http</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	779 <context>server</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	780 <context>location</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	781
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	782 <para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	783 Sets a string to search for in the error stream of a response
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	784 received from a FastCGI server.
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	785 If the <value>string</value> is found then it is considered that the FastCGI
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	786 server has returned an <link id="fastcgi_next_upstream">invalid response</link>.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	787 This allows handling application errors in nginx, for example:
862 6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	788 <example>
2206 5cacd6fffade Eliminated some examples of unsafe prefix locations. Ruslan Ermilov <ru@nginx.com> parents: 2090 diff changeset	789 location /php/ {
862 6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	790 fastcgi_pass backend:9000;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	791 ...
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	792 fastcgi_catch_stderr "PHP Fatal error";
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	793 fastcgi_next_upstream error timeout invalid_header;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	794 }
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	795 </example>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	796 </para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	797
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	798 </directive>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	799
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	800
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	801 <directive name="fastcgi_connect_timeout">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	802 <syntax><value>time</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	803 <default>60s</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	804 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	805 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	806 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	807
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	808 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	809 Defines a timeout for establishing a connection with a FastCGI server.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	810 It should be noted that this timeout cannot usually exceed 75 seconds.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	811 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	812
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	813 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	814
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	815
1338 c63717ebc5bc Typo fixed. Maxim Dounin <mdounin@mdounin.ru> parents: 1337 diff changeset	816 <directive name="fastcgi_force_ranges">
1337 91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	817 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	818 <default>off</default>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	819 <context>http</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	820 <context>server</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	821 <context>location</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	822 <appeared-in>1.7.7</appeared-in>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	823
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	824 <para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	825 Enables byte-range support
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	826 for both cached and uncached responses from the FastCGI server
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	827 regardless of the <header>Accept-Ranges</header> field in these responses.
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	828 </para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	829
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	830 </directive>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	831
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	832
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	833 <directive name="fastcgi_hide_header">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	834 <syntax><value>field</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	835 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	836 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	837 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	838 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	839
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	840 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	841 By default,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	842 nginx does not pass the header fields <header>Status</header> and
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	843 <header>X-Accel-...</header> from the response of a FastCGI
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	844 server to a client.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	845 The <literal>fastcgi_hide_header</literal> directive sets additional fields
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	846 that will not be passed.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	847 If, on the contrary, the passing of fields needs to be permitted,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	848 the <link id="fastcgi_pass_header"/> directive can be used.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	849 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	850
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	851 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	852
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	853
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	854 <directive name="fastcgi_ignore_client_abort">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	855 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	856 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	857 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	858 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	859 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	860
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	861 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	862 Determines whether the connection with a FastCGI server should be
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	863 closed when a client closes the connection without waiting
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	864 for a response.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	865 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	866
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	867 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	868
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	869
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	870 <directive name="fastcgi_ignore_headers">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	871 <syntax><value>field</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	872 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	873 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	874 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	875 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	876
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	877 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	878 Disables processing of certain response header fields from the FastCGI server.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	879 The following fields can be ignored: <header>X-Accel-Redirect</header>,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	880 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	881 <header>X-Accel-Buffering</header> (1.1.6),
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	882 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
1345 da296387cdac Documented the Vary support in proxy_ignore_headers and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1343 diff changeset	883 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
da296387cdac Documented the Vary support in proxy_ignore_headers and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1343 diff changeset	884 and <header>Vary</header> (1.7.7).
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	885 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	886
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	887 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	888 If not disabled, processing of these header fields has the following
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	889 effect:
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	890 <list type="bullet" compact="no">
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	891
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	892 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	893 <header>X-Accel-Expires</header>, <header>Expires</header>,
1345 da296387cdac Documented the Vary support in proxy_ignore_headers and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1343 diff changeset	894 <header>Cache-Control</header>, <header>Set-Cookie</header>,
da296387cdac Documented the Vary support in proxy_ignore_headers and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1343 diff changeset	895 and <header>Vary</header>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	896 set the parameters of response <link id="fastcgi_cache_valid">caching</link>;
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	897 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	898
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	899 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	900 <header>X-Accel-Redirect</header> performs an
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	901 <link doc="ngx_http_core_module.xml" id="internal">internal
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	902 redirect</link> to the specified URI;
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	903 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	904
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	905 <listitem>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	906 <header>X-Accel-Limit-Rate</header> sets the
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	907 <link doc="ngx_http_core_module.xml" id="limit_rate">rate
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	908 limit</link> for transmission of a response to a client;
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	909 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	910
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	911 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	912 <header>X-Accel-Buffering</header> enables or disables
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	913 <link id="fastcgi_buffering">buffering</link> of a response;
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	914 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	915
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	916 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	917 <header>X-Accel-Charset</header> sets the desired
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	918 <link doc="ngx_http_charset_module.xml" id="charset"/>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	919 of a response.
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	920 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	921
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	922 </list>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	923 </para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	924
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	925 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	926
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	927
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	928 <directive name="fastcgi_index">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	929 <syntax><value>name</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	930 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	931 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	932 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	933 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	934
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	935 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	936 Sets a file name that will be appended after a URI that ends with
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	937 a slash, in the value of the <var>$fastcgi_script_name</var> variable.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	938 For example, with these settings
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	939 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	940 fastcgi_index index.php;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	941 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	942 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	943 and the “<literal>/page.php</literal>” request,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	944 the <literal>SCRIPT_FILENAME</literal> parameter will be equal to
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	945 “<literal>/home/www/scripts/php/page.php</literal>”,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	946 and with the “<literal>/</literal>” request it will be equal to
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	947 “<literal>/home/www/scripts/php/index.php</literal>”.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	948 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	949
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	950 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	951
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	952
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	953 <directive name="fastcgi_intercept_errors">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	954 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	955 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	956 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	957 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	958 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	959
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	960 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	961 Determines whether FastCGI server responses with codes greater than or equal
1803 621d0c682113 Clarified description of proxy_intercept_errors and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1796 diff changeset	962 to 300 should be passed to a client
621d0c682113 Clarified description of proxy_intercept_errors and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1796 diff changeset	963 or be intercepted and redirected to nginx for processing
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	964 with the <link doc="ngx_http_core_module.xml" id="error_page"/> directive.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	965 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	966
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	967 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	968
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	969
316 1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	970 <directive name="fastcgi_keep_conn">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	971 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	972 <default>off</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	973 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	974 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	975 <context>location</context>
498 65843513cff5 Documented that "fastcgi_keep_conn" appeared in 1.1.4. Ruslan Ermilov <ru@nginx.com> parents: 411 diff changeset	976 <appeared-in>1.1.4</appeared-in>
316 1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	977
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	978 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	979 By default, a FastCGI server will close a connection right after
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	980 sending the response.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	981 However, when this directive is set to the value <literal>on</literal>,
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	982 nginx will instruct a FastCGI server to keep connections open.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	983 This is necessary, in particular, for
316 1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	984 <link doc="ngx_http_upstream_module.xml" id="keepalive"/>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	985 connections to FastCGI servers to function.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	986 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	987
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	988 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	989
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	990
1343 1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	991 <directive name="fastcgi_limit_rate">
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	992 <syntax><value>rate</value></syntax>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	993 <default>0</default>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	994 <context>http</context>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	995 <context>server</context>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	996 <context>location</context>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	997 <appeared-in>1.7.7</appeared-in>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	998
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	999 <para>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1000 Limits the speed of reading the response from the FastCGI server.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1001 The <value>rate</value> is specified in bytes per second.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1002 The zero value disables rate limiting.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1003 The limit is set per a request, and so if nginx simultaneously opens
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1004 two connections to the FastCFI server,
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1005 the overall rate will be twice as much as the specified limit.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1006 The limitation works only if
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1007 <link id="fastcgi_buffering">buffering</link> of responses from the FastCGI
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1008 server is enabled.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1009 </para>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1010
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1011 </directive>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1012
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	1013
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1014 <directive name="fastcgi_max_temp_file_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1015 <syntax><value>size</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1016 <default>1024m</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1017 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1018 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1019 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1020
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1021 <para>
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	1022 When <link id="fastcgi_buffering">buffering</link> of responses from the FastCGI
1153 4e20e4f8f49b Finished truncation of "memory buffers" to just "buffers". Ruslan Ermilov <ru@nginx.com> parents: 1151 diff changeset	1023 server is enabled, and the whole response does not fit into the buffers
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1024 set by the <link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1025 directives, a part of the response can be saved to a temporary file.
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	1026 This directive sets the maximum <value>size</value> of the temporary file.
4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	1027 The size of data written to the temporary file at a time is set
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1028 by the <link id="fastcgi_temp_file_write_size"/> directive.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1029 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1030
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1031 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1032 The zero value disables buffering of responses to temporary files.
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1033 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1034
1352 dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1035 <para>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1036 <note>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1037 This restriction does not apply to responses
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1038 that will be <link id="fastcgi_cache">cached</link>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1039 or <link id="fastcgi_store">stored</link> on disk.
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1040 </note>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1041 </para>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	1042
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1043 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1044
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1045
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1046 <directive name="fastcgi_next_upstream">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1047 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1048 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1049 <literal>timeout</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1050 <literal>invalid_header</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1051 <literal>http_500</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1052 <literal>http_503</literal> \|
917 e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	1053 <literal>http_403</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1054 <literal>http_404</literal> \|
1956 dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	1055 <literal>http_429</literal> \|
1669 c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1056 <literal>non_idempotent</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1057 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1058 ...</syntax>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1059 <default>error timeout</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1060 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1061 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1062 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1063
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1064 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1065 Specifies in which cases a request should be passed to the next server:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1066 <list type="tag">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1067
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1068 <tag-name><literal>error</literal></tag-name>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1069 <tag-desc>an error occurred while establishing a connection with the
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1070 server, passing a request to it, or reading the response header;</tag-desc>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1071
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1072 <tag-name><literal>timeout</literal></tag-name>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1073 <tag-desc>a timeout has occurred while establishing a connection with the
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1074 server, passing a request to it, or reading the response header;</tag-desc>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1075
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1076 <tag-name><literal>invalid_header</literal></tag-name>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1077 <tag-desc>a server returned an empty or invalid response;</tag-desc>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1078
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1079 <tag-name><literal>http_500</literal></tag-name>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1080 <tag-desc>a server returned a response with the code 500;</tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1081
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1082 <tag-name><literal>http_503</literal></tag-name>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1083 <tag-desc>a server returned a response with the code 503;</tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1084
917 e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	1085 <tag-name><literal>http_403</literal></tag-name>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	1086 <tag-desc>a server returned a response with the code 403;</tag-desc>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	1087
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1088 <tag-name><literal>http_404</literal></tag-name>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1089 <tag-desc>a server returned a response with the code 404;</tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1090
1956 dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	1091 <tag-name><literal>http_429</literal></tag-name>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	1092 <tag-desc>a server returned a response with the code 429 (1.11.13);</tag-desc>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	1093
1669 c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1094 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1095 <tag-desc>normally, requests with a
1923 66a30a380fba Fixed links to tools.ietf.org. Ruslan Ermilov <ru@nginx.com> parents: 1912 diff changeset	1096 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
1669 c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1097 method
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1098 (<literal>POST</literal>, <literal>LOCK</literal>, <literal>PATCH</literal>)
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1099 are not passed to the next server
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1100 if a request has been sent to an upstream server (1.9.13);
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1101 enabling this option explicitly allows retrying such requests;
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1102 </tag-desc>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1103
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1104 <tag-name><literal>off</literal></tag-name>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1105 <tag-desc>disables passing a request to the next server.</tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1106
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1107 </list>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1108 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1109
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1110 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1111 One should bear in mind that passing a request to the next server is
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1112 only possible if nothing has been sent to a client yet.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1113 That is, if an error or timeout occurs in the middle of the
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1114 transferring of a response, fixing this is impossible.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1115 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1116
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1117 <para>
1289 57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1246 diff changeset	1118 The directive also defines what is considered an
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1246 diff changeset	1119 <link doc="ngx_http_upstream_module.xml" id="max_fails">unsuccessful
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1246 diff changeset	1120 attempt</link> of communication with a server.
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1121 The cases of <literal>error</literal>, <literal>timeout</literal> and
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1122 <literal>invalid_header</literal> are always considered unsuccessful attempts,
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1123 even if they are not specified in the directive.
1956 dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	1124 The cases of <literal>http_500</literal>, <literal>http_503</literal>,
dd96a09dd4f7 Documented support for "429 Too Many Requests" response. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	1125 and <literal>http_429</literal> are
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1126 considered unsuccessful attempts only if they are specified in the directive.
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1127 The cases of <literal>http_403</literal> and <literal>http_404</literal>
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1128 are never considered unsuccessful attempts.
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1129 </para>
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1130
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1131 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1132 Passing a request to the next server can be limited by
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1133 <link id="fastcgi_next_upstream_tries">the number of tries</link>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1134 and by <link id="fastcgi_next_upstream_timeout">time</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1135 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1136
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1137 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1138
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1139
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1140 <directive name="fastcgi_next_upstream_timeout">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1141 <syntax><value>time</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1142 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1143 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1144 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1145 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1146 <appeared-in>1.7.5</appeared-in>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1147
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1148 <para>
1672 9c98c4498f08 Rephrased the "proxy_next_upstream_timeout" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1669 diff changeset	1149 Limits the time during which a request can be passed to the
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1150 <link id="fastcgi_next_upstream">next server</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1151 The <literal>0</literal> value turns off this limitation.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1152 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1153
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1154 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1155
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1156
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1157 <directive name="fastcgi_next_upstream_tries">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1158 <syntax><value>number</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1159 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1160 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1161 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1162 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1163 <appeared-in>1.7.5</appeared-in>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1164
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1165 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1166 Limits the number of possible tries for passing a request to the
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1167 <link id="fastcgi_next_upstream">next server</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1168 The <literal>0</literal> value turns off this limitation.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1169 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1170
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1171 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1172
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1173
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1174 <directive name="fastcgi_no_cache">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1175 <syntax><value>string</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1176 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1177 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1178 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1179 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1180
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1181 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1182 Defines conditions under which the response will not be saved to a cache.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1183 If at least one value of the string parameters is not empty and is not
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1184 equal to “0” then the response will not be saved:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1185 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1186 fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1187 fastcgi_no_cache $http_pragma $http_authorization;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1188 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1189 Can be used along with the <link id="fastcgi_cache_bypass"/> directive.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1190 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1191
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1192 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1193
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1194
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1195 <directive name="fastcgi_param">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1196 <syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1197 <value>parameter</value> <value>value</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1198 [<literal>if_not_empty</literal>]</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1199 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1200 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1201 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1202 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1203
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1204 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1205 Sets a <value>parameter</value> that should be passed to the FastCGI server.
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	1206 The <value>value</value> can contain text, variables, and their combination.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1207 These directives are inherited from the previous level if and
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1208 only if there are no
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1209 <literal>fastcgi_param</literal>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1210 directives defined on the current level.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1211 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1212
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1213 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1214 The following example shows the minimum required settings for PHP:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1215 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1216 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1217 fastcgi_param QUERY_STRING $query_string;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1218 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1219 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1220
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1221 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1222 The <literal>SCRIPT_FILENAME</literal> parameter is used in PHP for
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1223 determining the script name, and the <literal>QUERY_STRING</literal>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1224 parameter is used to pass request parameters.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1225 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1226
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1227 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1228 For scripts that process <literal>POST</literal> requests, the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1229 following three parameters are also required:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1230 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1231 fastcgi_param REQUEST_METHOD $request_method;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1232 fastcgi_param CONTENT_TYPE $content_type;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1233 fastcgi_param CONTENT_LENGTH $content_length;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1234 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1235 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1236
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1237 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1238 If PHP was built with the <literal>--enable-force-cgi-redirect</literal>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1239 configuration parameter, the <literal>REDIRECT_STATUS</literal> parameter
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1240 should also be passed with the value “200”:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1241 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1242 fastcgi_param REDIRECT_STATUS 200;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1243 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1244 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1245
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1246 <para>
1731 ae6bdb65ca7f Corrected article in fastcgi_param and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1696 diff changeset	1247 If the directive is specified with <literal>if_not_empty</literal> (1.1.11) then
2083 fb5eef3637a4 Avoid double negative in if_not_empty. Sergey Kandaurov <pluknet@nginx.com> parents: 2069 diff changeset	1248 such a parameter will be passed to the server only if its value is not empty:
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1249 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1250 fastcgi_param HTTPS $https if_not_empty;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1251 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1252 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1253
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1254 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1255
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1256
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1257 <directive name="fastcgi_pass">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1258 <syntax><value>address</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1259 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1260 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1261 <context>if in location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1262
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1263 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1264 Sets the address of a FastCGI server.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1265 The address can be specified as a domain name or IP address,
1620 a225fa77389a Port in fastcgi_pass, scgi_pass, and uwsgi_pass is not optional. Ruslan Ermilov <ru@nginx.com> parents: 1582 diff changeset	1266 and a port:
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1267 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	1268 fastcgi_pass localhost:9000;
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1269 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1270 or as a UNIX-domain socket path:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1271 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	1272 fastcgi_pass unix:/tmp/fastcgi.socket;
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1273 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1274 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1275
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1276 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1277 If a domain name resolves to several addresses, all of them will be
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1278 used in a round-robin fashion.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1279 In addition, an address can be specified as a
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1280 <link doc="ngx_http_upstream_module.xml">server group</link>.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1281 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1282
1991 4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1283 <para>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1284 Parameter value can contain variables.
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1285 In this case, if an address is specified as a domain name,
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1286 the name is searched among the described
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1287 <link doc="ngx_http_upstream_module.xml">server groups</link>,
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1288 and, if not found, is determined using a
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1289 <link doc="ngx_http_core_module.xml" id="resolver"/>.
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1290 </para>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass. Ruslan Ermilov <ru@nginx.com> parents: 1973 diff changeset	1291
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1292 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1293
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1294
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1295 <directive name="fastcgi_pass_header">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1296 <syntax><value>field</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1297 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1298 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1299 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1300 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1301
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1302 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1303 Permits passing <link id="fastcgi_hide_header">otherwise disabled</link> header
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1304 fields from a FastCGI server to a client.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1305 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1306
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1307 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1308
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1309
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1310 <directive name="fastcgi_pass_request_body">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1311 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1312 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1313 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1314 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1315 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1316
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1317 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1318 Indicates whether the original request body is passed
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1319 to the FastCGI server.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1320 See also the <link id="fastcgi_pass_request_headers"/> directive.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1321 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1322
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1323 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1324
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1325
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1326 <directive name="fastcgi_pass_request_headers">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1327 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1328 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1329 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1330 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1331 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1332
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1333 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1334 Indicates whether the header fields of the original request are passed
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1335 to the FastCGI server.
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1336 See also the <link id="fastcgi_pass_request_body"/> directive.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1337 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1338
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1339 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1340
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1341
1524 323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1342 <directive name="fastcgi_read_timeout">
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1343 <syntax><value>time</value></syntax>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1344 <default>60s</default>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1345 <context>http</context>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1346 <context>server</context>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1347 <context>location</context>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1348
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1349 <para>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1350 Defines a timeout for reading a response from the FastCGI server.
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1351 The timeout is set only between two successive read operations,
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1352 not for the transmission of the whole response.
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1353 If the FastCGI server does not transmit anything within this time,
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1354 the connection is closed.
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1355 </para>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1356
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1357 </directive>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1358
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1359
1437 8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1360 <directive name="fastcgi_request_buffering">
1659 680cbf783efe Fixed some misuses of "value". Ruslan Ermilov <ru@nginx.com> parents: 1620 diff changeset	1361 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
1437 8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1362 <default>on</default>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1363 <context>http</context>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1364 <context>server</context>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1365 <context>location</context>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1366 <appeared-in>1.7.11</appeared-in>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1367
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1368 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1369 Enables or disables buffering of a client request body.
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1370 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1371
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1372 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1373 When buffering is enabled, the entire request body is
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1374 <link doc="ngx_http_core_module.xml" id="client_body_buffer_size">read</link>
1440 657885fd2b96 Corrected description of proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1437 diff changeset	1375 from the client before sending the request to a FastCGI server.
1437 8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1376 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1377
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1378 <para>
1440 657885fd2b96 Corrected description of proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1437 diff changeset	1379 When buffering is disabled, the request body is sent to the FastCGI server
1437 8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1380 immediately as it is received.
1440 657885fd2b96 Corrected description of proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1437 diff changeset	1381 In this case, the request cannot be passed to the
657885fd2b96 Corrected description of proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1437 diff changeset	1382 <link id="fastcgi_next_upstream">next server</link>
1437 8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1383 if nginx already started sending the request body.
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1384 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1385
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1386 </directive>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1387
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1388
773 24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1389 <directive name="fastcgi_send_lowat">
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1390 <syntax><value>size</value></syntax>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1391 <default>0</default>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1392 <context>http</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1393 <context>server</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1394 <context>location</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1395
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1396 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1397 If the directive is set to a non-zero value, nginx will try to
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1398 minimize the number
773 24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1399 of send operations on outgoing connections to a FastCGI server by using either
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1400 <c-def>NOTE_LOWAT</c-def> flag of the
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1401 <link doc="../events.xml" id="kqueue"/> method,
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1402 or the <c-def>SO_SNDLOWAT</c-def> socket option,
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1403 with the specified <value>size</value>.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1404 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1405
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1406 <para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1407 This directive is ignored on Linux, Solaris, and Windows.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1408 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1409
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1410 </directive>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1411
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1412
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1413 <directive name="fastcgi_send_timeout">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1414 <syntax><value>time</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1415 <default>60s</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1416 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1417 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1418 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1419
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1420 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1421 Sets a timeout for transmitting a request to the FastCGI server.
1149 1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1422 The timeout is set only between two successive write operations,
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1423 not for the transmission of the whole request.
1149 1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1424 If the FastCGI server does not receive anything within this time,
1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1425 the connection is closed.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1426 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1427
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1428 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1429
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1430
2254 d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1431 <directive name="fastcgi_socket_keepalive">
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1432 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1433 <default>off</default>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1434 <context>http</context>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1435 <context>server</context>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1436 <context>location</context>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1437 <appeared-in>1.15.6</appeared-in>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1438
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1439 <para>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1440 Configures the “TCP keepalive” behavior
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1441 for outgoing connections to a FastCGI server.
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1442 By default, the operating system’s settings are in effect for the socket.
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1443 If the directive is set to the value “<literal>on</literal>”, the
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1444 <c-def>SO_KEEPALIVE</c-def> socket option is turned on for the socket.
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1445 </para>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1446
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1447 </directive>
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1448
d765ffffd08c Documented proxy_socket_keepalive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2206 diff changeset	1449
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1450 <directive name="fastcgi_split_path_info">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1451 <syntax><value>regex</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1452 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1453 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1454
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1455 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1456 Defines a regular expression that captures a value for the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1457 <var>$fastcgi_path_info</var> variable.
1149 1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1458 The regular expression should have two captures: the first becomes
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1459 a value of the <var>$fastcgi_script_name</var> variable, the second
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1460 becomes a value of the <var>$fastcgi_path_info</var> variable.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1461 For example, with these settings
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1462 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1463 location ~ ^(.+\.php)(.*)$ {
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1464 fastcgi_split_path_info ^(.+\.php)(.*)$;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1465 fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1466 fastcgi_param PATH_INFO $fastcgi_path_info;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1467 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1468 and the “<literal>/show.php/article/0001</literal>” request,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1469 the <literal>SCRIPT_FILENAME</literal> parameter will be equal to
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1470 “<literal>/path/to/php/show.php</literal>”, and the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1471 <literal>PATH_INFO</literal> parameter will be equal to
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1472 “<literal>/article/0001</literal>”.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1473 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1474
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1475 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1476
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1477
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1478 <directive name="fastcgi_store">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1479 <syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1480 <literal>on</literal> \|
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1481 <literal>off</literal> \|
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1482 <value>string</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1483 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1484 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1485 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1486 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1487
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1488 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1489 Enables saving of files to a disk.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1490 The <literal>on</literal> parameter saves files with paths
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1491 corresponding to the directives
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1492 <link doc="ngx_http_core_module.xml" id="alias"/> or
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1493 <link doc="ngx_http_core_module.xml" id="root"/>.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1494 The <literal>off</literal> parameter disables saving of files.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1495 In addition, the file name can be set explicitly using the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1496 <value>string</value> with variables:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1497 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1498 fastcgi_store /data/www$original_uri;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1499 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1500 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1501
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1502 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1503 The modification time of files is set according to the received
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1504 <header>Last-Modified</header> response header field.
1149 1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1505 The response is first written to a temporary file,
1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1506 and then the file is renamed.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1507 Starting from version 0.8.9, temporary files and the persistent store
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1508 can be put on different file systems.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1509 However, be aware that in this case a file is copied
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1510 across two file systems instead of the cheap renaming operation.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1511 It is thus recommended that for any given location both saved files and a
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1512 directory holding temporary files, set by the <link id="fastcgi_temp_path"/>
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1513 directive, are put on the same file system.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1514 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1515
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1516 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1517 This directive can be used to create local copies of static unchangeable
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1518 files, e.g.:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1519 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1520 location /images/ {
1005 2275611970dd Removed open_file_cache_errors from proxy_store examples. Maxim Dounin <mdounin@mdounin.ru> parents: 995 diff changeset	1521 root /data/www;
2275611970dd Removed open_file_cache_errors from proxy_store examples. Maxim Dounin <mdounin@mdounin.ru> parents: 995 diff changeset	1522 error_page 404 = /fetch$uri;
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1523 }
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1524
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1525 location /fetch/ {
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1526 internal;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1527
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1528 fastcgi_pass backend:9000;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1529 ...
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1530
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1531 fastcgi_store on;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1532 fastcgi_store_access user:rw group:rw all:r;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1533 fastcgi_temp_path /data/temp;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1534
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1535 alias /data/www/;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1536 }
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1537 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1538 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1539
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1540 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1541
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1542
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1543 <directive name="fastcgi_store_access">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1544 <syntax><value>users</value>:<value>permissions</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1545 <default>user:rw</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1546 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1547 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1548 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1549
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1550 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1551 Sets access permissions for newly created files and directories, e.g.:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1552 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1553 fastcgi_store_access user:rw group:rw all:r;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1554 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1555 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1556
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1557 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1558 If any <literal>group</literal> or <literal>all</literal> access permissions
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1559 are specified then <literal>user</literal> permissions may be omitted:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1560 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1561 fastcgi_store_access group:rw all:r;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1562 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1563 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1564
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1565 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1566
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1567
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1568 <directive name="fastcgi_temp_file_write_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1569 <syntax><value>size</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1570 <default>8k\|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1571 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1572 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1573 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1574
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1575 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1576 Limits the <value>size</value> of data written to a temporary file
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1577 at a time, when buffering of responses from the FastCGI server
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1578 to temporary files is enabled.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1579 By default, <value>size</value> is limited by two buffers set by the
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1580 <link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/> directives.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1581 The maximum size of a temporary file is set by the
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1582 <link id="fastcgi_max_temp_file_size"/> directive.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1583 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1584
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1585 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1586
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1587
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1588 <directive name="fastcgi_temp_path">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1589 <syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1590 <value>path</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1591 [<value>level1</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1592 [<value>level2</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1593 [<value>level3</value>]]]</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1594 <default>fastcgi_temp</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1595 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1596 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1597 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1598
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1599 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1600 Defines a directory for storing temporary files
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1601 with data received from FastCGI servers.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1602 Up to three-level subdirectory hierarchy can be used underneath the specified
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1603 directory.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1604 For example, in the following configuration
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1605 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1606 fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1607 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1608 a temporary file might look like this:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1609 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1610 /spool/nginx/fastcgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1611 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1612 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1613
1384 66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1614 <para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1615 See also the <literal>use_temp_path</literal> parameter of the
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1616 <link id="fastcgi_cache_path"/> directive.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1617 </para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1618
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1619 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1620
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1621 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1622
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1623
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1624 <section id="parameters" name="Parameters Passed to a FastCGI Server">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1625
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1626 <para>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	1627 HTTP request header fields are passed to a FastCGI server as parameters.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1628 In applications and scripts running as FastCGI servers,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1629 these parameters are usually made available as environment variables.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1630 For example, the <header>User-Agent</header> header field is passed as the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1631 <literal>HTTP_USER_AGENT</literal> parameter.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1632 In addition to HTTP request header fields, it is possible to pass arbitrary
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1633 parameters using the <link id="fastcgi_param"/> directive.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1634 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1635
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1636 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1637
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1638
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1639 <section id="variables" name="Embedded Variables">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1640
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1641 <para>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1642 The <literal>ngx_http_fastcgi_module</literal> module supports embedded
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1643 variables that can be used to set parameters using the
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1644 <link id="fastcgi_param"/> directive:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1645 <list type="tag">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1646
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1153 diff changeset	1647 <tag-name id="var_fastcgi_script_name"><var>$fastcgi_script_name</var>
07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1153 diff changeset	1648 </tag-name>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1649 <tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1650 request URI or, if a URI ends with a slash, request URI with an index file
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1651 name configured by the <link id="fastcgi_index"/> directive appended to it.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1652 This variable can be used to set the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1653 <literal>SCRIPT_FILENAME</literal> and <literal>PATH_TRANSLATED</literal>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1654 parameters that determine the script name in PHP.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1655 For example, for the “<literal>/info/</literal>” request with the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1656 following directives
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1657 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1658 fastcgi_index index.php;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1659 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1660 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1661 the <literal>SCRIPT_FILENAME</literal> parameter will be equal to
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1662 “<literal>/home/www/scripts/php/info/index.php</literal>”.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1663
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1664 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1665 When using the <link id="fastcgi_split_path_info"/> directive,
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1666 the <var>$fastcgi_script_name</var> variable equals the value of
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1667 the first capture set by the directive.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1668 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1669 </tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1670
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1153 diff changeset	1671 <tag-name id="var_fastcgi_path_info"><var>$fastcgi_path_info</var></tag-name>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1672 <tag-desc>the value of the second capture set by the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1673 <link id="fastcgi_split_path_info"/> directive.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1674 This variable can be used to set the
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1675 <literal>PATH_INFO</literal> parameter.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1676 </tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1677
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1678 </list>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1679 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1680
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1681 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1682
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1683 </module>

Mercurial > hg > nginx-site

annotate xml/en/docs/http/ngx_http_fastcgi_module.xml @ 2457:3896055c397e