annotate xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 2560:a5bbfdf88bbd

Documented the "min_free" parameter of proxy_cache_path and friends.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 03 Jul 2020 12:04:22 +0100
parents d765ffffd08c
children 397289aeada7
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"
2560
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
13 rev="52">
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">
1885
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
48 <syntax>
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
49 <value>адрес</value>
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
50 [<literal>transparent</literal>] |
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
51 <literal>off</literal></syntax>
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
52 <default/>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
53 <context>http</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
54 <context>server</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
55 <context>location</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
56 <appeared-in>0.8.22</appeared-in>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
57
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
58 <para>
1748
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
59 Задаёт локальный IP-адрес с необязательным портом (1.11.2),
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
60 который будет использоваться в исходящих соединениях с FastCGI-сервером.
815
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
61 В значении параметра допустимо использование переменных (1.3.12).
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
62 Специальное значение <literal>off</literal> (1.3.12) отменяет действие
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
63 унаследованной с предыдущего уровня конфигурации
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 793
diff changeset
64 директивы <literal>fastcgi_bind</literal>, позволяя системе
1748
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
65 самостоятельно выбирать локальный IP-адрес и порт.
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
66 </para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
67
1696
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
68 <para id="fastcgi_bind_transparent">
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
69 Параметр <literal>transparent</literal> (1.11.0) позволяет
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
70 задать нелокальный IP-aдрес, который будет использоваться в
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
71 исходящих соединениях с FastCGI-сервером,
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
72 например, реальный IP-адрес клиента:
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
73 <example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
74 fastcgi_bind $remote_addr transparent;
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
75 </example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
76 Для работы параметра
2090
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
77 обычно требуется
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
78 запустить рабочие процессы nginx с привилегиями
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
79 <link doc="../ngx_core_module.xml" id="user">суперпользователя</link>.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
80 В Linux этого не требуется (1.13.8), так как если
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
81 указан параметр <literal>transparent</literal>, то рабочие процессы
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
82 наследуют capability <literal>CAP_NET_RAW</literal> из главного процесса.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
83 Также необходимо настроить таблицу маршрутизации ядра
1696
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
84 для перехвата сетевого трафика с FastCGI-сервера.
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
85 </para>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
86
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
87 </directive>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
88
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
89
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 <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
91 <syntax><value>размер</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
92 <default>4k|8k</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
93 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
94 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
95 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
98 Задаёт <value>размер</value> буфера, в который будет читаться
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
99 первая часть ответа, получаемого от FastCGI-сервера.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
100 В этой части ответа находится, как правило, небольшой заголовок ответа.
1550
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
101 По умолчанию размер одного буфера равен размеру страницы памяти.
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
102 В зависимости от платформы это или 4K, или 8K,
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
103 однако его можно сделать меньше.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
107
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108
995
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
109 <directive name="fastcgi_buffering">
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
110 <syntax><literal>on</literal> | <literal>off</literal></syntax>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
111 <default>on</default>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
112 <context>http</context>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
113 <context>server</context>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
114 <context>location</context>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
115 <appeared-in>1.5.6</appeared-in>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
116
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
117 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
118 Разрешает или запрещает использовать буферизацию ответов FastCGI-сервера.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
119 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
120
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
121 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
122 Если буферизация включена, то nginx принимает ответ FastCGI-сервера
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
123 как можно быстрее, сохраняя его в буферы, заданные директивами
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
124 <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
125 Если ответ не вмещается целиком в память, то его часть может быть записана
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
126 на диск во <link id="fastcgi_temp_path">временный файл</link>.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
127 Запись во временные файлы контролируется директивами
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
128 <link id="fastcgi_max_temp_file_size"/> и
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
129 <link id="fastcgi_temp_file_write_size"/>.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
130 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
131
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
132 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
133 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
134 по мере его поступления.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
135 nginx не пытается считать весь ответ FastCGI-сервера.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
136 Максимальный размер данных, который nginx может принять от сервера
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
137 за один раз, задаётся директивой <link id="fastcgi_buffer_size"/>.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
138 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
139
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
140 <para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
141 Буферизация может быть также включена или выключена путём передачи
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
142 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
143 <header>X-Accel-Buffering</header> заголовка ответа.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
144 Эту возможность можно запретить с помощью директивы
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
145 <link id="fastcgi_ignore_headers"/>.
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
146 </para>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
147
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
148 </directive>
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
149
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
150
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
151 <directive name="fastcgi_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
152 <syntax><value>число</value> <value>размер</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
153 <default>8 4k|8k</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
154 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
155 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
156 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
157
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
159 Задаёт <value>число</value> и <value>размер</value> буферов
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
160 для одного соединения,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161 в которые будет читаться ответ, получаемый от FastCGI-сервера.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
162 По умолчанию размер одного буфера равен размеру страницы.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
163 В зависимости от платформы это или 4K, или 8K.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
165
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
166 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
167
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
168
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
169 <directive name="fastcgi_busy_buffers_size">
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
170 <syntax><value>размер</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
171 <default>8k|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
172 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
173 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
174 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
175
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
176 <para>
995
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
177 При включённой <link id="fastcgi_buffering">буферизации</link> ответов
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
178 FastCGI-сервера, ограничивает суммарный <value>размер</value>
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
179 буферов, которые могут быть заняты для отправки ответа клиенту, пока
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
180 ответ ещё не прочитан целиком.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
181 Оставшиеся буферы тем временем могут использоваться для чтения ответа
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
182 и, при необходимости, буферизации части ответа во временный файл.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
183 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
184 директивами <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
185 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
186
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
187 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
188
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
189
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
190 <directive name="fastcgi_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
191 <syntax><value>зона</value> | <literal>off</literal></syntax>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
193 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
194 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
195 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
196
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
197 <para>
575
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
198 Задаёт зону разделяемой памяти, используемой для кэширования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199 Одна и та же зона может использоваться в нескольких местах.
1382
94cac978bda3 Documented variables support in proxy_cache and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1379
diff changeset
200 В значении параметра можно использовать переменные (1.7.9).
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
201 Параметр <literal>off</literal> запрещает кэширование, унаследованное
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
202 с предыдущего уровня конфигурации.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
203 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
204
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
207
1909
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
208 <directive name="fastcgi_cache_background_update">
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
209 <syntax><literal>on</literal> | <literal>off</literal></syntax>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
210 <default>off</default>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
211 <context>http</context>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
212 <context>server</context>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
213 <context>location</context>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
214 <appeared-in>1.11.10</appeared-in>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
215
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
216 <para>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
217 Позволяет запустить фоновый подзапрос
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
218 для обновления просроченного элемента кэша,
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
219 в то время как клиенту возвращается устаревший закэшированный ответ.
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
220 Использование устаревшего закэшированного ответа в момент его обновления
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
221 должно быть
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
222 <link id="fastcgi_cache_use_stale_updating">разрешено</link>.
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
223 </para>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
224
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
225 </directive>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
226
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
227
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
228 <directive name="fastcgi_cache_bypass">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
229 <syntax><value>строка</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
230 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
231 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
232 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
233 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
234
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
236 Задаёт условия, при которых ответ не будет браться из кэша.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
237 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
238 то ответ не берётся из кэша:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
239 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
240 fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
241 fastcgi_cache_bypass $http_pragma $http_authorization;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
242 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243 Можно использовать совместно с директивой <link id="fastcgi_no_cache"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
245
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
246 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
247
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
248
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249 <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
250 <syntax><value>строка</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
251 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
252 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
253 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
254 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
255
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
256 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
257 Задаёт ключ для кэширования, например,
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
258 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
259 fastcgi_cache_key localhost:9000$request_uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
260 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
261 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
262
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
263 </directive>
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
302
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
266 <directive name="fastcgi_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
267 <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
268 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
269 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
270 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
271 <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
272 <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
273
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
274 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
275 Если включено, одновременно только одному запросу будет позволено
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
276 заполнить новый элемент кэша, идентифицируемый согласно директиве
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
277 <link id="fastcgi_cache_key"/>, передав запрос на FastCGI-сервер.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
278 Остальные запросы этого же элемента будут либо ожидать
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
279 появления ответа в кэше, либо освобождения блокировки
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
280 этого элемента, в течение времени, заданного директивой
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
281 <link id="fastcgi_cache_lock_timeout"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
282 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
283
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
284 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
285
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
286
1379
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
287 <directive name="fastcgi_cache_lock_age">
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
288 <syntax><value>время</value></syntax>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
289 <default>5s</default>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
290 <context>http</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
291 <context>server</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
292 <context>location</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
293 <appeared-in>1.7.8</appeared-in>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
294
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
295 <para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
296 Если последний запрос, переданный на FastCGI-сервер
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
297 для заполнения нового элемента кэша,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
298 не завершился за указанное <value>время</value>,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
299 на FastCGI-сервер может быть передан ещё один запрос.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
300 </para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
301
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
302 </directive>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
303
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
304
302
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
305 <directive name="fastcgi_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
306 <syntax><value>время</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
307 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
308 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
309 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
310 <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
311 <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
312
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
313 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
314 Задаёт таймаут для <link id="fastcgi_cache_lock"/>.
1379
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
315 По истечении указанного <value>времени</value>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
316 запрос будет передан на FastCGI-сервер,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
317 однако ответ не будет закэширован.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
318 <note>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
319 До версии 1.7.8 такой ответ мог быть закэширован.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
320 </note>
302
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
321 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
322
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
323 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
324
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 299
diff changeset
325
1838
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
326 <directive name="fastcgi_cache_max_range_offset">
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
327 <syntax><value>число</value></syntax>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
328 <default/>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
329 <context>http</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
330 <context>server</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
331 <context>location</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
332 <appeared-in>1.11.6</appeared-in>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
333
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
334 <para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
335 Задаёт смещение в байтах для запросов с указанием диапазона запрашиваемых байт
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
336 (byte-range requests).
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
337 Если диапазон находится за указанным смещением,
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
338 range-запрос будет передан на FastCGI-сервер
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
339 и ответ не будет закэширован.
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
340 </para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
341
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
342 </directive>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
343
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
344
793
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
345 <directive name="fastcgi_cache_methods">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
346 <syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
347 <literal>GET</literal> |
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
348 <literal>HEAD</literal> |
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
349 <literal>POST</literal>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
350 ...</syntax>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
351 <default>GET HEAD</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
352 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
353 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
354 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
355 <appeared-in>0.7.59</appeared-in>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
356
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
357 <para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
358 Если метод запроса клиента указан в этой директиве,
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
359 то ответ будет закэширован.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
360 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
361 в список, но тем не менее рекомендуется перечислять их явно.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
362 См. также директиву <link id="fastcgi_no_cache"/>.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
363 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
364
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
365 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
366
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
367
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
368 <directive name="fastcgi_cache_min_uses">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
369 <syntax><value>число</value></syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
370 <default>1</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
371 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
372 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
373 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
374
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
375 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
376 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
377 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
378
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
379 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
380
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
381
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
382 <directive name="fastcgi_cache_path">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
383 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
384 <value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
385 [<literal>levels</literal>=<value>уровни</value>]
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
386 [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
387 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
388 [<literal>inactive</literal>=<value>время</value>]
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
389 [<literal>max_size</literal>=<value>размер</value>]
2560
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
390 [<literal>min_free</literal>=<value>размер</value>]
1810
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
391 [<literal>manager_files</literal>=<value>число</value>]
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
392 [<literal>manager_sleep</literal>=<value>время</value>]
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
393 [<literal>manager_threshold</literal>=<value>время</value>]
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
394 [<literal>loader_files</literal>=<value>число</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
395 [<literal>loader_sleep</literal>=<value>время</value>]
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
396 [<literal>loader_threshold</literal>=<value>время</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
397 [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
398 [<literal>purger_files</literal>=<value>число</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
399 [<literal>purger_sleep</literal>=<value>время</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
400 [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
401 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
402 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
403
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
404 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
405 Задаёт путь и другие параметры кэша.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
406 Данные кэша хранятся в файлах.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
407 Ключом и именем файла в кэше является результат функции MD5
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
408 от проксированного URL.
1796
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
409 Параметр <literal>levels</literal> задаёт уровни иерархии кэша:
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
410 можно задать от 1 до 3 уровней, на каждом уровне допускаются значения 1 или 2.
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
411 Например, при использовании
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
412 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
413 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
414 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
415 имена файлов в кэше будут такого вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
416 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
417 /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
418 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
419 </para>
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 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
422 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
423 переименовывается.
1724
ce3e89d13fa0 Removed unneeded comma in "Since ..." Russian constructs.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1696
diff changeset
424 Начиная с версии 0.8.9 временные файлы и кэш
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
425 могут располагаться на разных файловых системах.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
426 Однако нужно учитывать,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
427 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
428 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
429 Поэтому лучше, если кэш будет находиться на той же файловой
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
430 системе, что и каталог с временными файлами.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
431 Какой из каталогов будет использоваться для временных файлов
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
432 определяется параметром <literal>use_temp_path</literal> (1.7.10).
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
433 Если параметр не задан или установлен в значение “<literal>on</literal>”,
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
434 то будет использоваться каталог, задаваемый директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
435 <link id="fastcgi_temp_path"/> для данного location.
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
436 Если параметр установлен в значение “<literal>off</literal>”,
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
437 то временные файлы будут располагаться непосредственно в каталоге кэша.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
438 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
439
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
440 <para>
575
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
441 Кроме того, все активные ключи и информация о данных хранятся в зоне
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
442 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
443 задаются параметром <literal>keys_zone</literal>.
1189
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
444 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
2069
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
445 <note>
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
446 Как часть
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
447 <commercial_version>коммерческой подписки</commercial_version>
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
448 в зоне разделяемой памяти также хранится расширенная
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
449 <link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
450 поэтому для хранения аналогичного количества ключей необходимо указывать
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
451 больший размер зоны.
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
452 Например
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
453 зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
454 </note>
1189
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
455 </para>
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
456
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
457 <para>
285
Maxim Konovalov <maxim@nginx.com>
parents: 275
diff changeset
458 Если к данным кэша не обращаются в течение времени, заданного параметром
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
459 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
460 По умолчанию <literal>inactive</literal> равен 10 минутам.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
461 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
462
2560
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
463 <para id="fastcgi_cache_path_max_size">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
464 Специальный процесс “cache manager” следит за максимальным размером кэша,
2560
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
465 заданным параметром <literal>max_size</literal>,
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
466 и также за минимальным объёмом свободного места на файловой системе с кэшем,
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
467 заданным параметром <literal>min_free</literal> (1.19.1).
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
468 При превышении максимального размера кэша
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
469 или недостаточном объёме свободного места
a5bbfdf88bbd Documented the "min_free" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2254
diff changeset
470 процесс удаляет наименее востребованные данные.
1810
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
471 Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
472 <literal>manager_files</literal>,
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
473 <literal>manager_threshold</literal> и
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
474 <literal>manager_sleep</literal>.
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
475 За одну итерацию загружается не более <literal>manager_files</literal>
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
476 элементов (по умолчанию 100).
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
477 Время работы одной итерации ограничено параметром
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
478 <literal>manager_threshold</literal> (по умолчанию 200 миллисекунд).
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
479 Между итерациями делается пауза на время, заданное параметром
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
480 <literal>manager_sleep</literal> (по умолчанию 50 миллисекунд).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
481 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
482
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
483 <para>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
484 Через минуту после старта активируется специальный процесс “cache loader”,
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
485 который загружает в зону кэша информацию о ранее закэшированных данных,
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
486 хранящихся на файловой системе.
1810
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
487 Загрузка также происходит итерациями.
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
488 За одну итерацию загружается не более <literal>loader_files</literal>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
489 элементов (по умолчанию 100).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
490 Кроме того, время работы одной итерации ограничено параметром
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
491 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
492 Между итерациями делается пауза на время, заданное параметром
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
493 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
494 </para>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
495
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
496 <para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
497 Кроме того,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
498 следующие параметры доступны как часть
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
499 <commercial_version>коммерческой подписки</commercial_version>:
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
500 </para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
501
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
502 <para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
503 <list type="tag">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
504
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
505 <tag-name id="purger">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
506 <literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
507 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
508 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
509 Указывает, будут ли записи в кэше, соответствующие
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
510 <link id="fastcgi_cache_purge">маске</link>,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
511 удалены с диска при помощи процесса “cache purger” (1.7.12).
1659
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
512 Установка параметра в значение <literal>on</literal>
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
513 (по умолчанию <literal>off</literal>)
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
514 активирует процесс “cache purger”, который
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
515 проходит по всем записям в кэше
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
516 и удаляет записи, соответствующие этой маске.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
517 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
518
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
519 <tag-name id="purger_files">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
520 <literal>purger_files</literal>=<value>число</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
521 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
522 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
523 Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
524 По умолчанию <literal>purger_files</literal> равен 10.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
525 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
526
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
527 <tag-name id="purger_threshold">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
528 <literal>purger_threshold</literal>=<value>время</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
529 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
530 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
531 Задаёт продолжительность одной итерации (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
532 По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
533 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
534
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
535 <tag-name id="purger_sleep">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
536 <literal>purger_sleep</literal>=<value>время</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
537 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
538 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
539 Задаёт паузу между итерациями (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
540 По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
541 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
542
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
543 </list>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
544 </para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
545
1973
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
546 <para>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
547 <note>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
548 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён.
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
549 При обновлении на более новую версию nginx
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
550 ранее закэшированные ответы будут считаться недействительными.
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
551 </note>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
552 </para>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
553
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
554 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
555
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
556
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
557 <directive name="fastcgi_cache_purge">
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
558 <syntax>строка ...</syntax>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
559 <default/>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
560 <context>http</context>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
561 <context>server</context>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
562 <context>location</context>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
563 <appeared-in>1.5.7</appeared-in>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
564
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
565 <para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
566 Задаёт условия, при которых запрос будет считаться запросом
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
567 на очистку кэша.
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
568 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
569 то запись в кэше с соответствующим
1134
666052986b99 Fixed spelling in proxy_cache_purge and fastcgi_cache_purge.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1128
diff changeset
570 <link id="fastcgi_cache_key">ключом кэширования</link> удаляется.
1135
90c1c83fcba6 Changed translation in proxy_cache_purge and fastcgi_cache_purge.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1134
diff changeset
571 В результате успешной операции возвращается ответ с кодом
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
572 <http-status code="204" text="No Content"/>.
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
573 </para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
574
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
575 <para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
576 Если <link id="fastcgi_cache_key">ключ кэширования</link>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
577 запроса на очистку заканчивается
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
578 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
579 этой маске, будут удалены из кэша.
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
580 Тем не менее, эти записи будут оставаться на диске или до момента удаления
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
581 из-за <link id="fastcgi_cache_path">отсутствия обращения к данным</link>,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
582 или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
583 или до попытки клиента получить к ним доступ.
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
584 </para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
585
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
586 <para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
587 Пример конфигурации:
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
588 <example>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
589 fastcgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
590
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
591 map $request_method $purge_method {
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
592 PURGE 1;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
593 default 0;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
594 }
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
595
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
596 server {
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
597 ...
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
598 location / {
1185
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge.
Ruslan Ermilov <ru@nginx.com>
parents: 1155
diff changeset
599 fastcgi_pass http://backend;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge.
Ruslan Ermilov <ru@nginx.com>
parents: 1155
diff changeset
600 fastcgi_cache cache_zone;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge.
Ruslan Ermilov <ru@nginx.com>
parents: 1155
diff changeset
601 fastcgi_cache_key $uri;
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
602 fastcgi_cache_purge $purge_method;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
603 }
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
604 }
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
605 </example>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
606 <note>
1128
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1117
diff changeset
607 Функциональность доступна как часть
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1117
diff changeset
608 <commercial_version>коммерческой подписки</commercial_version>.
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
609 </note>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
610 </para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
611
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
612 </directive>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
613
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
614
1016
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
615 <directive name="fastcgi_cache_revalidate">
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
616 <syntax><literal>on</literal> | <literal>off</literal></syntax>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
617 <default>off</default>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
618 <context>http</context>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
619 <context>server</context>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
620 <context>location</context>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
621 <appeared-in>1.5.7</appeared-in>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
622
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
623 <para>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
624 Разрешает ревалидацию просроченных элементов кэша при помощи
1246
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1189
diff changeset
625 условных запросов с полями заголовка
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1189
diff changeset
626 <header>If-Modified-Since</header> и <header>If-None-Match</header>.
1016
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
627 </para>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
628
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
629 </directive>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
630
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
631
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
632 <directive name="fastcgi_cache_use_stale">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
633 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
634 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
635 <literal>timeout</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
636 <literal>invalid_header</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
637 <literal>updating</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
638 <literal>http_500</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
639 <literal>http_503</literal> |
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
640 <literal>http_403</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
641 <literal>http_404</literal> |
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
642 <literal>http_429</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
643 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
644 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
645 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
646 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
647 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
648 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
649
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
650 <para>
1910
41cf2c2d8c5c Cache: support for stale-while-revalidate and stale-if-error.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1909
diff changeset
651 Определяет, в каких случаях можно использовать устаревший закэшированный ответ.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
652 Параметры директивы совпадают с параметрами
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
653 директивы <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
654 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
655
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
656 <para>
1542
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
657 Параметр <literal>error</literal> также позволяет использовать
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
658 устаревший закэшированный ответ при невозможности выбора
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
659 FastCGI-сервера для обработки запроса.
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
660 </para>
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
661
1909
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
662 <para id="fastcgi_cache_use_stale_updating">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
663 Кроме того, дополнительный параметр <literal>updating</literal>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
664 разрешает использовать устаревший закэшированный ответ,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
665 если на данный момент он уже обновляется.
505
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
666 Это позволяет минимизировать число обращений к FastCGI-серверам
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
667 при обновлении закэшированных данных.
1912
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
668 </para>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
669
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
670 <para>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
671 Использование устаревшего закэшированного ответа
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
672 может также быть разрешено непосредственно в заголовке ответа
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
673 на определённое количество секунд после того, как ответ устарел (1.11.10).
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
674 Такой способ менее приоритетен, чем задание параметров директивы.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
675 <list type="bullet" compact="no">
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
676
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
677 <listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
678 Расширение
1910
41cf2c2d8c5c Cache: support for stale-while-revalidate and stale-if-error.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1909
diff changeset
679 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
1912
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
680 поля заголовка <header>Cache-Control</header> разрешает
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
681 использовать устаревший закэшированный ответ,
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
682 если на данный момент он уже обновляется.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
683 </listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
684
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
685 <listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
686 Расширение
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
687 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
688 поля заголовка <header>Cache-Control</header> разрешает
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
689 использовать устаревший закэшированный ответ в случае ошибки.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
690 </listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
691
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
692 </list>
505
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
693 </para>
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
694
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
695 <para>
509
0e55c9a48da9 Trimmed space at EOL.
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
696 Чтобы минимизировать число обращений к FastCGI-серверам при
505
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
697 заполнении нового элемента кэша, можно воспользоваться директивой
837bcf62b628 Emphasized on what the "updating" parameter of the "fastcgi_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 498
diff changeset
698 <link id="fastcgi_cache_lock"/>.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
699 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
700
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
701 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
702
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
703
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
704 <directive name="fastcgi_cache_valid">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
705 <syntax>[<value>код</value> ...] <value>время</value></syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
706 <default/>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
707 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
708 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
709 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
710
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
711 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
712 Задаёт время кэширования для разных кодов ответа.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
713 Например, директивы
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
714 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
715 fastcgi_cache_valid 200 302 10m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
716 fastcgi_cache_valid 404 1m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
717 </example>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
718 задают время кэширования 10 минут для ответов с кодами 200 и 302
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
719 и 1 минуту для ответов с кодом 404.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
720 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
721
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
722 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
723 Если указано только <value>время</value> кэширования,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
724 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
725 fastcgi_cache_valid 5m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
726 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
727 то кэшируются только ответы 200, 301 и 302.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
728 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
729
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
730 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
731 Кроме того, можно кэшировать любые ответы с помощью параметра
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
732 <literal>any</literal>:
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
733 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
734 fastcgi_cache_valid 200 302 10m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
735 fastcgi_cache_valid 301 1h;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
736 fastcgi_cache_valid any 1m;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
737 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
738 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
739
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
740 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
741 Параметры кэширования могут также быть заданы непосредственно
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
742 в заголовке ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
743 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
744 <list type="bullet" compact="no">
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
745
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
746 <listitem>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
747 Поле заголовка <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
748 ответа в секундах.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
749 Значение 0 запрещает кэшировать ответ.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
750 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
751 время в секундах с начала эпохи, до которого ответ может быть закэширован.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
752 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
753
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
754 <listitem>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
755 Если в заголовке нет поля <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
756 параметры кэширования определяются по полям заголовка
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
757 <header>Expires</header> или <header>Cache-Control</header>.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
758 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
759
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
760 <listitem>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
761 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
762 не будет кэшироваться.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
763 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
764
1353
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
765 <listitem>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
766 Ответ, в заголовке которого есть поле <header>Vary</header>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
767 со специальным значением “<literal>*</literal>”,
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
768 не будет кэшироваться (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
769 Ответ, в заголовке которого есть поле <header>Vary</header>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
770 с другим значением, будет закэширован
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
771 с учётом соответствующих полей заголовка запроса (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
772 </listitem>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
773
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
774 </list>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
775 Обработка одного или более из этих полей заголовка может быть отключена
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
776 при помощи директивы <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
777 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
778
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
779 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
780
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
781
862
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
782 <directive name="fastcgi_catch_stderr">
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
783 <syntax><value>строка</value></syntax>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
784 <default/>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
785 <context>http</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
786 <context>server</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
787 <context>location</context>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
788
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
789 <para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
790 Задаёт строку для поиска в потоке ошибок ответа,
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
791 полученного от FastCGI-сервера.
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
792 Если <value>строка</value> найдена, то считается, что FastCGI-сервер
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
793 вернул <link id="fastcgi_next_upstream">неверный ответ</link>.
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
794 Это позволяет обрабатывать ошибки приложений в nginx, например:
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
795 <example>
2206
5cacd6fffade Eliminated some examples of unsafe prefix locations.
Ruslan Ermilov <ru@nginx.com>
parents: 2090
diff changeset
796 location /php/ {
862
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
797 fastcgi_pass backend:9000;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
798 ...
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
799 fastcgi_catch_stderr "PHP Fatal error";
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
800 fastcgi_next_upstream error timeout invalid_header;
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
801 }
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
802 </example>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
803 </para>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
804
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
805 </directive>
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
806
6a40b8e7219a Documented the "fastcgi_catch_stderr" directive.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
807
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
808 <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
809 <syntax><value>время</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
810 <default>60s</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
811 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
812 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
813 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
814
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
815 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
816 Задаёт таймаут для установления соединения с FastCGI-сервером.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
817 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
818 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
819
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
820 </directive>
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
1337
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
823 <directive name="fastcgi_force_ranges">
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
824 <syntax><literal>on</literal> | <literal>off</literal></syntax>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
825 <default>off</default>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
826 <context>http</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
827 <context>server</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
828 <context>location</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
829 <appeared-in>1.7.7</appeared-in>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
830
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
831 <para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
832 Включает поддержку диапазонов запрашиваемых байт (byte-range)
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
833 для кэшированных и некэшированных ответов FastCGI-сервера
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
834 вне зависимости от наличия поля <header>Accept-Ranges</header>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
835 в заголовках этих ответов.
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
836 </para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
837
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
838 </directive>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
839
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
840
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
841 <directive name="fastcgi_hide_header">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
842 <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
843 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
844 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
845 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
846 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
847
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
848 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
849 По умолчанию
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
850 nginx не передаёт клиенту поля заголовка <header>Status</header> и
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
851 <header>X-Accel-...</header> из ответа FastCGI-сервера.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
852 Директива <literal>fastcgi_hide_header</literal> задаёт дополнительные поля,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
853 которые не будут передаваться.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
854 Если же передачу полей нужно разрешить, можно воспользоваться
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
855 директивой <link id="fastcgi_pass_header"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
856 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
857
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
858 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
859
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
860
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
861 <directive name="fastcgi_ignore_client_abort">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
862 <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
863 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
864 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
865 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
866 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
867
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
868 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
869 Определяет, закрывать ли соединение с FastCGI-сервером
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
870 в случае, если клиент закрыл соединение, не дождавшись ответа.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
871 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
872
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
873 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
874
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
875
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
876 <directive name="fastcgi_ignore_headers">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
877 <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
878 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
879 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
880 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
881 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
882
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
883 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
884 Запрещает обработку некоторых полей заголовка из ответа FastCGI-сервера.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
885 В директиве можно указать поля <header>X-Accel-Redirect</header>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
886 <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
887 <header>X-Accel-Buffering</header> (1.1.6),
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
888 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
1345
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
889 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44)
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
890 и <header>Vary</header> (1.7.7).
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
891 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
892
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
893 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
894 Если не запрещено, обработка этих полей заголовка заключается в следующем:
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
895 <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
896
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
897 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
898 <header>X-Accel-Expires</header>, <header>Expires</header>,
1345
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
899 <header>Cache-Control</header>, <header>Set-Cookie</header>
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
900 и <header>Vary</header>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
901 задают параметры <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
902 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
903
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
904 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
905 <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
906 <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
907 перенаправление</link> на указанный URI;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
908 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
909
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
910 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
911 <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
912 <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
913 скорости</link> передачи ответа клиенту;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
914 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
915
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
916 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
917 <header>X-Accel-Buffering</header> включает или выключает
995
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
918 <link id="fastcgi_buffering">буферизацию</link> ответа;
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
919 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
920
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
921 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
922 <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
923 <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
924 ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
925 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
926
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
927 </list>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
928 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 505
diff changeset
929
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
930 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
931
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
932
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
933 <directive name="fastcgi_index">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
934 <syntax><value>имя</value></syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
935 <default/>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
936 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
937 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
938 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
939
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
940 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
941 Задаёт имя файла, который при создании переменной
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
942 <var>$fastcgi_script_name</var> будет добавляться после URI,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
943 если URI заканчивается слэшом.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
944 Например, при таких настройках
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
945 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
946 fastcgi_index index.php;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
947 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
948 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
949 и запросе “<literal>/page.php</literal>”
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
950 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
951 “<literal>/home/www/scripts/php/page.php</literal>”,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
952 а при запросе “<literal>/</literal>”&mdash;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
953 “<literal>/home/www/scripts/php/index.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
954 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
955
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
956 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
957
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
958
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
959 <directive name="fastcgi_intercept_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
960 <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
961 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
962 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
963 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
964 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
965
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
966 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
967 Определяет, передавать ли клиенту ответы FastCGI-сервера с кодом
1803
621d0c682113 Clarified description of proxy_intercept_errors and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1796
diff changeset
968 больше либо равным 300,
1804
d655cfd46c26 Corrected Russian translation of proxy_intercept_errors and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1803
diff changeset
969 или же перехватывать их и перенаправлять на обработку nginx’у с помощью
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
970 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
971 </para>
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
972
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
973 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
974
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
975
316
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
976 <directive name="fastcgi_keep_conn">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
977 <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
978 <default>off</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
979 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
980 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
981 <context>location</context>
498
65843513cff5 Documented that "fastcgi_keep_conn" appeared in 1.1.4.
Ruslan Ermilov <ru@nginx.com>
parents: 411
diff changeset
982 <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
983
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
984 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
985 По умолчанию FastCGI-сервер будет закрывать соединение сразу же
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
986 после отправки ответа.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
987 При установке значения <literal>on</literal> nginx указывает
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
988 FastCGI-серверу оставлять соединения открытыми.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
989 Это в частности требуется для функционирования
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
990 <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
991 соединений</link> с FastCGI-серверами.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
992 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
993
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
994 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
995
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
996
1343
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
997 <directive name="fastcgi_limit_rate">
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
998 <syntax><value>скорость</value></syntax>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
999 <default>0</default>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1000 <context>http</context>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1001 <context>server</context>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1002 <context>location</context>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1003 <appeared-in>1.7.7</appeared-in>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1004
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1005 <para>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1006 Ограничивает скорость чтения ответа от FastCGI-сервера.
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1007 <value>Скорость</value> задаётся в байтах в секунду.
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1008 Значение 0 отключает ограничение скорости.
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1009 Ограничение устанавливается на запрос,
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1010 поэтому, если nginx одновременно
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1011 откроет два соединения к FastCGI-серверу,
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1012 суммарная скорость будет вдвое выше заданного ограничения.
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1013 Ограничение работает только в случае, если включена
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1014 <link id="fastcgi_buffering">буферизация</link> ответов FastCGI-сервера.
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1015 </para>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1016
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1017 </directive>
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1018
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
1019
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1020 <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
1021 <syntax><value>размер</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1022 <default>1024m</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1023 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1024 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1025 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1026
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1027 <para>
995
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
1028 Если включена <link id="fastcgi_buffering">буферизация</link> ответов
1153
4e20e4f8f49b Finished truncation of "memory buffers" to just "buffers".
Ruslan Ermilov <ru@nginx.com>
parents: 1135
diff changeset
1029 FastCGI-сервера, и ответ не вмещается целиком в буферы,
995
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
1030 заданные директивами <link id="fastcgi_buffer_size"/> и
c5ccf511346a Documented the "fastcgi_buffering" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
1031 <link id="fastcgi_buffers"/>, часть ответа может быть записана во временный файл.
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1032 Эта директива задаёт максимальный <value>размер</value> временного файла.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1033 Размер данных, сбрасываемых во временный файл за один раз, задаётся
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1034 директивой <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
1035 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1036
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1037 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1038 Значение 0 отключает возможность буферизации ответов во временные файлы.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1039 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1040
1352
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1041 <para>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1042 <note>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1043 Данное ограничение не распространяется на ответы,
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1044 которые будут <link id="fastcgi_cache">закэшированы</link>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1045 или <link id="fastcgi_store">сохранены</link> на диске.
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1046 </note>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1047 </para>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
1048
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1049 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1050
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1051
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1052 <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
1053 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1054 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1055 <literal>timeout</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1056 <literal>invalid_header</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1057 <literal>http_500</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1058 <literal>http_503</literal> |
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
1059 <literal>http_403</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1060 <literal>http_404</literal> |
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1061 <literal>http_429</literal> |
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1062 <literal>non_idempotent</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1063 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1064 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1065 <default>error timeout</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1066 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1067 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1068 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1069
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1070 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1071 Определяет, в каких случаях запрос будет передан следующему серверу:
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1072 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1073
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1074 <tag-name><literal>error</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1075 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1076 чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1077
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1078 <tag-name><literal>timeout</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1079 <tag-desc>произошёл таймаут во время соединения с сервером,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1080 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1081
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1082 <tag-name><literal>invalid_header</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1083 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1084
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1085 <tag-name><literal>http_500</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1086 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1087
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1088 <tag-name><literal>http_503</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1089 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1090
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
1091 <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
1092 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
1093
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1094 <tag-name><literal>http_404</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1095 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1096
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1097 <tag-name><literal>http_429</literal></tag-name>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1098 <tag-desc>сервер вернул ответ с кодом 429 (1.11.13);</tag-desc>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1099
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1100 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1101 <tag-desc>обычно запросы с
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1912
diff changeset
1102 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1103 методом
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1104 (<literal>POST</literal>, <literal>LOCK</literal>, <literal>PATCH</literal>)
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1105 не передаются на другой сервер,
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1106 если запрос серверу группы уже был отправлен (1.9.13);
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1107 включение параметра явно разрешает повторять подобные запросы;
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1108 </tag-desc>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1109
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1110
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1111 <tag-name><literal>off</literal></tag-name>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1112 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1113
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1114 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1115 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1116
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1117 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1118 Необходимо понимать, что передача запроса следующему серверу возможна
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1119 только при условии, что клиенту ещё ничего не передавалось.
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 то исправить это уже невозможно.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1122 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1123
942
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1124 <para>
1289
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
1125 Директива также определяет, что считается
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
1126 <link doc="ngx_http_upstream_module.xml" id="max_fails">неудачной
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
1127 попыткой</link> работы с сервером.
942
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1128 Случаи <literal>error</literal>, <literal>timeout</literal> и
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1129 <literal>invalid_header</literal>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1130 всегда считаются неудачными попытками, даже если они не указаны в директиве.
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1131 Случаи <literal>http_500</literal>, <literal>http_503</literal>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1132 и <literal>http_429</literal>
942
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1133 считаются неудачными попытками, только если они указаны в директиве.
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1134 Случаи <literal>http_403</literal> и <literal>http_404</literal>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1135 никогда не считаются неудачными попытками.
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1136 </para>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
1137
1290
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1138 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1139 Передача запроса следующему серверу может быть ограничена по
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1140 <link id="fastcgi_next_upstream_tries">количеству попыток</link>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1141 и по <link id="fastcgi_next_upstream_timeout">времени</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1142 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1143
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1144 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1145
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1146
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1147 <directive name="fastcgi_next_upstream_timeout">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1148 <syntax><value>время</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1149 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1150 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1151 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1152 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1153 <appeared-in>1.7.5</appeared-in>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1154
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1155 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1156 Ограничивает время, в течение которого возможна передача запроса
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1157 <link id="fastcgi_next_upstream">следующему серверу</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1158 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1159 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1160
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1161 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1162
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1163
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1164 <directive name="fastcgi_next_upstream_tries">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1165 <syntax><value>число</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1166 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1167 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1168 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1169 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1170 <appeared-in>1.7.5</appeared-in>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1171
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1172 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1173 Ограничивает число допустимых попыток для передачи запроса
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1174 <link id="fastcgi_next_upstream">следующему серверу</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1175 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1176 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1177
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1178 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1179
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1180
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1181 <directive name="fastcgi_no_cache">
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1182 <syntax><value>строка</value> ...</syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1183 <default/>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1184 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1185 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1186 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1187
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1188 <para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1189 Задаёт условия, при которых ответ не будет сохраняться в кэш.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1190 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1191 то ответ не будет сохранён:
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1192 <example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1193 fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1194 fastcgi_no_cache $http_pragma $http_authorization;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1195 </example>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1196 Можно использовать совместно с директивой <link id="fastcgi_cache_bypass"/>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1197 </para>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1198
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1199 </directive>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1200
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1201
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1202 <directive name="fastcgi_param">
239
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1203 <syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1204 <value>параметр</value> <value>значение</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1205 [<literal>if_not_empty</literal>]</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
1206 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1207 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1208 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1209 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1210
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1211 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1212 Задаёт <value>параметр</value>, который будет передаваться FastCGI-серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1213 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1214 Директивы наследуются с предыдущего уровня при условии, что на данном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1215 уровне не описаны свои директивы <literal>fastcgi_param</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1216 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1217
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1218 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1219 Ниже приведён пример минимально необходимых параметров для PHP:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1220 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1221 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1222 fastcgi_param QUERY_STRING $query_string;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1223 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1224 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1225
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1226 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1227 Параметр <literal>SCRIPT_FILENAME</literal> используется в PHP для
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1228 определения имени скрипта, а в параметре <literal>QUERY_STRING</literal>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1229 передаются параметры запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1230 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1231
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1232 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1233 Если скрипты обрабатывают запросы <literal>POST</literal>, то нужны
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1234 ещё три параметра:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1235 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1236 fastcgi_param REQUEST_METHOD $request_method;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1237 fastcgi_param CONTENT_TYPE $content_type;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1238 fastcgi_param CONTENT_LENGTH $content_length;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1239 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1240 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1241
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1242 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1243 Если PHP был собран с параметром конфигурации
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1244 <literal>--enable-force-cgi-redirect</literal>, то нужно передавать
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1245 параметр <literal>REDIRECT_STATUS</literal> со значением “200”:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1246 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1247 fastcgi_param REDIRECT_STATUS 200;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1248 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1249 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1250
239
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1251 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1252 Если директива указана с <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
1253 то такой параметр с пустым значением передаваться на сервер не будет:
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1254 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1255 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
1256 </example>
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1257 </para>
fe72da550150 "fastcgi_param" directive has new parameter "if_not_empty".
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1258
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1259 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1260
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1261
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1262 <directive name="fastcgi_pass">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1263 <syntax><value>адрес</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
1264 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1265 <context>location</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1266 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1267
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1268 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1269 Задаёт адрес FastCGI-сервера.
1622
c4c1dddfedac Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents: 1582
diff changeset
1270 Адрес может быть указан в виде доменного имени или IP-адреса,
c4c1dddfedac Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents: 1582
diff changeset
1271 и порта:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1272 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1273 fastcgi_pass localhost:9000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1274 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1275 или в виде пути UNIX-сокета:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1276 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1277 fastcgi_pass unix:/tmp/fastcgi.socket;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1278 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1279 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1280
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1281 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1282 Если доменному имени соответствует несколько адресов, то все они будут
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1283 использоваться по очереди (round-robin).
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1284 И, кроме того, адрес может быть
135
edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1285 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1286 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1287
1991
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1288 <para>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1289 В значении параметра можно использовать переменные.
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1290 В этом случае, если адрес указан в виде доменного имени,
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1291 имя ищется среди описанных
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1292 <link doc="ngx_http_upstream_module.xml">групп серверов</link>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1293 и если не найдено, то определяется с помощью
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1294 <link doc="ngx_http_core_module.xml" id="resolver"/>’а.
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1295 </para>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1973
diff changeset
1296
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1297 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1298
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1299
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1300 <directive name="fastcgi_pass_header">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1301 <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
1302 <default/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1303 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1304 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1305 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1306
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1307 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1308 Разрешает передавать от FastCGI-сервера клиенту
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1309 <link id="fastcgi_hide_header">запрещённые для передачи</link> поля заголовка.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1310 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1311
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1312 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1313
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1314
793
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1315 <directive name="fastcgi_pass_request_body">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1316 <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
1317 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1318 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1319 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1320 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1321
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1322 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1323 Позволяет запретить передачу исходного тела запроса
793
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1324 на FastCGI-сервер.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1325 См. также директиву <link id="fastcgi_pass_request_headers"/>.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1326 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1327
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1328 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1329
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1330
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1331 <directive name="fastcgi_pass_request_headers">
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1332 <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
1333 <default>on</default>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1334 <context>http</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1335 <context>server</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1336 <context>location</context>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1337
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1338 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1339 Позволяет запретить передачу полей заголовка исходного запроса на
793
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1340 FastCGI-сервер.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1341 См. также директивы <link id="fastcgi_pass_request_body"/>.
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1342 </para>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1343
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1344 </directive>
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1345
9104a921d940 Documented "fastcgi_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1346
1524
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1347 <directive name="fastcgi_read_timeout">
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1348 <syntax><value>время</value></syntax>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1349 <default>60s</default>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1350 <context>http</context>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1351 <context>server</context>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1352 <context>location</context>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1353
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1354 <para>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1355 Задаёт таймаут при чтении ответа FastCGI-сервера.
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1356 Таймаут устанавливается не на всю передачу ответа,
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1357 а только между двумя операциями чтения.
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1358 Если по истечении этого времени FastCGI-сервер ничего не передаст,
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1359 соединение закрывается.
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1360 </para>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1361
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1362 </directive>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1363
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1364
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1365 <directive name="fastcgi_request_buffering">
1659
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
1366 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1367 <default>on</default>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1368 <context>http</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1369 <context>server</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1370 <context>location</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1371 <appeared-in>1.7.11</appeared-in>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1372
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1373 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1374 Разрешает или запрещает использовать буферизацию тела запроса клиента.
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1375 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1376
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1377 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1378 Если буферизация включена, то тело запроса полностью
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1379 <link doc="ngx_http_core_module.xml" id="client_body_buffer_size">читается</link>
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1380 от клиента перед отправкой запроса на FastCGI-сервер.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1381 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1382
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1383 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1384 Если буферизация выключена, то тело запроса отправляется
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1385 на FastCGI-сервер сразу же по мере его поступления.
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1386 В этом случае запрос не может быть передан
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1387 <link id="fastcgi_next_upstream">следующему серверу</link>,
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1388 если nginx уже начал отправку тела запроса.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1389 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1390
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1391 </directive>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1392
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1393
773
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1394 <directive name="fastcgi_send_lowat">
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1395 <syntax><value>размер</value></syntax>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1396 <default>0</default>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1397 <context>http</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1398 <context>server</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1399 <context>location</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1400
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1401 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1402 При установке директивы в ненулевое значение nginx будет пытаться минимизировать
773
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1403 число операций отправки на исходящих соединениях с FastCGI-сервером
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1404 либо при помощи флага <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
1405 <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
1406 либо при помощи параметра сокета <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
1407 с указанным <value>размером</value>.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1408 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1409
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1410 <para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1411 Эта директива игнорируется на Linux, Solaris и Windows.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1412 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1413
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1414 </directive>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1415
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1416
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1417 <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
1418 <syntax><value>время</value></syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1419 <default>60s</default>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1420 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1421 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1422 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1423
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
1424 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1425 Задаёт таймаут при передаче запроса FastCGI-серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1426 Таймаут устанавливается не на всю передачу запроса,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1427 а только между двумя операциями записи.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1428 Если по истечении этого времени FastCGI-сервер не примет новых данных,
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1429 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1430 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1431
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1432 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1433
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1434
2254
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1435 <directive name="fastcgi_socket_keepalive">
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1436 <syntax><literal>on</literal> | <literal>off</literal></syntax>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1437 <default>off</default>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1438 <context>http</context>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1439 <context>server</context>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1440 <context>location</context>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1441 <appeared-in>1.15.6</appeared-in>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1442
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1443 <para>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1444 Конфигурирует поведение “TCP keepalive”
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1445 для исходящих соединений к FastCGI-серверу.
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1446 По умолчанию для сокета действуют настройки операционной системы.
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1447 Если указано значение “<literal>on</literal>”, то
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1448 для сокета включается параметр <c-def>SO_KEEPALIVE</c-def>.
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1449 </para>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1450
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1451 </directive>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1452
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2206
diff changeset
1453
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1454 <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
1455 <syntax><value>regex</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
1456 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1457 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1458
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1459 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1460 Задаёт регулярное выражение, выделяющее значение для переменной
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1461 <var>$fastcgi_path_info</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1462 Регулярное выражение должно иметь два выделения, из которых первое
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1463 становится значением переменной <var>$fastcgi_script_name</var>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1464 а второе&mdash;значением переменной <var>$fastcgi_path_info</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1465 Например, при таких настройках
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1466 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1467 location ~ ^(.+\.php)(.*)$ {
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1468 fastcgi_split_path_info ^(.+\.php)(.*)$;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1469 fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1470 fastcgi_param PATH_INFO $fastcgi_path_info;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1471 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1472 и запросе “<literal>/show.php/article/0001</literal>”
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1473 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1474 “<literal>/path/to/php/show.php</literal>”, а параметр
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1475 <literal>PATH_INFO</literal>&mdash;“<literal>/article/0001</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1476 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1477
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1478 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1479
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1480
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1481 <directive name="fastcgi_store">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1482 <syntax>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1483 <literal>on</literal> |
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1484 <literal>off</literal> |
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1485 <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
1486 <default>off</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1487 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1488 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1489 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1490
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1491 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1492 Разрешает сохранение на диск файлов.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1493 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1494 указанными в директивах
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
1495 <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
1496 <link doc="ngx_http_core_module.xml" id="root"/>.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1497 Параметр <literal>off</literal> запрещает сохранение файлов.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1498 Кроме того, имя файла можно задать явно с помощью строки с переменными:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1499 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1500 fastcgi_store /data/www$original_uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1501 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1502 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1503
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1504 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1505 Время изменения файлов выставляется согласно полученному полю
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1506 <header>Last-Modified</header> в заголовке ответа.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1507 Ответ сначала записывается во временный файл, а потом этот файл
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1508 переименовывается.
1724
ce3e89d13fa0 Removed unneeded comma in "Since ..." Russian constructs.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1696
diff changeset
1509 Начиная с версии 0.8.9 временный файл и постоянное место хранения ответа
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1510 могут располагаться на разных файловых системах.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1511 Однако нужно учитывать,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1512 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1513 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1514 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1515 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1516 <link id="fastcgi_temp_path"/> для данного location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1517 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1518
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1519 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1520 Директиву можно использовать для создания локальных копий статических
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1521 неизменяемых файлов, например, так:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1522 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1523 location /images/ {
1005
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 995
diff changeset
1524 root /data/www;
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 995
diff changeset
1525 error_page 404 = /fetch$uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1526 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1527
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1528 location /fetch/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1529 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1530
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1531 fastcgi_pass backend:9000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1532 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1533
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1534 fastcgi_store on;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1535 fastcgi_store_access user:rw group:rw all:r;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1536 fastcgi_temp_path /data/temp;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1537
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1538 alias /data/www/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1539 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1540 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1541 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1542
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1543 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1544
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1545
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1546 <directive name="fastcgi_store_access">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 239
diff changeset
1547 <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
1548 <default>user:rw</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1549 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1550 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1551 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1552
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1553 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1554 Задаёт права доступа для создаваемых файлов и каталогов, например,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1555 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1556 fastcgi_store_access user:rw group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1557 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1558 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1559
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1560 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1561 Если заданы какие-либо права для <literal>group</literal> или
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1562 <literal>all</literal>, то права для <literal>user</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1563 указывать необязательно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1564 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1565 fastcgi_store_access group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1566 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1567 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1568
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1569 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1570
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1571
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1572 <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
1573 <syntax><value>размер</value></syntax>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1574 <default>8k|16k</default>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1575 <context>http</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1576 <context>server</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1577 <context>location</context>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1578
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1579 <para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1580 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1581 за один раз, при включённой буферизации ответов FastCGI-сервера
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1582 во временные файлы.
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1583 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1584 директивами <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
1585 Максимальный размер временного файла задаётся директивой
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1586 <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
1587 </para>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1588
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1589 </directive>
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1590
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1591
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1592 <directive name="fastcgi_temp_path">
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1593 <syntax>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1594 <value>путь</value>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1595 [<value>уровень1</value>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1596 [<value>уровень2</value>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1597 [<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
1598 <default>fastcgi_temp</default>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1599 <context>http</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1600 <context>server</context>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1601 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1602
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1603 <para>
411
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1604 Задаёт имя каталога для хранения временных файлов с данными,
f8248d0e3c8f Documented the following directives: fastcgi_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1605 полученными от FastCGI-серверов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1606 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1607 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1608 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1609 fastcgi_temp_path /spool/nginx/fastcgi_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1610 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1611 временный файл будет следующего вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
1612 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1613 /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
1614 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1615 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1616
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1617 <para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1618 См. также параметр <literal>use_temp_path</literal> директивы
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1619 <link id="fastcgi_cache_path"/>.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1620 </para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1621
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1622 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1623
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1624 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1625
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1626
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1627 <section id="parameters" name="Параметры, передаваемые FastCGI-серверу">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1628
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1629 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1630 Поля заголовка HTTP-запроса передаются FastCGI-серверу в виде параметров.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1631 В приложениях и скриптах, запущенных в виде FastCGI-сервера,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1632 эти параметры обычно доступны в виде переменных среды.
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1633 Например, поле заголовка <header>User-Agent</header> передаётся как параметр
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1634 <literal>HTTP_USER_AGENT</literal>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1635 Кроме полей заголовка HTTP-запроса можно передавать произвольные параметры
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1636 с помощью директивы <link id="fastcgi_param"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1637 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1638
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1639 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1640
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1641
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1642 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1643
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1644 <para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1645 В модуле <literal>ngx_http_fastcgi_module</literal> есть встроенные переменные,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1646 которые можно использовать для формирования параметров с помощью директивы
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1647 <link id="fastcgi_param"/>:
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1648 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1649
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 1153
diff changeset
1650 <tag-name id="var_fastcgi_script_name"><var>$fastcgi_script_name</var>
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 1153
diff changeset
1651 </tag-name>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1652 <tag-desc>
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1653 URI запроса или же, если URI заканчивается слэшом,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1654 то URI запроса, дополненное именем индексного файла, задаваемого директивой
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1655 <link id="fastcgi_index"/>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1656 Эту переменную можно использовать для задания параметров
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1657 <literal>SCRIPT_FILENAME</literal> и <literal>PATH_TRANSLATED</literal>,
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1658 используемых, в частности, для определения имени скрипта в PHP.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1659 Например, для запроса “<literal>/info/</literal>” и при использовании
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1660 директив
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1661 <example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1662 fastcgi_index index.php;
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1663 fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1664 </example>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1665 параметр <literal>SCRIPT_FILENAME</literal> будет равен
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1666 “<literal>/home/www/scripts/php/info/index.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1667
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1668 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1669 При использовании директивы <link id="fastcgi_split_path_info"/>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1670 переменная <var>$fastcgi_script_name</var> равна значению первого выделения,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1671 задаваемого этой директивой.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1672 </para>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1673 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1674
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 1153
diff changeset
1675 <tag-name id="var_fastcgi_path_info"><var>$fastcgi_path_info</var></tag-name>
295
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1676 <tag-desc>значение второго выделения, задаваемого директивой
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1677 <link id="fastcgi_split_path_info"/>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1678 Эту переменную можно использовать для задания параметра
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1679 <literal>PATH_INFO</literal>.
38e111ec051d Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
1680 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1681
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1682 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1683 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1684
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1685 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1686
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1687 </module>