annotate xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 917:e26a18eb5ccd

Documented http_403 in proxy_next_upstream and friends.
author Maxim Dounin <mdounin@mdounin.ru>
date Thu, 30 May 2013 12:29:42 +0400
parents 43887f41bb17
children ba3d6ade3513
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 575
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 575
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 575
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 575
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 575
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
10 <module name="Модуль ngx_http_fastcgi_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_fastcgi_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
13 rev="8">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
18 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
19 запросы FastCGI-серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
20 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
23
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
25 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29 location / {
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
30 fastcgi_pass localhost:9000;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
31 fastcgi_index index.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
33 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
34 fastcgi_param QUERY_STRING $query_string;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
35 fastcgi_param REQUEST_METHOD $request_method;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
36 fastcgi_param CONTENT_TYPE $content_type;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
37 fastcgi_param CONTENT_LENGTH $content_length;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
45 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
47 <directive name="fastcgi_bind">
815
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
48 <syntax><value>адрес</value> | <literal>off</literal></syntax>
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
49 <default/>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
50 <context>http</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
51 <context>server</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
52 <context>location</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
53 <appeared-in>0.8.22</appeared-in>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
54
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
55 <para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
56 Задаёт локальный IP-<value>адрес</value>, который будет использоваться в
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
57 исходящих соединениях с FastCGI-сервером.
815
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
58 В значении параметра допустимо использование переменных (1.3.12).
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
59 Специальное значение <literal>off</literal> (1.3.12) отменяет действие
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
60 унаследованной с предыдущего уровня конфигурации
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
61 директивы <literal>fastcgi_bind</literal>, позволяя системе
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
62 самостоятельно выбирать локальный адрес.
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
63 </para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
64
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
65 </directive>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
66
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
67
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68 <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
69 <syntax><value>размер</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
70 <default>4k|8k</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
71 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
72 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
73 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
74
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
76 Задаёт <value>размер</value> буфера, в который будет читаться
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77 первая часть ответа, получаемого от FastCGI-сервера.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78 В этой части ответа находится, как правило, небольшой заголовок ответа.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79 По умолчанию размер буфера равен размеру одного буфера в директиве
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80 <link id="fastcgi_buffers"/>, однако его можно сделать меньше.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
82
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
84
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
85
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86 <directive name="fastcgi_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
87 <syntax><value>число</value> <value>размер</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
88 <default>8 4k|8k</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
89 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
90 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
91 <context>location</context>
76
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 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
94 Задаёт <value>число</value> и <value>размер</value> буферов
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
95 для одного соединения,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96 в которые будет читаться ответ, получаемый от FastCGI-сервера.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
97 По умолчанию размер одного буфера равен размеру страницы.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
98 В зависимости от платформы это или 4K, или 8K.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
99 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
102
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
104 <directive name="fastcgi_busy_buffers_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
105 <syntax><value>размер</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
106 <default>8k|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
107 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
108 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
109 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
110
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
111 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
112 Ограничивает суммарный <value>размер</value>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
113 буферов, которые могут быть заняты для отправки ответа клиенту, пока
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
114 ответ ещё не прочитан целиком.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
115 Оставшиеся буферы тем временем могут использоваться для чтения ответа
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
116 и, при необходимости, буферизации части ответа во временный файл.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
117 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
118 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
119 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
120
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
121 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
122
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
123
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
124 <directive name="fastcgi_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
125 <syntax><value>зона</value> | <literal>off</literal></syntax>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
126 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
127 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
128 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
129 <context>location</context>
76
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 <para>
575
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
132 Задаёт зону разделяемой памяти, используемой для кэширования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
133 Одна и та же зона может использоваться в нескольких местах.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
134 Параметр <literal>off</literal> запрещает кэширование, унаследованное
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
135 с предыдущего уровня конфигурации.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
136 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
137
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
138 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
139
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
140
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
141 <directive name="fastcgi_cache_bypass">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
142 <syntax><value>строка</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
143 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
144 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
145 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
146 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
147
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
149 Задаёт условия, при которых ответ не будет браться из кэша.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
150 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
151 то ответ не берётся из кэша:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
152 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
153 fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
154 fastcgi_cache_bypass $http_pragma $http_authorization;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
156 Можно использовать совместно с директивой <link id="fastcgi_no_cache"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
157 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
159 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
162 <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
163 <syntax><value>строка</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
164 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
165 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
166 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
167 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
168
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
169 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
170 Задаёт ключ для кэширования, например,
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
171 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
172 fastcgi_cache_key localhost:9000$request_uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
173 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
177
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
178
302
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
179 <directive name="fastcgi_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
180 <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
181 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
182 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
183 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
184 <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
185 <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
186
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
187 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
188 Если включено, одновременно только одному запросу будет позволено
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
189 заполнить новый элемент кэша, идентифицируемый согласно директиве
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
190 <link id="fastcgi_cache_key"/>, передав запрос на FastCGI-сервер.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
191 Остальные запросы этого же элемента будут либо ожидать
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
192 появления ответа в кэше, либо освобождения блокировки
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
193 этого элемента, в течение времени, заданного директивой
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
194 <link id="fastcgi_cache_lock_timeout"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
195 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
196
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
197 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
198
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
199
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
200 <directive name="fastcgi_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
201 <syntax><value>время</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
202 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
203 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
204 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
205 <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
206 <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
207
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
208 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
209 Задаёт таймаут для <link id="fastcgi_cache_lock"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
210 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
211
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
212 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
213
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
214
793
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
215 <directive name="fastcgi_cache_methods">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
216 <syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
217 <literal>GET</literal> |
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
218 <literal>HEAD</literal> |
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
219 <literal>POST</literal>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
220 ...</syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
221 <default>GET HEAD</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
222 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
223 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
224 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
225 <appeared-in>0.7.59</appeared-in>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
226
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
227 <para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
228 Если метод запроса клиента указан в этой директиве,
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
229 то ответ будет закэширован.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
230 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
231 в список, но тем не менее рекомендуется перечислять их явно.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
232 См. также директиву <link id="fastcgi_no_cache"/>.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
233 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
234
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
235 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
236
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
237
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
238 <directive name="fastcgi_cache_min_uses">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
239 <syntax><value>число</value></syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
240 <default>1</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
241 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
242 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
243 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
244
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
245 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
246 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
247 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
248
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
249 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
250
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
251
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
252 <directive name="fastcgi_cache_path">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
253 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
254 <value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
255 [<literal>levels</literal>=<value>уровни</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
256 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
257 [<literal>inactive</literal>=<value>время</value>]
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
258 [<literal>max_size</literal>=<value>размер</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
259 [<literal>loader_files</literal>=<value>число</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
260 [<literal>loader_sleep</literal>=<value>время</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
261 [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
262 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
263 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
264
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
265 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
266 Задаёт путь и другие параметры кэша.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
267 Данные кэша хранятся в файлах.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
268 Ключом и именем файла в кэше является результат функции MD5
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
269 от проксированного URL.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
270 Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
271 например, при использовании
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
272 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
273 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
274 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
275 имена файлов в кэше будут такого вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
276 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
277 /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
278 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
279 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
280
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
281 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
282 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
283 переименовывается.
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
284 Начиная с версии 0.8.9, временные файлы и кэш
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
285 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
286 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
287 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
288 Поэтому лучше, если кэш будет находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
289 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
290 <link id="fastcgi_temp_path"/> для данного location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
291 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
292
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
293 <para>
575
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
294 Кроме того, все активные ключи и информация о данных хранятся в зоне
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
295 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
296 задаются параметром <literal>keys_zone</literal>.
285
Maxim Konovalov <maxim@nginx.com>
parents: 275
diff changeset
297 Если к данным кэша не обращаются в течение времени, заданного параметром
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
298 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
299 По умолчанию <literal>inactive</literal> равен 10 минутам.
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 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
303 Специальный процесс “cache manager” следит за максимальным размером кэша,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
304 заданным параметром <literal>max_size</literal>, и при превышении
507
d00a4f9b1c5d Better translation of "LRU".
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
305 его размеров удаляет наименее востребованные данные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
306 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
307
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
308 <para>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
309 Через минуту после старта активируется специальный процесс “cache loader”,
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
310 который загружает в зону кэша информацию о ранее закэшированных данных,
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
311 хранящихся на файловой системе.
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
312 Загрузка происходит итерациями.
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
313 За одну итерацию загружается не более <literal>loader_files</literal>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
314 элементов (по умолчанию 100).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
315 Кроме того, время работы одной итерации ограничено параметром
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
316 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
317 Между итерациями делается пауза на время, заданное параметром
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
318 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
319 </para>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
320
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
321 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
322
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
323
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
324 <directive name="fastcgi_cache_use_stale">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
325 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
326 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
327 <literal>timeout</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
328 <literal>invalid_header</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
329 <literal>updating</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
330 <literal>http_500</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
331 <literal>http_503</literal> |
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
332 <literal>http_403</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
333 <literal>http_404</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
334 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
335 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
336 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
337 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
338 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
339 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
340
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
341 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
342 Определяет, в каких случаях можно использовать устаревший закэшированный ответ,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
343 если при работе с FastCGI-сервером возникла ошибка.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
344 Параметры директивы совпадают с параметрами
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
345 директивы <link id="fastcgi_next_upstream"/>.
505
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
346 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
347
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
348 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
349 Кроме того, дополнительный параметр <literal>updating</literal>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
350 разрешает использовать устаревший закэшированный ответ,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
351 если на данный момент он уже обновляется.
505
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
352 Это позволяет минимизировать число обращений к FastCGI-серверам
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
353 при обновлении закэшированных данных.
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
354 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
355
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
356 <para>
509
0e55c9a48da9 Trimmed space at EOL.
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
357 Чтобы минимизировать число обращений к FastCGI-серверам при
505
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
358 заполнении нового элемента кэша, можно воспользоваться директивой
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
359 <link id="fastcgi_cache_lock"/>.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
360 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
361
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
362 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
363
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
364
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
365 <directive name="fastcgi_cache_valid">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
366 <syntax>[<value>код</value> ...] <value>время</value></syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
367 <default/>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
368 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
369 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
370 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
371
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
372 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
373 Задаёт время кэширования для разных кодов ответа.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
374 Например, директивы
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
375 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
376 fastcgi_cache_valid 200 302 10m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
377 fastcgi_cache_valid 404 1m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
378 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
379 задают время кэширования 10 минут для ответов с кодами 200 и 302,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
380 и 1 минуту для ответов с кодом 404.
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 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
384 Если указано только <value>время</value> кэширования,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
385 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
386 fastcgi_cache_valid 5m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
387 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
388 то кэшируются только ответы 200, 301 и 302.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
389 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
390
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
391 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
392 Кроме того, можно кэшировать любые ответы с помощью параметра
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
393 <literal>any</literal>:
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
394 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
395 fastcgi_cache_valid 200 302 10m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
396 fastcgi_cache_valid 301 1h;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
397 fastcgi_cache_valid any 1m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
398 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
399 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
400
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
401 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
402 Параметры кэширования могут также быть заданы непосредственно
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
403 в заголовке ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
404 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
405 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
406 ответа в секундах.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
407 Значение 0 запрещает кэшировать ответ.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
408 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
409 время в секундах с начала эпохи, до которого ответ может быть закэширован.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
410 Если в заголовке нет поля <header>X-Accel-Expires</header>,
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
411 параметры кэширования определяются по полям заголовка
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
412 <header>Expires</header> или <header>Cache-Control</header>.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
413 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
414 не будет кэшироваться.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
415 Обработка одного или более из этих полей заголовка может быть отключена
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
416 при помощи директивы <link id="fastcgi_ignore_headers"/>.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
417 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
418
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
419 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
420
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
421
862
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
422 <directive name="fastcgi_catch_stderr">
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
423 <syntax><value>строка</value></syntax>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
424 <default/>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
425 <context>http</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
426 <context>server</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
427 <context>location</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
428
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
429 <para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
430 Задаёт строку для поиска в потоке ошибок ответа,
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
431 полученного от FastCGI-сервера.
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
432 Если <value>строка</value> найдена, то считается, что FastCGI-сервер
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
433 вернул <link id="fastcgi_next_upstream">неверный ответ</link>.
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
434 Это позволяет обрабатывать ошибки приложений в nginx, например:
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
435 <example>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
436 location /php {
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
437 fastcgi_pass backend:9000;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
438 ...
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
439 fastcgi_catch_stderr "PHP Fatal error";
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
440 fastcgi_next_upstream error timeout invalid_header;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
441 }
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
442 </example>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
443 </para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
444
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
445 </directive>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
446
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
447
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
448 <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
449 <syntax><value>время</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
450 <default>60s</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
451 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
452 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
453 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
454
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
455 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
456 Задаёт таймаут для установления соединения с FastCGI-сервером.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
457 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
458 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
459
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
460 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
461
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
462
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
463 <directive name="fastcgi_hide_header">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
464 <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
465 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
466 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
467 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
468 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
469
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
470 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
471 По умолчанию
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
472 nginx не передаёт клиенту поля заголовка <header>Status</header> и
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
473 <header>X-Accel-...</header> из ответа FastCGI-сервера.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
474 Директива <literal>fastcgi_hide_header</literal> задаёт дополнительные поля,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
475 которые не будут передаваться.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
476 Если же передачу полей нужно разрешить, можно воспользоваться
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
477 директивой <link id="fastcgi_pass_header"/>.
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 </directive>
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 <directive name="fastcgi_ignore_client_abort">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
484 <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
485 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
486 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
487 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
488 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
489
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
490 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
491 Определяет, закрывать ли соединение с FastCGI-сервером
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
492 в случае, если клиент закрыл соединение, не дождавшись ответа.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
493 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
494
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
495 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
496
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
497
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
498 <directive name="fastcgi_ignore_headers">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
499 <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
500 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
501 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
502 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
503 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
504
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
505 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
506 Запрещает обработку некоторых полей заголовка из ответа FastCGI-сервера.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
507 В директиве можно указать поля <header>X-Accel-Redirect</header>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
508 <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
509 <header>X-Accel-Buffering</header> (1.1.6),
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
510 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
511 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
512 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
513
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
514 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
515 Если не запрещено, обработка этих полей заголовка заключается в следующем:
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
516 <list type="bullet" compact="no">
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
517
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
518 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
519 <header>X-Accel-Expires</header>, <header>Expires</header>,
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
520 <header>Cache-Control</header> и <header>Set-Cookie</header>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
521 задают параметры <link id="fastcgi_cache_valid">кэширования</link> ответа;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
522 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
523
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
524 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
525 <header>X-Accel-Redirect</header> производит
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
526 <link doc="ngx_http_core_module.xml" id="internal">внутреннее
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
527 перенаправление</link> на указанный URI;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
528 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
529
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
530 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
531 <header>X-Accel-Limit-Rate</header> задаёт
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
532 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
533 скорости</link> передачи ответа клиенту;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
534 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
535
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
536 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
537 <header>X-Accel-Buffering</header> включает или выключает
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
538 буферизацию ответа;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
539 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
540
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
541 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
542 <header>X-Accel-Charset</header> задаёт желаемую
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
543 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
544 ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
545 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
546
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
547 </list>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
548 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
549
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
550 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
551
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
552
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
553 <directive name="fastcgi_index">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
554 <syntax><value>имя</value></syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
555 <default/>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
556 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
557 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
558 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
559
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
560 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
561 Задаёт имя файла, который при создании переменной
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
562 <var>$fastcgi_script_name</var> будет добавляться после URI,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
563 если URI заканчивается слэшом.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
564 Например, при таких настройках
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
565 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
566 fastcgi_index index.php;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
567 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
568 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
569 и запросе “<literal>/page.php</literal>”
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
570 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
571 “<literal>/home/www/scripts/php/page.php</literal>”,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
572 а при запросе “<literal>/</literal>”&mdash;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
573 “<literal>/home/www/scripts/php/index.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
574 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
575
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
576 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
577
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
578
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
579 <directive name="fastcgi_intercept_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
580 <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
581 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
582 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
583 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
584 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
585
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
586 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
587 Определяет, передавать ли клиенту ответы FastCGI-сервера с кодом
907
43887f41bb17 Corrected the descriptions of {proxy,fastcgi}_intercept_errors.
Ruslan Ermilov <ru@nginx.com>
parents: 862
diff changeset
588 больше либо равным 300, или же перенаправлять их на обработку nginx’у с помощью
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
589 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
590 </para>
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
591
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
592 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
593
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
594
316
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
595 <directive name="fastcgi_keep_conn">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
596 <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
597 <default>off</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
598 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
599 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
600 <context>location</context>
498
65843513cff5 Documented that "fastcgi_keep_conn" appeared in 1.1.4.
Ruslan Ermilov <ru@nginx.com>
parents: 411
diff changeset
601 <appeared-in>1.1.4</appeared-in>
316
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
602
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
603 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
604 По умолчанию FastCGI-сервер будет закрывать соединение сразу же
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
605 после отправки ответа.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
606 При установке значения <literal>on</literal> nginx указывает
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
607 FastCGI-серверу оставлять соединения открытыми.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
608 Это в частности требуется для функционирования
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
609 <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
610 соединений</link> с FastCGI-серверами.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
611 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
612
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
613 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
614
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
615
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
616 <directive name="fastcgi_max_temp_file_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
617 <syntax><value>размер</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
618 <default>1024m</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
619 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
620 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
621 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
622
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
623 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
624 Если ответ не вмещается целиком в буферы памяти, заданные
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
625 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>,
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
626 часть ответа может быть записана во временный файл.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
627 Эта директива задаёт максимальный <value>размер</value> временного файла.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
628 Размер данных, сбрасываемых во временный файл за один раз, задаётся
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
629 директивой <link id="fastcgi_temp_file_write_size"/>.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
630 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
631
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
632 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
633 Значение 0 отключает возможность буферизации ответов во временные файлы.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
634 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
635
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
636 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
637
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
638
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
639 <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
640 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
641 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
642 <literal>timeout</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
643 <literal>invalid_header</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
644 <literal>http_500</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
645 <literal>http_503</literal> |
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
646 <literal>http_403</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
647 <literal>http_404</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
648 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
649 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
650 <default>error timeout</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
651 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
652 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
653 <context>location</context>
76
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 <list type="tag">
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 <tag-name><literal>error</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
660 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
661 чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
662
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
663 <tag-name><literal>timeout</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
664 <tag-desc>произошёл таймаут во время соединения с сервером,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
665 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
666
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
667 <tag-name><literal>invalid_header</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
668 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
669
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
670 <tag-name><literal>http_500</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
671 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
672
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
673 <tag-name><literal>http_503</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
674 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
675
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
676 <tag-name><literal>http_403</literal></tag-name>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
677 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
678
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
679 <tag-name><literal>http_404</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
680 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
681
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
682 <tag-name><literal>off</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
683 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
684
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
685 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
686 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
687
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
688 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
689 Необходимо понимать, что передача запроса следующему серверу возможна
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
690 только при условии, что клиенту ещё ничего не передавалось.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
691 То есть, если ошибка или таймаут возникли в середине передачи ответа,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
692 то исправить это уже невозможно.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
693 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
694
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
695 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
696
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
697
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
698 <directive name="fastcgi_no_cache">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
699 <syntax><value>строка</value> ...</syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
700 <default/>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
701 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
702 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
703 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
704
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
705 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
706 Задаёт условия, при которых ответ не будет сохраняться в кэш.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
707 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
708 то ответ не будет сохранён:
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
709 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
710 fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
711 fastcgi_no_cache $http_pragma $http_authorization;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
712 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
713 Можно использовать совместно с директивой <link id="fastcgi_cache_bypass"/>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
714 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
715
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
716 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
717
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
718
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
719 <directive name="fastcgi_param">
239
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
720 <syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
721 <value>параметр</value> <value>значение</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
722 [<literal>if_not_empty</literal>]</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
723 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
724 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
725 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
726 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
727
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
728 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
729 Задаёт <value>параметр</value>, который будет передаваться FastCGI-серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
730 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
731 Директивы наследуются с предыдущего уровня при условии, что на данном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
732 уровне не описаны свои директивы <literal>fastcgi_param</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
733 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
734
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
735 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
736 Ниже приведён пример минимально необходимых параметров для PHP:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
737 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
738 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
739 fastcgi_param QUERY_STRING $query_string;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
740 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
741 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
742
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
743 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
744 Параметр <literal>SCRIPT_FILENAME</literal> используется в PHP для
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
745 определения имени скрипта, а в параметре <literal>QUERY_STRING</literal>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
746 передаются параметры запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
747 </para>
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 Если скрипты обрабатывают запросы <literal>POST</literal>, то нужны
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
751 ещё три параметра:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
752 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
753 fastcgi_param REQUEST_METHOD $request_method;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
754 fastcgi_param CONTENT_TYPE $content_type;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
755 fastcgi_param CONTENT_LENGTH $content_length;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
756 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
757 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
758
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
759 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
760 Если PHP был собран с параметром конфигурации
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
761 <literal>--enable-force-cgi-redirect</literal>, то нужно передавать
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
762 параметр <literal>REDIRECT_STATUS</literal> со значением “200”:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
763 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
764 fastcgi_param REDIRECT_STATUS 200;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
765 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
766 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
767
239
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
768 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
769 Если директива указана с <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
770 то такой параметр с пустым значением передаваться на сервер не будет:
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
771 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
772 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
773 </example>
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
774 </para>
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
775
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
776 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
777
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 <directive name="fastcgi_pass">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
780 <syntax><value>адрес</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
781 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
782 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
783 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
784
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
785 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
786 Задаёт адрес FastCGI-сервера.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
787 Адрес может быть указан в виде доменного имени или адреса, и порта, например,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
788 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
789 fastcgi_pass localhost:9000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
790 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
791 или в виде пути UNIX-сокета:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
792 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
793 fastcgi_pass unix:/tmp/fastcgi.socket;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
794 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
795 </para>
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 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
798 Если доменному имени соответствует несколько адресов, то все они будут
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
799 использоваться по очереди (round-robin).
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
800 И, кроме того, адрес может быть
135
edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
801 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
802 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
803
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
804 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
805
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
806
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
807 <directive name="fastcgi_pass_header">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
808 <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
809 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
810 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
811 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
812 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
813
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
814 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
815 Разрешает передавать от FastCGI-сервера клиенту
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
816 <link id="fastcgi_hide_header">запрещённые для передачи</link> поля заголовка.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
817 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
818
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
819 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
820
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
821
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
822 <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
823 <syntax><value>время</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
824 <default>60s</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
825 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
826 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
827 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
828
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
829 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
830 Задаёт таймаут при чтении ответа FastCGI-сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
831 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
832 а только между двумя операциями чтения.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
833 Если по истечении этого времени FastCGI-сервер ничего не передаст,
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
834 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
835 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
836
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
837 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
838
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
839
793
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
840 <directive name="fastcgi_pass_request_body">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
841 <syntax><literal>on</literal> | <literal>off</literal></syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
842 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
843 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
844 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
845 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
846
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
847 <para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
848 Если запрещено, то исходное тело запроса не будет передано
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
849 на FastCGI-сервер.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
850 См. также директиву <link id="fastcgi_pass_request_headers"/>.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
851 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
852
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
853 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
854
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
855
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
856 <directive name="fastcgi_pass_request_headers">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
857 <syntax><literal>on</literal> | <literal>off</literal></syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
858 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
859 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
860 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
861 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
862
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
863 <para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
864 Если запрещено, то поля заголовка исходного запроса не будут переданы на
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
865 FastCGI-сервер.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
866 См. также директивы <link id="fastcgi_pass_request_body"/>.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
867 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
868
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
869 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
870
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
871
773
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
872 <directive name="fastcgi_send_lowat">
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
873 <syntax><value>размер</value></syntax>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
874 <default>0</default>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
875 <context>http</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
876 <context>server</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
877 <context>location</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
878
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
879 <para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
880 При установке в ненулевое значение nginx будет пытаться минимизировать
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
881 число операций отправки на исходящих соединениях с FastCGI-сервером
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
882 либо при помощи флага <c-def>NOTE_LOWAT</c-def> метода
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
883 <link doc="../events.xml" id="kqueue"/>,
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
884 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>,
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
885 с указанным <value>размером</value>.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
886 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
887
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
888 <para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
889 Эта директива игнорируется на Linux, Solaris и Windows.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
890 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
891
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
892 </directive>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
893
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
894
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
895 <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
896 <syntax><value>время</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
897 <default>60s</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
898 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
899 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
900 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
901
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
902 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
903 Задаёт таймаут при передаче запроса FastCGI-серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
904 Таймаут устанавливается не на всю передачу запроса,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
905 а только между двумя операциями записи.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
906 Если по истечении этого времени FastCGI-сервер не примет новых данных,
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
907 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
908 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
909
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
910 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
911
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
912
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
913 <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
914 <syntax><value>regex</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
915 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
916 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
917
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
918 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
919 Задаёт регулярное выражение, выделяющее значение для переменной
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
920 <var>$fastcgi_path_info</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
921 Регулярное выражение должно иметь два выделения, из которых первое
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
922 становится значением переменной <var>$fastcgi_script_name</var>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
923 а второе&mdash;значением переменной <var>$fastcgi_path_info</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
924 Например, при таких настройках
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
925 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
926 location ~ ^(.+\.php)(.*)$ {
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
927 fastcgi_split_path_info ^(.+\.php)(.*)$;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
928 fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
929 fastcgi_param PATH_INFO $fastcgi_path_info;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
930 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
931 и запросе “<literal>/show.php/article/0001</literal>”
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
932 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
933 “<literal>/path/to/php/show.php</literal>”, а параметр
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
934 <literal>PATH_INFO</literal>&mdash;“<literal>/article/0001</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
935 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
936
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
937 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
938
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
939
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
940 <directive name="fastcgi_store">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
941 <syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
942 <literal>on</literal> |
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
943 <literal>off</literal> |
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
944 <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
945 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
946 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
947 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
948 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
949
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
950 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
951 Разрешает сохранение на диск файлов.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
952 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
953 указанными в директивах
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
954 <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
955 <link doc="ngx_http_core_module.xml" id="root"/>.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
956 Параметр <literal>off</literal> запрещает сохранение файлов.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
957 Кроме того, имя файла можно задать явно с помощью строки с переменными:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
958 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
959 fastcgi_store /data/www$original_uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
960 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
961 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
962
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
963 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
964 Время изменения файлов выставляется согласно полученному полю
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
965 <header>Last-Modified</header> в заголовке ответа.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
966 Ответ сначала записывается во временный файл, а потом этот файл
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
967 переименовывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
968 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
969 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
970 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
971 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
972 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
973 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
974 <link id="fastcgi_temp_path"/> для данного location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
975 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
976
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
977 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
978 Директиву можно использовать для создания локальных копий статических
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
979 неизменяемых файлов, например, так:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
980 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
981 location /images/ {
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
982 root /data/www;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
983 open_file_cache_errors off;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
984 error_page 404 = /fetch$uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
985 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
986
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
987 location /fetch/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
988 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
989
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
990 fastcgi_pass backend:9000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
991 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
992
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
993 fastcgi_store on;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
994 fastcgi_store_access user:rw group:rw all:r;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
995 fastcgi_temp_path /data/temp;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
996
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
997 alias /data/www/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
998 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
999 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1000 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1001
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1002 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1003
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1004
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1005 <directive name="fastcgi_store_access">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1006 <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
1007 <default>user:rw</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1008 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1009 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1010 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1011
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1012 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1013 Задаёт права доступа для создаваемых файлов и каталогов, например,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1014 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1015 fastcgi_store_access user:rw group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1016 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1017 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1018
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1019 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1020 Если заданы какие-либо права для <literal>group</literal> или
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1021 <literal>all</literal>, то права для <literal>user</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1022 указывать необязательно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1023 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1024 fastcgi_store_access group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1025 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1026 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1027
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1028 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1029
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1030
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1031 <directive name="fastcgi_temp_file_write_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1032 <syntax><value>размер</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1033 <default>8k|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1034 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1035 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1036 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1037
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1038 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1039 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1040 за один раз, при включённой буферизации ответов FastCGI-сервера
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1041 во временные файлы.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1042 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1043 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1044 Максимальный размер временного файла задаётся директивой
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1045 <link id="fastcgi_max_temp_file_size"/>.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1046 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1047
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1048 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1049
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1050
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1051 <directive name="fastcgi_temp_path">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1052 <syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1053 <value>путь</value>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1054 [<value>уровень1</value>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1055 [<value>уровень2</value>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1056 [<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
1057 <default>fastcgi_temp</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1058 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1059 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1060 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1061
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1062 <para>
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1063 Задаёт имя каталога для хранения временных файлов с данными,
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1064 полученными от FastCGI-серверов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1065 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1066 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1067 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1068 fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1069 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1070 временный файл будет следующего вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
1071 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1072 /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
1073 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1074 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1075
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1076 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1077
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1078 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1079
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1080
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1081 <section id="parameters" name="Параметры, передаваемые FastCGI-серверу">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1082
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1083 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1084 Поля заголовка HTTP-запроса передаются FastCGI-серверу в виде параметров.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1085 В приложениях и скриптах, запущенных в виде FastCGI-сервера,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1086 эти параметры обычно доступны в виде переменных среды.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1087 Например, поле заголовка <header>User-Agent</header> передаётся как параметр
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1088 <literal>HTTP_USER_AGENT</literal>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1089 Кроме полей заголовка HTTP-запроса можно передавать произвольные параметры
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1090 с помощью директивы <link id="fastcgi_param"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1091 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1092
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1093 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1094
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1095
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1096 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1097
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1098 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1099 В модуле <literal>ngx_http_fastcgi_module</literal> есть встроенные переменные,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1100 которые можно использовать для формирования параметров с помощью директивы
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1101 <link id="fastcgi_param"/>:
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1102 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1103
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1104 <tag-name><var>$fastcgi_script_name</var></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1105 <tag-desc>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1106 URI запроса или же, если URI заканчивается слэшом,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1107 то URI запроса, дополненное именем индексного файла, задаваемого директивой
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1108 <link id="fastcgi_index"/>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1109 Эту переменную можно использовать для задания параметров
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1110 <literal>SCRIPT_FILENAME</literal> и <literal>PATH_TRANSLATED</literal>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1111 используемых, в частности, для определения имени скрипта в PHP.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1112 Например, для запроса “<literal>/info/</literal>” и при использовании
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1113 директив
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1114 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1115 fastcgi_index index.php;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1116 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1117 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1118 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1119 “<literal>/home/www/scripts/php/info/index.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1120
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1121 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1122 При использовании директивы <link id="fastcgi_split_path_info"/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1123 переменная <var>$fastcgi_script_name</var> равна значению первого выделения,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1124 задаваемого этой директивой.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1125 </para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1126 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1127
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1128 <tag-name><var>$fastcgi_path_info</var></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1129 <tag-desc>значение второго выделения, задаваемого директивой
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1130 <link id="fastcgi_split_path_info"/>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1131 Эту переменную можно использовать для задания параметра
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1132 <literal>PATH_INFO</literal>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1133 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1134
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1135 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1136 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1137
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1138 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1139
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1140 </module>