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

annotate xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 351:a4fa80755eab

Consistently strip initial offset in examples.

author	Ruslan Ermilov <ru@nginx.com>
date	Tue, 24 Jan 2012 11:01:22 +0000
parents	1fb1c077658b
children	bb51d3e17dd0

rev	line source
222 bfe3eff81d04 Removed redundant encoding specification. Ruslan Ermilov <ru@nginx.com> parents: 135 diff changeset	1 <?xml version="1.0"?>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	4
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	5 <module name="Модуль ngx_http_fastcgi_module"
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	6 link="/ru/docs/http/ngx_http_fastcgi_module.html"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	7 lang="ru">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8
110 40eec261c2a6 Added proper support for anonymous sections, notably for the summary. Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	9 <section id="summary">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	10
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	12 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	13 запросы FastCGI-серверу.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	15
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	18
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	19 <section id="example" name="Пример конфигурации">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	20
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	21 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	22 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	23 location / {
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	24 fastcgi_pass localhost:9000;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	25 fastcgi_index index.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	26
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	27 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	28 fastcgi_param QUERY_STRING $query_string;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	29 fastcgi_param REQUEST_METHOD $request_method;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	30 fastcgi_param CONTENT_TYPE $content_type;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	31 fastcgi_param CONTENT_LENGTH $content_length;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	32 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	33 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	34 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	35
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	36 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	37
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	38
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	39 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	40
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	41 <directive name="fastcgi_buffer_size">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	42 <syntax><value>размер</value></syntax>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	43 <default>4k\|8k</default>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	44 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	45 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	46 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	47
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	48 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	49 Задаёт <value>размер</value> буфера, в который будет читаться
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	50 первая часть ответа, получаемого от FastCGI-сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	51 В этой части ответа находится, как правило, небольшой заголовок ответа.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	52 По умолчанию размер буфера равен размеру одного буфера в директиве
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	53 <link id="fastcgi_buffers"/>, однако его можно сделать меньше.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	54 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	55
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	56 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	57
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	58
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	59 <directive name="fastcgi_buffers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	60 <syntax><value>число</value> <value>размер</value></syntax>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	61 <default>8 4k\|8k</default>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	62 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	63 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	64 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	65
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	66 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	67 Задаёт <value>число</value> и <value>размер</value> буферов
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	68 для одного соединения,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	69 в которые будет читаться ответ, получаемый от FastCGI-сервера.
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	70 По умолчанию размер одного буфера равен размеру страницы.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	71 В зависимости от платформы это или 4K, или 8K.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	74 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	75
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	76
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	77 <directive name="fastcgi_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	78 <syntax><value>зона</value> \| <literal>off</literal></syntax>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	79 <default>off</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	80 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	81 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	82 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	83
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	84 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	85 Задаёт зону для кэширования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	86 Одна и та же зона может использоваться в нескольких местах.
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	87 Параметр <literal>off</literal> запрещает кэширование, унаследованное
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	88 с предыдущего уровня конфигурации.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	90
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	91 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	92
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	93
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	94 <directive name="fastcgi_cache_bypass">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	95 <syntax><value>строка</value> ...</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	96 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	97 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	98 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	99 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	100
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	102 Задаёт условия, при которых ответ не будет браться из кэша.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	103 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	104 то ответ не берётся из кэша:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	105 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	106 fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	107 fastcgi_cache_bypass $http_pragma $http_authorization;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	108 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	109 Можно использовать совместно с директивой <link id="fastcgi_no_cache"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	111
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	112 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	113
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	114
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115 <directive name="fastcgi_cache_key">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	116 <syntax><value>строка</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	117 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	118 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	119 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	120 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	121
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	122 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	123 Задаёт ключ для кэширования, например,
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	124 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	125 fastcgi_cache_key localhost:9000$request_uri;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	126 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	127 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	128
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	129 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	130
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	131
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	132 <directive name="fastcgi_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	133 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	134 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	135 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	136 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	137 <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	138 <appeared-in>1.1.12</appeared-in>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	139
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	140 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	141 Если включено, одновременно только одному запросу будет позволено
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	142 заполнить новый элемент кэша, идентифицируемый согласно директиве
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	143 <link id="fastcgi_cache_key"/>, передав запрос на FastCGI-сервер.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	144 Остальные запросы этого же элемента будут либо ожидать
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	145 появления ответа в кэше, либо освобождения блокировки
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	146 этого элемента, в течение времени, заданного директивой
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	147 <link id="fastcgi_cache_lock_timeout"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	148 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	149
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	150 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	151
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	152
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	153 <directive name="fastcgi_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	154 <syntax><value>время</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	155 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	156 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	157 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	158 <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	159 <appeared-in>1.1.12</appeared-in>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	160
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	161 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	162 Задаёт таймаут для <link id="fastcgi_cache_lock"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	163 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	164
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	165 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	166
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 299 diff changeset	167
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	168 <directive name="fastcgi_cache_min_uses">
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	169 <syntax><value>число</value></syntax>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	170 <default>1</default>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	171 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	172 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	173 <context>location</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	174
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	175 <para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	176 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	177 </para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	178
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	179 </directive>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	180
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	181
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	182 <directive name="fastcgi_cache_path">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	183 <syntax>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	184 <value>путь</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	185 [<literal>levels</literal>=<value>уровни</value>]
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	186 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	187 [<literal>inactive</literal>=<value>время</value>]
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	188 [<literal>max_size</literal>=<value>размер</value>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	189 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	190 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	191
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	192 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	193 Задаёт путь и другие параметры кэша.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	194 Данные кэша хранятся в файлах.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	195 Ключом и именем файла в кэше является результат функции MD5
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	196 от проксированного URL.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	197 Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	198 например, при использовании
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	199 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	200 fastcgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	201 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	202 имена файлов в кэше будут такого вида:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	203 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	204 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	205 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	206 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	207
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	208 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	209 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	210 переименовывается. Начиная с версии 0.8.9, временные файлы и кэш
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	211 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	212 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	213 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	214 Поэтому лучше, если кэш будет находиться на той же файловой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	215 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	216 <link id="fastcgi_temp_path"/> для данного location.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	217 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	218
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	220 Кроме того, все активные ключи и информация о данных хранятся в разделяемой
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	221 памяти — зоне, <value>имя</value> и <value>размер</value> которой
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	222 задаются параметром <literal>keys_zone</literal>.
285 2305be197a84 Spell. Maxim Konovalov <maxim@nginx.com> parents: 275 diff changeset	223 Если к данным кэша не обращаются в течение времени, заданного параметром
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	224 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	225 По умолчанию <literal>inactive</literal> равен 10 минутам.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	227
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	228 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	229 Специальный процесс “cache manager” следит за максимальным размером кэша,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	230 заданным параметром <literal>max_size</literal>, и при превышении
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	231 его размеров удаляет самые невостребованные данные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	232 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	233
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	234 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	235
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	236
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	237 <directive name="fastcgi_cache_use_stale">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	238 <syntax>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	239 <literal>error</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	240 <literal>timeout</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	241 <literal>invalid_header</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	242 <literal>updating</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	243 <literal>http_500</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	244 <literal>http_503</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	245 <literal>http_404</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	246 <literal>off</literal>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	247 ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	248 <default>off</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	249 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	250 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	251 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	252
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	253 <para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	254 Определяет, в каких случаях можно использовать устаревший закэшированный ответ,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	255 если при работе с FastCGI-сервером возникла ошибка.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	256 Параметры директивы совпадают с параметрами
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	257 директивы <link id="fastcgi_next_upstream"/>.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	258 Кроме того, дополнительный параметр <literal>updating</literal>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	259 разрешает использовать устаревший закэшированный ответ,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	260 если на данный момент он уже обновляется.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	261 </para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	262
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	263 </directive>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	264
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	265
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	266 <directive name="fastcgi_cache_valid">
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	267 <syntax>[<value>код</value> ...] <value>время</value></syntax>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	268 <default/>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	269 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	270 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	271 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	272
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	273 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	274 Задаёт время кэширования для разных кодов ответа.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	275 Например, директивы
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	276 <example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	277 fastcgi_cache_valid 200 302 10m;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	278 fastcgi_cache_valid 404 1m;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	279 </example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	280 задают время кэширования 10 минут для ответов с кодами 200 и 302,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	281 и 1 минуту для ответов с кодом 404.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	282 </para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	283
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	284 <para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	285 Если указано только <value>время</value> кэширования,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	286 <example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	287 fastcgi_cache_valid 5m;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	288 </example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	289 то кэшируются только ответы 200, 301 и 302.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	290 </para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	291
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	292 <para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	293 Кроме того, можно кэшировать любые ответы с помощью параметра
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	294 <literal>any</literal>:
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	295 <example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	296 fastcgi_cache_valid 200 302 10m;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	297 fastcgi_cache_valid 301 1h;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	298 fastcgi_cache_valid any 1m;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	299 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	300 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	301
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	302 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	303
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	304
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	305 <directive name="fastcgi_connect_timeout">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	306 <syntax><value>время</value></syntax>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	307 <default>60s</default>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	308 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	309 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	310 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	311
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	312 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	313 Задаёт таймаут для установления соединения с FastCGI-сервером.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	314 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	315 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	316
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	317 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	318
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	319
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	320 <directive name="fastcgi_hide_header">
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	321 <syntax><value>поле</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	322 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	323 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	324 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	325 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	326
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	327 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	328 По умолчанию
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	329 nginx не передаёт клиенту поля заголовка <header>Status</header> и
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	330 <header>X-Accel-...</header> из ответа FastCGI-сервера.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	331 Директива <literal>fastcgi_hide_header</literal> задаёт дополнительные поля,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	332 которые не будут передаваться.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	333 Если же передачу полей нужно разрешить, можно воспользоваться
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	334 директивой <link id="fastcgi_pass_header"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	335 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	336
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	337 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	338
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	339
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	340 <directive name="fastcgi_ignore_client_abort">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	341 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	342 <default>off</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	343 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	344 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	345 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	346
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	347 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	348 Определяет, закрывать ли соединение с FastCGI-сервером
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	349 в случае, если клиент закрыл соединение, не дождавшись ответа.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	350 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	351
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	352 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	353
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	354
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	355 <directive name="fastcgi_ignore_headers">
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	356 <syntax><value>поле</value> ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	357 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	358 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	359 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	360 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	361
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	362 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	363 Запрещает обработку некоторых полей заголовка из ответа FastCGI-сервера.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	364 В директиве можно указать поля <header>X-Accel-Redirect</header>,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	365 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	366 <header>X-Accel-Buffering</header> (1.1.6),
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	367 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	368 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	369 </para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	370
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	371 </directive>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	372
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	373
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	374 <directive name="fastcgi_index">
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	375 <syntax><value>имя</value></syntax>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	376 <default/>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	377 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	378 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	379 <context>location</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	380
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	381 <para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	382 Задаёт имя файла, который при создании переменной
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	383 <var>$fastcgi_script_name</var> будет добавляться после URI,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	384 если URI заканчивается слэшом.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	385 Например, при таких настройках
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	386 <example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	387 fastcgi_index index.php;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	388 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	389 </example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	390 и запросе “<literal>/page.php</literal>”
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	391 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	392 “<literal>/home/www/scripts/php/page.php</literal>”,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	393 а при запросе “<literal>/</literal>”—
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	394 “<literal>/home/www/scripts/php/index.php</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	395 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	396
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	397 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	398
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	399
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	400 <directive name="fastcgi_intercept_errors">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	401 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	402 <default>off</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	403 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	404 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	405 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	406
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	407 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	408 Определяет, передавать ли клиенту ответы FastCGI-сервера с кодом
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	409 больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	410 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	411 </para>
a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	412
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	413 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	414
316 1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	415 <directive name="fastcgi_keep_conn">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	416 <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	417 <default>off</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	418 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	419 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	420 <context>location</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	421
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	422 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	423 По умолчанию FastCGI-сервер будет закрывать соединение сразу же
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	424 после отправки ответа.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	425 При установке значения <literal>on</literal> nginx указывает
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	426 FastCGI-серверу оставлять соединения открытыми.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	427 Это в частности требуется для функционирования
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	428 <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	429 соединений</link> с FastCGI-серверами.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	430 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	431
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	432 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	433
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	434
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	435 <directive name="fastcgi_next_upstream">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	436 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	437 <literal>error</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	438 <literal>timeout</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	439 <literal>invalid_header</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	440 <literal>http_500</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	441 <literal>http_503</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	442 <literal>http_404</literal> \|
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	443 <literal>off</literal>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	444 ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	445 <default>error timeout</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	446 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	447 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	448 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	449
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	450 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	451 Определяет, в каких случаях запрос будет передан следующему серверу:
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	452 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	453
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	454 <tag-name><literal>error</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	455 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	456 чтения заголовка ответа сервера;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	457
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	458 <tag-name><literal>timeout</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	459 <tag-desc>произошёл таймаут во время соединения с сервером,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	460 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	461
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	462 <tag-name><literal>invalid_header</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	463 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	464
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	465 <tag-name><literal>http_500</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	466 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	467
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	468 <tag-name><literal>http_503</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	469 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	470
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	471 <tag-name><literal>http_404</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	472 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	473
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	474 <tag-name><literal>off</literal></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	475 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	476
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	477 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	478 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	479
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	480 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	481 Необходимо понимать, что передача запроса следующему серверу возможна
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	482 только при условии, что клиенту ещё ничего не передавалось.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	483 То есть, если ошибка или таймаут возникли в середине передачи ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	484 то исправить это уже невозможно.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	485 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	486
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	487 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	488
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	489
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	490 <directive name="fastcgi_no_cache">
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	491 <syntax><value>строка</value> ...</syntax>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	492 <default/>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	493 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	494 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	495 <context>location</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	496
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	497 <para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	498 Задаёт условия, при которых ответ не будет сохраняться в кэш.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	499 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	500 то ответ не будет сохранён:
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	501 <example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	502 fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	503 fastcgi_no_cache $http_pragma $http_authorization;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	504 </example>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	505 Можно использовать совместно с директивой <link id="fastcgi_cache_bypass"/>.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	506 </para>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	507
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	508 </directive>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	509
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	510
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	511 <directive name="fastcgi_param">
239 fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	512 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	513 <value>параметр</value> <value>значение</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	514 [<literal>if_not_empty</literal>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	515 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	516 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	517 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	518 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	519
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	520 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	521 Задаёт <value>параметр</value>, который будет передаваться FastCGI-серверу.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	522 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	523 Директивы наследуются с предыдущего уровня при условии, что на данном
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	524 уровне не описаны свои директивы <literal>fastcgi_param</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	525 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	526
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	527 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	528 Ниже приведён пример минимально необходимых параметров для PHP:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	529 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	530 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	531 fastcgi_param QUERY_STRING $query_string;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	532 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	533 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	534
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	535 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	536 Параметр <literal>SCRIPT_FILENAME</literal> используется в PHP для
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	537 определения имени скрипта, а в параметре <literal>QUERY_STRING</literal>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	538 передаются параметры запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	539 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	540
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	541 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	542 Если скрипты обрабатывают запросы <literal>POST</literal>, то нужны
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	543 ещё три параметра:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	544 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	545 fastcgi_param REQUEST_METHOD $request_method;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	546 fastcgi_param CONTENT_TYPE $content_type;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	547 fastcgi_param CONTENT_LENGTH $content_length;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	548 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	549 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	550
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	551 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	552 Если PHP был собран с параметром конфигурации
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	553 <literal>--enable-force-cgi-redirect</literal>, то нужно передавать
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	554 параметр <literal>REDIRECT_STATUS</literal> со значением “200”:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	555 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	556 fastcgi_param REDIRECT_STATUS 200;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	557 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	558 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	559
239 fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	560 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	561 Если директива указана с <literal>if_not_empty</literal> (1.1.11),
239 fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	562 то такой параметр с пустым значением передаваться на сервер не будет:
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	563 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	564 fastcgi_param HTTPS $https if_not_empty;
239 fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	565 </example>
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	566 </para>
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty". Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	567
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	568 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	569
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	570
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	571 <directive name="fastcgi_pass">
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	572 <syntax><value>адрес</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	573 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	574 <context>location</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	575 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	576
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	577 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	578 Задаёт адрес FastCGI-сервера.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	579 Адрес может быть указан в виде доменного имени или адреса, и порта, например,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	580 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	581 fastcgi_pass localhost:9000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	582 </example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	583 или в виде пути UNIX-сокета:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	584 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	585 fastcgi_pass unix:/tmp/fastcgi.socket;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	586 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	587 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	588
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	589 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	590 Если доменному имени соответствует несколько адресов, то все они будут
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	591 использоваться по очереди (round-robin).
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	592 И, кроме того, адрес может быть
135 edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module. Ruslan Ermilov <ru@nginx.com> parents: 110 diff changeset	593 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	594 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	595
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	596 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	597
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	598
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	599 <directive name="fastcgi_pass_header">
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	600 <syntax><value>поле</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	601 <default/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	602 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	603 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	604 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	605
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	606 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	607 Разрешает передавать от FastCGI-сервера клиенту
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	608 <link id="fastcgi_hide_header">запрещённые для передачи</link> поля заголовка.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	609 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	610
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	611 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	612
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	613
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	614 <directive name="fastcgi_read_timeout">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	615 <syntax><value>время</value></syntax>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	616 <default>60s</default>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	617 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	618 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	619 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	620
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	621 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	622 Задаёт таймаут при чтении ответа FastCGI-сервера.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	623 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	624 а только между двумя операциями чтения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	625 Если по истечении этого времени FastCGI-сервер ничего не передаст,
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	626 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	627 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	628
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	629 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	630
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	631
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	632 <directive name="fastcgi_send_timeout">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	633 <syntax><value>время</value></syntax>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	634 <default>60s</default>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	635 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	636 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	637 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	638
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	639 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	640 Задаёт таймаут при передаче запроса FastCGI-серверу.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	641 Таймаут устанавливается не на всю передачу запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	642 а только между двумя операциями записи.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	643 Если по истечении этого времени FastCGI-сервер не примет новых данных,
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	644 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	645 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	646
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	647 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	648
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	649
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	650 <directive name="fastcgi_split_path_info">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	651 <syntax><value>regex</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	652 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	653 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	654
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	655 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	656 Задаёт регулярное выражение, выделяющее значение для переменной
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	657 <var>$fastcgi_path_info</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	658 Регулярное выражение должно иметь два выделения, из которых первое
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	659 становится значением переменной <var>$fastcgi_script_name</var>,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	660 а второе—значением переменной <var>$fastcgi_path_info</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	661 Например, при таких настройках
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	662 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	663 location ~ ^(.+\.php)(.*)$ {
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	664 fastcgi_split_path_info ^(.+\.php)(.*)$;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	665 fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	666 fastcgi_param PATH_INFO $fastcgi_path_info;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	667 </example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	668 и запросе “<literal>/show.php/article/0001</literal>”
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	669 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	670 “<literal>/path/to/php/show.php</literal>”, а параметр
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	671 <literal>PATH_INFO</literal>—“<literal>/article/0001</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	672 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	673
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	674 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	675
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	676
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	677 <directive name="fastcgi_store">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	678 <syntax>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	679 <literal>on</literal> \|
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	680 <literal>off</literal> \|
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	681 <value>строка</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	682 <default>off</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	683 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	684 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	685 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	686
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	687 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	688 Разрешает сохранение на диск файлов.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	689 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	690 указанными в директивах
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	691 <link doc="ngx_http_core_module.xml" id="alias"/> или
56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	692 <link doc="ngx_http_core_module.xml" id="root"/>.
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	693 Параметр <literal>off</literal> запрещает сохранение файлов.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	694 Кроме того, имя файла можно задать явно с помощью строки с переменными:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	695 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	696 fastcgi_store /data/www$original_uri;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	697 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	698 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	699
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	700 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	701 Время изменения файлов выставляется согласно полученному полю
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	702 <header>Last-Modified</header> в заголовке ответа.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	703 Ответ сначала записывается во временный файл, а потом этот файл
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	704 переименовывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	705 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	706 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	707 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	708 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	709 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	710 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	711 <link id="fastcgi_temp_path"/> для данного location.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	712 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	713
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	714 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	715 Директиву можно использовать для создания локальных копий статических
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	716 неизменяемых файлов, например, так:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	717 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	718 location /images/ {
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	719 root /data/www;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	720 open_file_cache_errors off;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	721 error_page 404 = /fetch$uri;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	722 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	723
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	724 location /fetch/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	725 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	726
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	727 fastcgi_pass backend:9000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	728 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	729
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	730 fastcgi_store on;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	731 fastcgi_store_access user:rw group:rw all:r;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	732 fastcgi_temp_path /data/temp;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	733
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	734 alias /data/www/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	735 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	736 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	737 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	738
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	739 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	740
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	741
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	742 <directive name="fastcgi_store_access">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 239 diff changeset	743 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	744 <default>user:rw</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	745 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	746 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	747 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	748
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	749 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	750 Задаёт права доступа для создаваемых файлов и каталогов, например,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	751 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	752 fastcgi_store_access user:rw group:rw all:r;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	753 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	754 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	755
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	756 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	757 Если заданы какие-либо права для <literal>group</literal> или
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	758 <literal>all</literal>, то права для <literal>user</literal>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	759 указывать необязательно:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	760 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	761 fastcgi_store_access group:rw all:r;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	762 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	763 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	764
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	765 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	766
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	767
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	768 <directive name="fastcgi_temp_path">
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	769 <syntax>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	770 <value>путь</value>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	771 [<value>уровень1</value>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	772 [<value>уровень2</value>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	773 [<value>уровень3</value>]]]</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	774 <default>fastcgi_temp</default>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	775 <context>http</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	776 <context>server</context>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	777 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	778
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	779 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	780 Задаёт имя каталога для хранения временных файлов,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	781 полученных от другого сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	782 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	783 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	784 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	785 fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	786 </example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	787 временный файл будет следующего вида:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	788 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	789 /spool/nginx/fastcgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	790 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	791 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	792
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	793 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	794
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	795 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	796
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	797
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	798 <section id="parameters" name="Параметры, передаваемые FastCGI-серверу">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	799
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	800 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	801 Поля заголовка HTTP-запроса передаются FastCGI-серверу в виде параметров.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	802 В приложениях и скриптах, запущенных в виде FastCGI-сервера,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	803 эти параметры обычно доступны в виде переменных среды.
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	804 Например, поле заголовка <header>User-Agent</header> передаётся как параметр
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	805 <literal>HTTP_USER_AGENT</literal>.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	806 Кроме полей заголовка HTTP-запроса можно передавать произвольные параметры
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	807 с помощью директивы <link id="fastcgi_param"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	808 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	809
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	810 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	811
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	812
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	813 <section id="variables" name="Встроенные переменные">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	814
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	815 <para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	816 В модуле <literal>ngx_http_fastcgi_module</literal> есть встроенные переменные,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	817 которые можно использовать для формирования параметров с помощью директивы
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	818 <link id="fastcgi_param"/>:
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	819 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	820
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	821 <tag-name><var>$fastcgi_script_name</var></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	822 <tag-desc>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	823 URI запроса или же, если URI заканчивается слэшом,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	824 то URI запроса, дополненное именем индексного файла, задаваемого директивой
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	825 <link id="fastcgi_index"/>.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	826 Эту переменную можно использовать для задания параметров
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	827 <literal>SCRIPT_FILENAME</literal> и <literal>PATH_TRANSLATED</literal>,
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	828 используемых, в частности, для определения имени скрипта в PHP.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	829 Например, для запроса “<literal>/info/</literal>” и при использовании
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	830 директив
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	831 <example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	832 fastcgi_index index.php;
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	833 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	834 </example>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	835 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	836 “<literal>/home/www/scripts/php/info/index.php</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	837
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	838 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	839 При использовании директивы <link id="fastcgi_split_path_info"/>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	840 переменная <var>$fastcgi_script_name</var> равна значению первого выделения,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	841 задаваемого этой директивой.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	842 </para>
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	843 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	844
295 38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	845 <tag-name><var>$fastcgi_path_info</var></tag-name>
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	846 <tag-desc>значение второго выделения, задаваемого директивой
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	847 <link id="fastcgi_split_path_info"/>.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	848 Эту переменную можно использовать для задания параметра
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	849 <literal>PATH_INFO</literal>.
38e111ec051d Revision. Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	850 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	851
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	852 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	853 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	854
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	855 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	856
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	857 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 351:a4fa80755eab