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

annotate xml/en/docs/http/ngx_http_fastcgi_module.xml @ 1838:0d6ac4838921

Documented proxy_cache_max_range_offset and friends.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Thu, 03 Nov 2016 22:01:24 +0300
parents	35ec213c16cf
children	6839c258c473

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"
1838 0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	13 rev="39">
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">
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	48 <syntax><value>address</value> [transparent] \| <literal>off</literal></syntax>
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	49 <default/>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	50 <context>http</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	51 <context>server</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	52 <context>location</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	53 <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	54
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	55 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	56 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	57 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	58 Parameter value can contain variables (1.3.12).
815 ed29fd8be462 _bind: variables support and inheritance. Ruslan Ermilov <ru@nginx.com>* parents: 793 diff changeset	59 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	60 of the <literal>fastcgi_bind</literal> directive
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	61 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	62 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	63 </para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	64
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	65 <para id="fastcgi_bind_transparent">
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	66 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	67 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	68 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	69 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	70 <example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	71 fastcgi_bind $remote_addr transparent;
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	72 </example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	73 In order for this parameter to work,
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	74 it is necessary to run nginx worker processes with the
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	75 <link doc="../ngx_core_module.xml" id="user">superuser</link> privileges
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	76 and configure kernel routing table
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	77 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	78 </para>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	79
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	80 </directive>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	81
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	82
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	83 <directive name="fastcgi_buffer_size">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	84 <syntax><value>size</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	85 <default>4k\|8k</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	86 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	87 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	88 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	89
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	90 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	91 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	92 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	93 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	94 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	95 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	96 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	97 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	98
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	99 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	100
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	101
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	102 <directive name="fastcgi_buffering">
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	103 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	104 <default>on</default>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	105 <context>http</context>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	106 <context>server</context>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	107 <context>location</context>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	108 <appeared-in>1.5.6</appeared-in>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	109
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	110 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	111 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	112 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	113
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	114 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	115 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	116 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	117 <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	118 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	119 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	120 Writing to temporary files is controlled by the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	121 <link id="fastcgi_max_temp_file_size"/> and
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	122 <link id="fastcgi_temp_file_write_size"/> directives.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	123 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	124
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	125 <para>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	126 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	127 immediately as it is received.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	128 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	129 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	130 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	131 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	132
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	133 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	134 Buffering can also be enabled or disabled by passing
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	135 “<literal>yes</literal>” or “<literal>no</literal>” in the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	136 <header>X-Accel-Buffering</header> response header field.
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	137 This capability can be disabled using the
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	138 <link id="fastcgi_ignore_headers"/> directive.
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
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	141 </directive>
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	142
c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	143
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	144 <directive name="fastcgi_buffers">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	145 <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	146 <default>8 4k\|8k</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	147 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	148 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	149 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	150
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	151 <para>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	152 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	153 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	154 for a single connection.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	155 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	156 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	157 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	158
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	159 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	160
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	161
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	162 <directive name="fastcgi_busy_buffers_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	163 <syntax><value>size</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	164 <default>8k\|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	165 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	166 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	167 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	168
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	169 <para>
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	170 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	171 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	172 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	173 yet fully read.
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	174 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	175 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	176 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	177 <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	178 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	179
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	180 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	181
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	182
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	183 <directive name="fastcgi_cache">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	184 <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	185 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	186 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	187 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	188 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	189
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	190 <para>
575 ebcb351d9eb3 Consistently using the term "shared memory zone". Ruslan Ermilov <ru@nginx.com> parents: 509 diff changeset	191 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	192 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	193 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	194 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	195 from the previous configuration level.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	196 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	197
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	198 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	199
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	200
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	201 <directive name="fastcgi_cache_bypass">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	202 <syntax><value>string</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	203 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	204 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	205 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	206 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	207
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	208 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	209 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	210 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	211 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	212 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	213 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	214 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	215 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	216 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	217 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	218
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	219 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	220
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	221
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	222 <directive name="fastcgi_cache_key">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	223 <syntax><value>string</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	224 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	225 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	226 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	227 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	228
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	229 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	230 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	231 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	232 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	233 </example>
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
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	236 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	237
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	238
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	239 <directive name="fastcgi_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	240 <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	241 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	242 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	243 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	244 <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	245 <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	246
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	247 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	248 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	249 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	250 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	251 Other requests of the same cache element will either wait
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	252 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	253 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	254 <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	255 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	256
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	257 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	258
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	259
1379 91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	260 <directive name="fastcgi_cache_lock_age">
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	261 <syntax><value>time</value></syntax>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	262 <default>5s</default>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	263 <context>http</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	264 <context>server</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	265 <context>location</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	266 <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	267
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	268 <para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	269 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	270 for populating a new cache element
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	271 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	272 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	273 </para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	274
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	275 </directive>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	276
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	277
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	278 <directive name="fastcgi_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	279 <syntax><value>time</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	280 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	281 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	282 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	283 <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	284 <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	285
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	286 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	287 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	288 When the <value>time</value> expires,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	289 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	290 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	291 <note>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes. Ruslan Ermilov <ru@nginx.com> parents: 1353 diff changeset	292 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	293 </note>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	294 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	295
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	296 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	297
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 298 diff changeset	298
1838 0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	299 <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	300 <syntax><value>number</value></syntax>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	301 <default/>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	302 <context>http</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	303 <context>server</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	304 <context>location</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	305 <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	306
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	307 <para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	308 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	309 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	310 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	311 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	312 </para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	313
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	314 </directive>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	315
0d6ac4838921 Documented proxy_cache_max_range_offset and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1812 diff changeset	316
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	317 <directive name="fastcgi_cache_methods">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	318 <syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	319 <literal>GET</literal> \|
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	320 <literal>HEAD</literal> \|
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	321 <literal>POST</literal>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	322 ...</syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	323 <default>GET HEAD</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	324 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	325 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	326 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	327 <appeared-in>0.7.59</appeared-in>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	328
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	329 <para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	330 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	331 the response will be cached.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	332 “<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	333 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	334 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	335 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	336
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	337 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	338
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	339
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	340 <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	341 <syntax><value>number</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	342 <default>1</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	343 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	344 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	345 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	346
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	347 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	348 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	349 will be cached.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	350 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	351
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	352 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	353
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	354
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	355 <directive name="fastcgi_cache_path">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	356 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	357 <value>path</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	358 [<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	359 [<literal>use_temp_path</literal>=<literal>on</literal>\|<literal>off</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	360 <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	361 [<literal>inactive</literal>=<value>time</value>]
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	362 [<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	363 [<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	364 [<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	365 [<literal>manager_threshold</literal>=<value>time</value>]
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	366 [<literal>loader_files</literal>=<value>number</value>]
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	367 [<literal>loader_sleep</literal>=<value>time</value>]
1582 8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	368 [<literal>loader_threshold</literal>=<value>time</value>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	369 [<literal>purger</literal>=<literal>on</literal>\|<literal>off</literal>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	370 [<literal>purger_files</literal>=<value>number</value>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	371 [<literal>purger_sleep</literal>=<value>time</value>]
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	372 [<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	373 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	374 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	375
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	376 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	377 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	378 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	379 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	380 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	381
1796 1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1748 diff changeset	382 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	383 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	384 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	385 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	386 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	387 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	388 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	389 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	390 /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	391 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	392 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	393
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	394 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	395 A cached response is first written to a temporary file,
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	396 and then the file is renamed.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	397 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	398 different file systems.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	399 However, be aware that in this case a file is copied
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	400 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	401 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	402 holding temporary files
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	403 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	404 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	405 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	406 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	407 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	408 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	409 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	410 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	411 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	412
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	413 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	414 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	415 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	416 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	417 One megabyte zone can store about 8 thousand keys.
f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	418 </para>
f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	419
f25d00109de0 Documented cache keys_zone memory estimates. Maxim Dounin <mdounin@mdounin.ru> parents: 1185 diff changeset	420 <para>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	421 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	422 <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	423 regardless of their freshness.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	424 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	425 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	426
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	427 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	428 The special “cache manager” process monitors the maximum cache size set
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	429 by the <literal>max_size</literal> parameter.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	430 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	431 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	432 <literal>manager_files</literal>,
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1803 diff changeset	433 <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	434 <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	435 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	436 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	437 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	438 <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	439 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	440 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	441 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	442
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	443 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	444 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	445 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	446 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	447 The loading is also done in iterations.
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	448 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	449 are loaded (by default, 100).
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	450 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	451 <literal>loader_threshold</literal> parameter (by default, 200 milliseconds).
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	452 Between iterations, a pause configured by the <literal>loader_sleep</literal>
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	453 parameter (by default, 50 milliseconds) is made.
508 5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	454 </para>
5e332fafd228 Documented "cache loader" and its parameters. Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	455
1582 8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	456 <para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	457 Additionally,
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	458 the following parameters are available as part of our
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	459 <commercial_version>commercial subscription</commercial_version>:
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	460 </para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	461
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	462 <para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	463 <list type="tag">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	464
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	465 <tag-name id="purger">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	466 <literal>purger</literal>=<literal>on</literal>\|<literal>off</literal>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	467 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	468 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	469 Instructs whether cache entries that match a
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	470 <link id="fastcgi_cache_purge">wildcard key</link>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	471 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	472 Setting the parameter to <literal>on</literal>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	473 (default is <literal>off</literal>)
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	474 will activate the “cache purger” process that
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	475 permanently iterates through all cache entries
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	476 and deletes the entries that match the wildcard key.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	477 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	478
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	479 <tag-name id="purger_files">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	480 <literal>purger_files</literal>=<value>number</value>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	481 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	482 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	483 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	484 By default, <literal>purger_files</literal> is set to 10.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	485 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	486
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	487 <tag-name id="purger_threshold">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	488 <literal>purger_threshold</literal>=<value>number</value>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	489 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	490 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	491 Sets the duration of one iteration (1.7.12).
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	492 By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	493 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	494
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	495 <tag-name id="purger_sleep">
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	496 <literal>purger_sleep</literal>=<value>number</value>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	497 </tag-name>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	498 <tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	499 Sets a pause between iterations (1.7.12).
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	500 By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	501 </tag-desc>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	502
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	503 </list>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	504 </para>
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	505
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	506 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	507
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	508
1028 e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	509 <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	510 <syntax>string ...</syntax>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	511 <default/>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	512 <context>http</context>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	513 <context>server</context>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	514 <context>location</context>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	515 <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	516
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	517 <para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	518 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	519 purge request.
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	520 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	521 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	522 <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	523 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	524 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	525 </para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	526
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	527 <para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	528 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	529 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	530 wildcard key will be removed from the cache.
1582 8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	531 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	532 for either <link id="fastcgi_cache_path">inactivity</link>,
8973c7b37854 Updated commercial docs. Yaroslav Zhuravlev <yar@nginx.com> parents: 1550 diff changeset	533 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	534 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	535 </para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	536
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	537 <para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	538 Example configuration:
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	539 <example>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	540 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	541
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	542 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	543 PURGE 1;
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	544 default 0;
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	545 }
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	546
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	547 server {
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	548 ...
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	549 location / {
1185 f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	550 fastcgi_pass backend;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	551 fastcgi_cache cache_zone;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	552 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	553 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	554 }
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	555 }
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	556 </example>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	557 <note>
1128 1594ed379f1f De-i18n'ed <commercial_version/>. Ruslan Ermilov <ru@nginx.com> parents: 1088 diff changeset	558 This functionality is available as part of our
1594ed379f1f De-i18n'ed <commercial_version/>. Ruslan Ermilov <ru@nginx.com> parents: 1088 diff changeset	559 <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	560 </note>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	561 </para>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	562
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	563 </directive>
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	564
e582a10b1917 Documented the "proxy_cache_purge" and "fastcgi_cache_purge" directives. Vladimir Homutov <vl@nginx.com> parents: 1015 diff changeset	565
1011 2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	566 <directive name="fastcgi_cache_revalidate">
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	567 <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	568 <default>off</default>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	569 <context>http</context>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	570 <context>server</context>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	571 <context>location</context>
1015 af77dd40abeb Documented the appearance of "fastcgi_" and "proxy_cache_revalidate". Vladimir Homutov <vl@nginx.com> parents: 1011 diff changeset	572 <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	573
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	574 <para>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	575 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	576 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	577 header fields.
1011 2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	578 </para>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	579
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	580 </directive>
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	581
2ad2f30efdf2 Documented the "fastcgi_" and "proxy_cache_revalidate" directives. Vladimir Homutov <vl@nginx.com> parents: 1005 diff changeset	582
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	583 <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	584 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	585 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	586 <literal>timeout</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	587 <literal>invalid_header</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	588 <literal>updating</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	589 <literal>http_500</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	590 <literal>http_503</literal> \|
917 e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	591 <literal>http_403</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	592 <literal>http_404</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	593 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	594 ...</syntax>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	595 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	596 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	597 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	598 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	599
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	600 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	601 Determines in which cases a stale cached response can be used
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	602 when an error occurs during communication with the FastCGI server.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	603 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	604 <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	605 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	606
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	607 <para>
1542 a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	608 The <literal>error</literal> parameter also permits
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	609 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	610 cannot be selected.
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	611 </para>
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	612
a13a99cf46ea Better documented "_cache_use_stale error". Ruslan Ermilov <ru@nginx.com>* parents: 1524 diff changeset	613 <para>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	614 Additionally, the <literal>updating</literal> parameter permits
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	615 using a stale cached response if it is currently being updated.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	616 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	617 when updating cached data.
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	618 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	619
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale" Ruslan Ermilov <ru@nginx.com> parents: 498 diff changeset	620 <para>
509 0e55c9a48da9 Trimmed space at EOL. Ruslan Ermilov <ru@nginx.com> parents: 508 diff changeset	621 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	622 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	623 directive can be used.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	624 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	625
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	626 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	627
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	628
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	629 <directive name="fastcgi_cache_valid">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	630 <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	631 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	632 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	633 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	634 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	635
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	636 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	637 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	638 For example, the following directives
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	639 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	640 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	641 fastcgi_cache_valid 404 1m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	642 </example>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	643 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	644 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	645 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	646
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	647 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	648 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	649 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	650 fastcgi_cache_valid 5m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	651 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	652 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	653 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	654
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	655 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	656 In addition, the <literal>any</literal> parameter can be specified
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	657 to cache any responses:
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	658 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	659 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	660 fastcgi_cache_valid 301 1h;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	661 fastcgi_cache_valid any 1m;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	662 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	663 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	664
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	665 <para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	666 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	667 in the response header.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	668 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	669 <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	670
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	671 <listitem>
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	672 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	673 response in seconds.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	674 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	675 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	676 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	677 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	678
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	679 <listitem>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	680 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	681 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	682 <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	683 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	684
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	685 <listitem>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	686 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	687 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	688 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	689
1353 25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	690 <listitem>
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	691 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	692 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	693 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	694 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	695 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	696 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	697 </listitem>
25db29c8875e Documented how the "Vary" response header field affects caching. Ruslan Ermilov <ru@nginx.com> parents: 1352 diff changeset	698
1349 97c8b146cb0e Split the long paragraph about caching parameters into the list. Ruslan Ermilov <ru@nginx.com> parents: 1345 diff changeset	699 </list>
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	700 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	701 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	702 </para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	703
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	704 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	705
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	706
862 6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	707 <directive name="fastcgi_catch_stderr">
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	708 <syntax><value>string</value></syntax>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	709 <default/>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	710 <context>http</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	711 <context>server</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	712 <context>location</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	713
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	714 <para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	715 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	716 received from a FastCGI server.
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	717 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	718 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	719 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	720 <example>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	721 location /php {
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	722 fastcgi_pass backend:9000;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	723 ...
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	724 fastcgi_catch_stderr "PHP Fatal error";
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	725 fastcgi_next_upstream error timeout invalid_header;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	726 }
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	727 </example>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	728 </para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	729
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	730 </directive>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	731
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive. Homutov Vladimir <vl@nginx.com> parents: 815 diff changeset	732
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	733 <directive name="fastcgi_connect_timeout">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	734 <syntax><value>time</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	735 <default>60s</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	736 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	737 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	738 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	739
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	740 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	741 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	742 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	743 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	744
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	745 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	746
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	747
1338 c63717ebc5bc Typo fixed. Maxim Dounin <mdounin@mdounin.ru> parents: 1337 diff changeset	748 <directive name="fastcgi_force_ranges">
1337 91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	749 <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	750 <default>off</default>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	751 <context>http</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	752 <context>server</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	753 <context>location</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	754 <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	755
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	756 <para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	757 Enables byte-range support
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	758 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	759 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	760 </para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	761
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	762 </directive>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	763
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	764
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	765 <directive name="fastcgi_hide_header">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	766 <syntax><value>field</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	767 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	768 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	769 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	770 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	771
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	772 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	773 By default,
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	774 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	775 <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	776 server to a client.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	777 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	778 that will not be passed.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	779 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	780 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	781 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	782
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	783 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	784
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	785
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	786 <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	787 <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	788 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	789 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	790 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	791 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	792
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	793 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	794 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	795 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	796 for a response.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	797 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	798
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	799 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	800
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	801
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	802 <directive name="fastcgi_ignore_headers">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	803 <syntax><value>field</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	804 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	805 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	806 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	807 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	808
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	809 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	810 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	811 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	812 <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	813 <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	814 <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	815 <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	816 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	817 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	818
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	819 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	820 If not disabled, processing of these header fields has the following
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	821 effect:
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	822 <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	823
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	824 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	825 <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	826 <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	827 and <header>Vary</header>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	828 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	829 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	830
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	831 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	832 <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	833 <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	834 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	835 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	836
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	837 <listitem>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	838 <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	839 <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	840 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	841 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	842
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	843 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	844 <header>X-Accel-Buffering</header> enables or disables
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	845 <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	846 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	847
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	848 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	849 <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	850 <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	851 of a response.
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	852 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	853
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	854 </list>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	855 </para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 505 diff changeset	856
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	857 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	858
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	859
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	860 <directive name="fastcgi_index">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	861 <syntax><value>name</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	862 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	863 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	864 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	865 <context>location</context>
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 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	868 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	869 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	870 For example, with these settings
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	871 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	872 fastcgi_index index.php;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	873 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	874 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	875 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	876 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	877 “<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	878 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	879 “<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	880 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	881
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	882 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	883
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	884
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	885 <directive name="fastcgi_intercept_errors">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	886 <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	887 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	888 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	889 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	890 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	891
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	892 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	893 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	894 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	895 or be intercepted and redirected to nginx for processing
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	896 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	897 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	898
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	899 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	900
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	901
316 1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	902 <directive name="fastcgi_keep_conn">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	903 <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	904 <default>off</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	905 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	906 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	907 <context>location</context>
498 65843513cff5 Documented that "fastcgi_keep_conn" appeared in 1.1.4. Ruslan Ermilov <ru@nginx.com> parents: 411 diff changeset	908 <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	909
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	910 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	911 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	912 sending the response.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	913 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	914 nginx will instruct a FastCGI server to keep connections open.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	915 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	916 <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	917 connections to FastCGI servers to function.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	918 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	919
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	920 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	921
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	922
1343 1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	923 <directive name="fastcgi_limit_rate">
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	924 <syntax><value>rate</value></syntax>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	925 <default>0</default>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	926 <context>http</context>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	927 <context>server</context>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	928 <context>location</context>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	929 <appeared-in>1.7.7</appeared-in>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	930
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	931 <para>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	932 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	933 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	934 The zero value disables rate limiting.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	935 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	936 two connections to the FastCFI server,
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	937 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	938 The limitation works only if
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	939 <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	940 server is enabled.
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	941 </para>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	942
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	943 </directive>
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	944
1bdde28e359b Fixed fallouts from the previous change. Ruslan Ermilov <ru@nginx.com> parents: 1342 diff changeset	945
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	946 <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	947 <syntax><value>size</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	948 <default>1024m</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	949 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	950 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	951 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	952
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	953 <para>
995 c5ccf511346a Documented the "fastcgi_buffering" directive. Ruslan Ermilov <ru@nginx.com> parents: 966 diff changeset	954 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	955 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	956 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	957 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	958 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	959 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	960 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	961 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	962
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	963 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	964 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	965 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	966
1352 dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	967 <para>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	968 <note>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	969 This restriction does not apply to responses
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	970 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	971 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	972 </note>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	973 </para>
dbb618f60a54 Elaborate on writing proxied responses to files. Ruslan Ermilov <ru@nginx.com> parents: 1349 diff changeset	974
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	975 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	976
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	977
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	978 <directive name="fastcgi_next_upstream">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	979 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	980 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	981 <literal>timeout</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	982 <literal>invalid_header</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	983 <literal>http_500</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	984 <literal>http_503</literal> \|
917 e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	985 <literal>http_403</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	986 <literal>http_404</literal> \|
1669 c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	987 <literal>non_idempotent</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	988 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	989 ...</syntax>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	990 <default>error timeout</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	991 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	992 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	993 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	994
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	995 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	996 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	997 <list type="tag">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	998
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	999 <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	1000 <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	1001 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	1002
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1003 <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	1004 <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	1005 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	1006
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1007 <tag-name><literal>invalid_header</literal></tag-name>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1008 <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	1009
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1010 <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	1011 <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	1012
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1013 <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	1014 <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	1015
917 e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends. Maxim Dounin <mdounin@mdounin.ru> parents: 907 diff changeset	1016 <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	1017 <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	1018
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1019 <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	1020 <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	1021
1669 c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1022 <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	1023 <tag-desc>normally, requests with a
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1024 <link url="http://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1025 method
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1026 (<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	1027 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	1028 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	1029 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	1030 </tag-desc>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1659 diff changeset	1031
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1032 <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	1033 <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	1034
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1035 </list>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1036 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1037
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1038 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1039 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	1040 only possible if nothing has been sent to a client yet.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1041 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	1042 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	1043 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1044
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1045 <para>
1289 57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1246 diff changeset	1046 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	1047 <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	1048 attempt</link> of communication with a server.
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1049 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	1050 <literal>invalid_header</literal> are always considered unsuccessful attempts,
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1051 even if they are not specified in the directive.
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1052 The cases of <literal>http_500</literal> and <literal>http_503</literal> are
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1053 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	1054 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	1055 are never considered unsuccessful attempts.
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1056 </para>
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 917 diff changeset	1057
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1058 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1059 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	1060 <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	1061 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	1062 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1063
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1064 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1065
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1066
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1067 <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	1068 <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	1069 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1070 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1071 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1072 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1073 <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	1074
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1075 <para>
1672 9c98c4498f08 Rephrased the "proxy_next_upstream_timeout" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1669 diff changeset	1076 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	1077 <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	1078 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	1079 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1080
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1081 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1082
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1083
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1084 <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	1085 <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	1086 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1087 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1088 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1089 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1090 <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	1091
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1092 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1093 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	1094 <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	1095 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	1096 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	1097
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1098 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1099
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1100
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1101 <directive name="fastcgi_no_cache">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1102 <syntax><value>string</value> ...</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1103 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1104 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1105 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1106 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1107
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 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	1110 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	1111 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	1112 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1113 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	1114 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	1115 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1116 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	1117 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1118
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1119 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1120
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1121
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1122 <directive name="fastcgi_param">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1123 <syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1124 <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	1125 [<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	1126 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1127 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1128 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1129 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1130
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1131 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1132 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	1133 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	1134 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	1135 only if there are no
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1136 <literal>fastcgi_param</literal>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1137 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	1138 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1139
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1140 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1141 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	1142 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1143 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	1144 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	1145 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1146 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1147
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1148 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1149 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	1150 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	1151 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	1152 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1153
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1154 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1155 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	1156 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	1157 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1158 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	1159 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	1160 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	1161 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1162 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1163
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1164 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1165 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	1166 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	1167 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	1168 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1169 fastcgi_param REDIRECT_STATUS 200;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1170 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1171 </para>
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 <para>
1731 ae6bdb65ca7f Corrected article in fastcgi_param and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1696 diff changeset	1174 If the directive is specified with <literal>if_not_empty</literal> (1.1.11) then
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1175 such a parameter will not be passed to the server until its value is not empty:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1176 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1177 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	1178 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1179 </para>
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 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1182
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1183
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1184 <directive name="fastcgi_pass">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1185 <syntax><value>address</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1186 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1187 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1188 <context>if in location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1189
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1190 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1191 Sets the address of a FastCGI server.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1192 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	1193 and a port:
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1194 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	1195 fastcgi_pass localhost:9000;
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1196 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1197 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	1198 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	1199 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	1200 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1201 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1202
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1203 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1204 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	1205 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	1206 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	1207 <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	1208 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1209
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1210 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1211
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 <directive name="fastcgi_pass_header">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1214 <syntax><value>field</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1215 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1216 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1217 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1218 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1219
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1220 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1221 Permits passing <link id="fastcgi_hide_header">otherwise disabled</link> header
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1222 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	1223 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1224
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1225 </directive>
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
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1228 <directive name="fastcgi_pass_request_body">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1229 <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	1230 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1231 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1232 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1233 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1234
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1235 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1236 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	1237 to the FastCGI server.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1238 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	1239 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1240
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1241 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1242
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1243
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1244 <directive name="fastcgi_pass_request_headers">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1245 <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	1246 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1247 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1248 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1249 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1250
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1251 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1252 Indicates whether the header fields of the original request are passed
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1253 to the FastCGI server.
793 9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1254 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	1255 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1256
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1257 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1258
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives. Vladimir Homutov <vl@nginx.com> parents: 773 diff changeset	1259
1524 323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1260 <directive name="fastcgi_read_timeout">
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1261 <syntax><value>time</value></syntax>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1262 <default>60s</default>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1263 <context>http</context>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1264 <context>server</context>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1265 <context>location</context>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1266
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1267 <para>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1268 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	1269 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	1270 not for the transmission of the whole response.
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1271 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	1272 the connection is closed.
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1273 </para>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1274
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1275 </directive>
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1276
323b0d071166 Relocated proxy_read_timeout and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1440 diff changeset	1277
1437 8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1278 <directive name="fastcgi_request_buffering">
1659 680cbf783efe Fixed some misuses of "value". Ruslan Ermilov <ru@nginx.com> parents: 1620 diff changeset	1279 <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	1280 <default>on</default>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1281 <context>http</context>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1282 <context>server</context>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1283 <context>location</context>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1284 <appeared-in>1.7.11</appeared-in>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1285
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1286 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1287 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	1288 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1289
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1290 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1291 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	1292 <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	1293 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	1294 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1295
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1296 <para>
1440 657885fd2b96 Corrected description of proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1437 diff changeset	1297 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	1298 immediately as it is received.
1440 657885fd2b96 Corrected description of proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1437 diff changeset	1299 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	1300 <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	1301 if nginx already started sending the request body.
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1302 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1303
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1304 </directive>
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1305
8e7995bb8c6b Documented proxy_request_buffering and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1384 diff changeset	1306
773 24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1307 <directive name="fastcgi_send_lowat">
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1308 <syntax><value>size</value></syntax>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1309 <default>0</default>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1310 <context>http</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1311 <context>server</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1312 <context>location</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1313
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1314 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1315 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	1316 minimize the number
773 24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1317 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	1318 <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	1319 <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	1320 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	1321 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	1322 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1323
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1324 <para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1325 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	1326 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1327
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1328 </directive>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1329
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 772 diff changeset	1330
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1331 <directive name="fastcgi_send_timeout">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1332 <syntax><value>time</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1333 <default>60s</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1334 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1335 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1336 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1337
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1338 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1339 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	1340 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	1341 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	1342 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	1343 the connection is closed.
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1344 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1345
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1346 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1347
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1348
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1349 <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	1350 <syntax><value>regex</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1351 <default/>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1352 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1353
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1354 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1355 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	1356 <var>$fastcgi_path_info</var> variable.
1149 1501e5848052 Corrected the usage of the definite article. Yaroslav Zhuravlev <yar@nginx.com> parents: 1146 diff changeset	1357 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	1358 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	1359 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	1360 For example, with these settings
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1361 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1362 location ~ ^(.+\.php)(.*)$ {
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1363 fastcgi_split_path_info ^(.+\.php)(.*)$;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1364 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	1365 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	1366 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1367 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	1368 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	1369 “<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	1370 <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	1371 “<literal>/article/0001</literal>”.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1372 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1373
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1374 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1375
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1376
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1377 <directive name="fastcgi_store">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1378 <syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1379 <literal>on</literal> \|
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1380 <literal>off</literal> \|
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1381 <value>string</value></syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1382 <default>off</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1383 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1384 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1385 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1386
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1387 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1388 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	1389 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	1390 corresponding to the directives
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1391 <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	1392 <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	1393 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	1394 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	1395 <value>string</value> with variables:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1396 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1397 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	1398 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1399 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1400
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1401 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1402 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	1403 <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	1404 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	1405 and then the file is renamed.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1406 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	1407 can be put on different file systems.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1408 However, be aware that in this case a file is copied
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1409 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	1410 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	1411 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	1412 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	1413 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1414
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1415 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1416 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	1417 files, e.g.:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1418 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1419 location /images/ {
1005 2275611970dd Removed open_file_cache_errors from proxy_store examples. Maxim Dounin <mdounin@mdounin.ru> parents: 995 diff changeset	1420 root /data/www;
2275611970dd Removed open_file_cache_errors from proxy_store examples. Maxim Dounin <mdounin@mdounin.ru> parents: 995 diff changeset	1421 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	1422 }
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1423
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1424 location /fetch/ {
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1425 internal;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1426
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1427 fastcgi_pass backend:9000;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1428 ...
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 fastcgi_store on;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1431 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	1432 fastcgi_temp_path /data/temp;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1433
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1434 alias /data/www/;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1435 }
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1436 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1437 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1438
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1439 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1440
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1441
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1442 <directive name="fastcgi_store_access">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1443 <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	1444 <default>user:rw</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1445 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1446 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1447 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1448
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1449 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1450 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	1451 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1452 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	1453 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1454 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1455
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1456 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1457 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	1458 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	1459 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1460 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	1461 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1462 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1463
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1464 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1465
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1466
411 f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1467 <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	1468 <syntax><value>size</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1469 <default>8k\|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1470 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1471 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1472 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1473
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1474 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1475 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	1476 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	1477 to temporary files is enabled.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1478 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	1479 <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	1480 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	1481 <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	1482 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1483
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1484 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1485
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size, Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1486
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1487 <directive name="fastcgi_temp_path">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1488 <syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1489 <value>path</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1490 [<value>level1</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1491 [<value>level2</value>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1492 [<value>level3</value>]]]</syntax>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1493 <default>fastcgi_temp</default>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1494 <context>http</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1495 <context>server</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1496 <context>location</context>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1497
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1498 <para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1499 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	1500 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	1501 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	1502 directory.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1503 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	1504 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1505 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	1506 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1507 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	1508 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1509 /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	1510 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1511 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1512
1384 66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1513 <para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1514 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	1515 <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	1516 </para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1382 diff changeset	1517
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1518 </directive>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1519
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1520 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1521
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1522
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1523 <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	1524
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1525 <para>
1151 4c2324a7eeea Corrected the usage of articles and a comma. Yaroslav Zhuravlev <yar@nginx.com> parents: 1149 diff changeset	1526 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	1527 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	1528 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	1529 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	1530 <literal>HTTP_USER_AGENT</literal> parameter.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1531 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	1532 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	1533 </para>
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 </section>
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
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1538 <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	1539
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1540 <para>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1541 The <literal>ngx_http_fastcgi_module</literal> module supports embedded
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	1542 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	1543 <link id="fastcgi_param"/> directive:
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1544 <list type="tag">
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1545
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1153 diff changeset	1546 <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	1547 </tag-name>
298 0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1548 <tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1549 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	1550 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	1551 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	1552 <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	1553 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	1554 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	1555 following directives
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1556 <example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1557 fastcgi_index index.php;
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1558 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	1559 </example>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1560 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	1561 “<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	1562
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 When using the <link id="fastcgi_split_path_info"/> directive,
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 942 diff changeset	1565 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	1566 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	1567 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1568 </tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1569
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1153 diff changeset	1570 <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	1571 <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	1572 <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	1573 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	1574 <literal>PATH_INFO</literal> parameter.
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1575 </tag-desc>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1576
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1577 </list>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1578 </para>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1579
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1580 </section>
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1581
0dcf07c393b6 English translation of the ngx_http_fastcgi_module module documentation. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1582 </module>

Mercurial > hg > nginx-site

annotate xml/en/docs/http/ngx_http_fastcgi_module.xml @ 1838:0d6ac4838921