annotate xml/ru/docs/http/ngx_http_scgi_module.xml @ 1796:1d576e8d6ead

Clarified the "levels" parameter of proxy_cache_path and friends.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 04 Jul 2016 14:29:09 +0300
parents be371be7a5c8
children 621d0c682113
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
2
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
3 <!--
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
4 Copyright (C) Igor Sysoev
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
5 Copyright (C) Nginx, Inc.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
6 -->
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
7
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
9
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
10 <module name="Модуль ngx_http_scgi_module"
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_scgi_module.html"
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
12 lang="ru"
1796
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
13 rev="25">
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
14
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
15 <section id="summary">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
16
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
17 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
18 Модуль <literal>ngx_http_scgi_module</literal> позволяет передавать
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
19 запросы SCGI-серверу.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
20 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
21
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
22 </section>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
23
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
24
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
25 <section id="example" name="Пример конфигурации">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
26
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
27 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
28 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
29 location / {
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
30 include scgi_params;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
31 scgi_pass localhost:9000;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
32 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
33 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
34 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
35
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
36 </section>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
37
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
38
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
39 <section id="directives" name="Директивы">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
40
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
41 <directive name="scgi_bind">
1696
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
42 <syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
43 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
44 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
45 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
46 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
47
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
48 <para>
1748
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
49 Задаёт локальный IP-адрес с необязательным портом (1.11.2),
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
50 который будет использоваться в исходящих соединениях с SCGI-сервером.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
51 В значении параметра допустимо использование переменных (1.3.12).
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
52 Специальное значение <literal>off</literal> (1.3.12) отменяет действие
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
53 унаследованной с предыдущего уровня конфигурации
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
54 директивы <literal>scgi_bind</literal>, позволяя системе
1748
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
55 самостоятельно выбирать локальный IP-адрес и порт.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
56 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
57
1696
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
58 <para id="scgi_bind_transparent">
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
59 Параметр <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
60 задать нелокальный IP-aдрес, который будет использоваться в
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
61 исходящих соединениях с SCGI-сервером,
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
62 например, реальный IP-адрес клиента:
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
63 <example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
64 scgi_bind $remote_addr transparent;
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
65 </example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
66 Для работы параметра
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
67 необходимо запустить рабочие процессы nginx с привилегиями
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
68 <link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
69 а также настроить таблицу маршрутизации ядра
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
70 для перехвата сетевого трафика с SCGI-сервера.
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
71 </para>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
72
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
73 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
74
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
75
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
76 <directive name="scgi_buffer_size">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
77 <syntax><value>размер</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
78 <default>4k|8k</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
79 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
80 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
81 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
82
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
83 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
84 Задаёт <value>размер</value> буфера, в который будет читаться
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
85 первая часть ответа, получаемого от SCGI-сервера.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
86 В этой части ответа находится, как правило, небольшой заголовок ответа.
1550
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
87 По умолчанию размер одного буфера равен размеру страницы памяти.
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
88 В зависимости от платформы это или 4K, или 8K,
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
89 однако его можно сделать меньше.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
90 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
91
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
92 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
93
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
94
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
95 <directive name="scgi_buffering">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
96 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
97 <default>on</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
98 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
99 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
100 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
101
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
102 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
103 Разрешает или запрещает использовать буферизацию ответов SCGI-сервера.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
104 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
105
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
106 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
107 Если буферизация включена, то nginx принимает ответ SCGI-сервера
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
108 как можно быстрее, сохраняя его в буферы, заданные директивами
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
109 <link id="scgi_buffer_size"/> и <link id="scgi_buffers"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
110 Если ответ не вмещается целиком в память, то его часть может быть записана
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
111 на диск во <link id="scgi_temp_path">временный файл</link>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
112 Запись во временные файлы контролируется директивами
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
113 <link id="scgi_max_temp_file_size"/> и
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
114 <link id="scgi_temp_file_write_size"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
115 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
116
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
117 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
118 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
119 по мере его поступления.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
120 nginx не пытается считать весь ответ SCGI-сервера.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
121 Максимальный размер данных, который nginx может принять от сервера
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
122 за один раз, задаётся директивой <link id="scgi_buffer_size"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
123 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
124
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
125 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
126 Буферизация может быть также включена или выключена путём передачи
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
127 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
128 <header>X-Accel-Buffering</header> заголовка ответа.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
129 Эту возможность можно запретить с помощью директивы
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
130 <link id="scgi_ignore_headers"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
131 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
132
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
133 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
134
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
135
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
136 <directive name="scgi_buffers">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
137 <syntax><value>число</value> <value>размер</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
138 <default>8 4k|8k</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
139 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
140 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
141 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
142
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
143 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
144 Задаёт <value>число</value> и <value>размер</value> буферов
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
145 для одного соединения,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
146 в которые будет читаться ответ, получаемый от SCGI-сервера.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
147 По умолчанию размер одного буфера равен размеру страницы.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
148 В зависимости от платформы это или 4K, или 8K.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
149 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
150
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
151 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
152
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
153
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
154 <directive name="scgi_busy_buffers_size">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
155 <syntax><value>размер</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
156 <default>8k|16k</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
157 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
158 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
159 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
160
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
161 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
162 При включённой <link id="scgi_buffering">буферизации</link> ответов
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
163 SCGI-сервера, ограничивает суммарный <value>размер</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
164 буферов, которые могут быть заняты для отправки ответа клиенту, пока
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
165 ответ ещё не прочитан целиком.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
166 Оставшиеся буферы тем временем могут использоваться для чтения ответа
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
167 и, при необходимости, буферизации части ответа во временный файл.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
168 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
169 директивами <link id="scgi_buffer_size"/> и <link id="scgi_buffers"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
170 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
171
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
172 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
173
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
174
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
175 <directive name="scgi_cache">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
176 <syntax><value>зона</value> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
177 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
178 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
179 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
180 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
181
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
182 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
183 Задаёт зону разделяемой памяти, используемой для кэширования.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
184 Одна и та же зона может использоваться в нескольких местах.
1382
94cac978bda3 Documented variables support in proxy_cache and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1379
diff changeset
185 В значении параметра можно использовать переменные (1.7.9).
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
186 Параметр <literal>off</literal> запрещает кэширование, унаследованное
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
187 с предыдущего уровня конфигурации.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
188 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
189
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
190 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
191
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
192
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
193 <directive name="scgi_cache_bypass">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
194 <syntax><value>строка</value> ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
195 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
196 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
197 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
198 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
199
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
200 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
201 Задаёт условия, при которых ответ не будет браться из кэша.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
202 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
203 то ответ не берётся из кэша:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
204 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
205 scgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
206 scgi_cache_bypass $http_pragma $http_authorization;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
207 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
208 Можно использовать совместно с директивой <link id="scgi_no_cache"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
209 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
210
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
211 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
212
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
213
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
214 <directive name="scgi_cache_key">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
215 <syntax><value>строка</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
216 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
217 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
218 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
219 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
220
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
221 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
222 Задаёт ключ для кэширования, например,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
223 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
224 scgi_cache_key localhost:9000$request_uri;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
225 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
226 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
227
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
228 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
229
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
230
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
231 <directive name="scgi_cache_lock">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
232 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
233 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
234 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
235 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
236 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
237 <appeared-in>1.1.12</appeared-in>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
238
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
239 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
240 Если включено, одновременно только одному запросу будет позволено
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
241 заполнить новый элемент кэша, идентифицируемый согласно директиве
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
242 <link id="scgi_cache_key"/>, передав запрос на SCGI-сервер.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
243 Остальные запросы этого же элемента будут либо ожидать
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
244 появления ответа в кэше, либо освобождения блокировки
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
245 этого элемента, в течение времени, заданного директивой
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
246 <link id="scgi_cache_lock_timeout"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
247 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
248
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
249 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
250
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
251
1379
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
252 <directive name="scgi_cache_lock_age">
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
253 <syntax><value>время</value></syntax>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
254 <default>5s</default>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
255 <context>http</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
256 <context>server</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
257 <context>location</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
258 <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
259
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
260 <para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
261 Если последний запрос, переданный на SCGI-сервер
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
262 для заполнения нового элемента кэша,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
263 не завершился за указанное <value>время</value>,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
264 на SCGI-сервер может быть передан ещё один запрос.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
265 </para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
266
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
267 </directive>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
268
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
269
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
270 <directive name="scgi_cache_lock_timeout">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
271 <syntax><value>время</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
272 <default>5s</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
273 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
274 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
275 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
276 <appeared-in>1.1.12</appeared-in>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
277
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
278 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
279 Задаёт таймаут для <link id="scgi_cache_lock"/>.
1379
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
280 По истечении указанного <value>времени</value>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
281 запрос будет передан на SCGI-сервер,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
282 однако ответ не будет закэширован.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
283 <note>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
284 До версии 1.7.8 такой ответ мог быть закэширован.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1353
diff changeset
285 </note>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
286 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
287
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
288 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
289
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
290
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
291 <directive name="scgi_cache_methods">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
292 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
293 <literal>GET</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
294 <literal>HEAD</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
295 <literal>POST</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
296 ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
297 <default>GET HEAD</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
298 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
299 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
300 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
301
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
302 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
303 Если метод запроса клиента указан в этой директиве,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
304 то ответ будет закэширован.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
305 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
306 в список, но тем не менее рекомендуется перечислять их явно.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
307 См. также директиву <link id="scgi_no_cache"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
308 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
309
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
310 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
311
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
312
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
313 <directive name="scgi_cache_min_uses">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
314 <syntax><value>число</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
315 <default>1</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
316 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
317 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
318 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
319
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
320 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
321 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
322 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
323
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
324 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
325
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
326
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
327 <directive name="scgi_cache_path">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
328 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
329 <value>путь</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
330 [<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
331 [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
332 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
333 [<literal>inactive</literal>=<value>время</value>]
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
334 [<literal>max_size</literal>=<value>размер</value>]
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
335 [<literal>loader_files</literal>=<value>число</value>]
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
336 [<literal>loader_sleep</literal>=<value>время</value>]
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
337 [<literal>loader_threshold</literal>=<value>время</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
338 [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
339 [<literal>purger_files</literal>=<value>число</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
340 [<literal>purger_sleep</literal>=<value>время</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
341 [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
342 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
343 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
344
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
345 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
346 Задаёт путь и другие параметры кэша.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
347 Данные кэша хранятся в файлах.
1190
dd4cfc6ce770 Corrected description of *_cache_path file names.
Ruslan Ermilov <ru@nginx.com>
parents: 1189
diff changeset
348 Именем файла в кэше является результат функции MD5
dd4cfc6ce770 Corrected description of *_cache_path file names.
Ruslan Ermilov <ru@nginx.com>
parents: 1189
diff changeset
349 от <link id="scgi_cache_key">ключа кэширования</link>.
1796
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
350 Параметр <literal>levels</literal> задаёт уровни иерархии кэша:
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
351 можно задать от 1 до 3 уровней, на каждом уровне допускаются значения 1 или 2.
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
352 Например, при использовании
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
353 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
354 scgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
355 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
356 имена файлов в кэше будут такого вида:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
357 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
358 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
359 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
360 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
361
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
362 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
363 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
364 переименовывается.
1724
ce3e89d13fa0 Removed unneeded comma in "Since ..." Russian constructs.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1696
diff changeset
365 Начиная с версии 0.8.9 временные файлы и кэш
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
366 могут располагаться на разных файловых системах.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
367 Однако нужно учитывать,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
368 что в этом случае вместо дешёвой операции переименовывания в пределах
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
369 одной файловой системы файл копируется с одной файловой системы на другую.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
370 Поэтому лучше, если кэш будет находиться на той же файловой
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
371 системе, что и каталог с временными файлами.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
372 Какой из каталогов будет использоваться для временных файлов
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
373 определяется параметром <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
374 Если параметр не задан или установлен в значение “<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
375 то будет использоваться каталог, задаваемый директивой
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
376 <link id="scgi_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
377 Если параметр установлен в значение “<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
378 то временные файлы будут располагаться непосредственно в каталоге кэша.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
379 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
380
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
381 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
382 Кроме того, все активные ключи и информация о данных хранятся в зоне
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
383 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
384 задаются параметром <literal>keys_zone</literal>.
1189
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
385 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
386 </para>
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
387
f25d00109de0 Documented cache keys_zone memory estimates.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1185
diff changeset
388 <para>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
389 Если к данным кэша не обращаются в течение времени, заданного параметром
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
390 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
391 По умолчанию <literal>inactive</literal> равен 10 минутам.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
392 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
393
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
394 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
395 Специальный процесс “cache manager” следит за максимальным размером кэша,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
396 заданным параметром <literal>max_size</literal>, и при превышении
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
397 его размеров удаляет наименее востребованные данные.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
398 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
399
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
400 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
401 Через минуту после старта активируется специальный процесс “cache loader”,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
402 который загружает в зону кэша информацию о ранее закэшированных данных,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
403 хранящихся на файловой системе.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
404 Загрузка происходит итерациями.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
405 За одну итерацию загружается не более <literal>loader_files</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
406 элементов (по умолчанию 100).
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
407 Кроме того, время работы одной итерации ограничено параметром
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
408 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
409 Между итерациями делается пауза на время, заданное параметром
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
410 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
411 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
412
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
413 <para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
414 Кроме того,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
415 следующие параметры доступны как часть
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
416 <commercial_version>коммерческой подписки</commercial_version>:
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
417 </para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
418
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
419 <para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
420 <list type="tag">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
421
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
422 <tag-name id="purger">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
423 <literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
424 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
425 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
426 Указывает, будут ли записи в кэше, соответствующие
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
427 <link id="scgi_cache_purge">маске</link>,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
428 удалены с диска при помощи процесса “cache purger” (1.7.12).
1659
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
429 Установка параметра в значение <literal>on</literal>
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
430 (по умолчанию <literal>off</literal>)
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
431 активирует процесс “cache purger”, который
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
432 проходит по всем записям в кэше
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
433 и удаляет записи, соответствующие этой маске.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
434 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
435
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
436 <tag-name id="purger_files">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
437 <literal>purger_files</literal>=<value>число</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
438 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
439 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
440 Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
441 По умолчанию <literal>purger_files</literal> равен 10.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
442 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
443
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
444 <tag-name id="purger_threshold">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
445 <literal>purger_threshold</literal>=<value>время</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
446 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
447 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
448 Задаёт продолжительность одной итерации (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
449 По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
450 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
451
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
452 <tag-name id="purger_sleep">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
453 <literal>purger_sleep</literal>=<value>время</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
454 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
455 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
456 Задаёт паузу между итерациями (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
457 По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
458 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
459
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
460 </list>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
461 </para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
462
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
463 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
464
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
465
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
466 <directive name="scgi_cache_purge">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
467 <syntax>строка ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
468 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
469 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
470 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
471 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
472 <appeared-in>1.5.7</appeared-in>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
473
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
474 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
475 Задаёт условия, при которых запрос будет считаться запросом
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
476 на очистку кэша.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
477 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
478 то запись в кэше с соответствующим
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
479 <link id="scgi_cache_key">ключом кэширования</link> удаляется.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
480 В результате успешной операции возвращается ответ с кодом
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
481 <http-status code="204" text="No Content"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
482 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
483
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
484 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
485 Если <link id="scgi_cache_key">ключ кэширования</link>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
486 запроса на очистку заканчивается
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
487 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
488 этой маске, будут удалены из кэша.
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
489 Тем не менее, эти записи будут оставаться на диске или до момента удаления
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
490 из-за <link id="scgi_cache_path">отсутствия обращения к данным</link>,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
491 или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
492 или до попытки клиента получить к ним доступ.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
493 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
494
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
495 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
496 Пример конфигурации:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
497 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
498 scgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
499
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
500 map $request_method $purge_method {
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
501 PURGE 1;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
502 default 0;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
503 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
504
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
505 server {
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
506 ...
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
507 location / {
1185
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge.
Ruslan Ermilov <ru@nginx.com>
parents: 1184
diff changeset
508 scgi_pass http://backend;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge.
Ruslan Ermilov <ru@nginx.com>
parents: 1184
diff changeset
509 scgi_cache cache_zone;
f9c8336fe43c Aligned configuration examples with fastcgi/scgi_cache_purge.
Ruslan Ermilov <ru@nginx.com>
parents: 1184
diff changeset
510 scgi_cache_key $uri;
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
511 scgi_cache_purge $purge_method;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
512 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
513 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
514 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
515 <note>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
516 Функциональность доступна как часть
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
517 <commercial_version>коммерческой подписки</commercial_version>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
518 </note>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
519 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
520
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
521 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
522
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
523
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
524 <directive name="scgi_cache_revalidate">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
525 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
526 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
527 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
528 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
529 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
530 <appeared-in>1.5.7</appeared-in>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
531
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
532 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
533 Разрешает ревалидацию просроченных элементов кэша при помощи
1246
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1190
diff changeset
534 условных запросов с полями заголовка
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1190
diff changeset
535 <header>If-Modified-Since</header> и <header>If-None-Match</header>.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
536 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
537
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
538 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
539
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
540
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
541 <directive name="scgi_cache_use_stale">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
542 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
543 <literal>error</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
544 <literal>timeout</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
545 <literal>invalid_header</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
546 <literal>updating</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
547 <literal>http_500</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
548 <literal>http_503</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
549 <literal>http_403</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
550 <literal>http_404</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
551 <literal>off</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
552 ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
553 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
554 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
555 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
556 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
557
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
558 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
559 Определяет, в каких случаях можно использовать устаревший закэшированный ответ,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
560 если при работе с SCGI-сервером возникла ошибка.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
561 Параметры директивы совпадают с параметрами
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
562 директивы <link id="scgi_next_upstream"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
563 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
564
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
565 <para>
1542
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
566 Параметр <literal>error</literal> также позволяет использовать
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
567 устаревший закэшированный ответ при невозможности выбора
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
568 SCGI-сервера для обработки запроса.
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
569 </para>
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
570
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1524
diff changeset
571 <para>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
572 Кроме того, дополнительный параметр <literal>updating</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
573 разрешает использовать устаревший закэшированный ответ,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
574 если на данный момент он уже обновляется.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
575 Это позволяет минимизировать число обращений к SCGI-серверам
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
576 при обновлении закэшированных данных.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
577 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
578
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
579 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
580 Чтобы минимизировать число обращений к SCGI-серверам при
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
581 заполнении нового элемента кэша, можно воспользоваться директивой
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
582 <link id="scgi_cache_lock"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
583 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
584
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
585 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
586
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
587
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
588 <directive name="scgi_cache_valid">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
589 <syntax>[<value>код</value> ...] <value>время</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
590 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
591 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
592 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
593 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
594
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
595 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
596 Задаёт время кэширования для разных кодов ответа.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
597 Например, директивы
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
598 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
599 scgi_cache_valid 200 302 10m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
600 scgi_cache_valid 404 1m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
601 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
602 задают время кэширования 10 минут для ответов с кодами 200 и 302
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
603 и 1 минуту для ответов с кодом 404.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
604 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
605
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
606 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
607 Если указано только <value>время</value> кэширования,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
608 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
609 scgi_cache_valid 5m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
610 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
611 то кэшируются только ответы 200, 301 и 302.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
612 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
613
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
614 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
615 Кроме того, можно кэшировать любые ответы с помощью параметра
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
616 <literal>any</literal>:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
617 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
618 scgi_cache_valid 200 302 10m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
619 scgi_cache_valid 301 1h;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
620 scgi_cache_valid any 1m;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
621 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
622 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
623
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
624 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
625 Параметры кэширования могут также быть заданы непосредственно
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
626 в заголовке ответа.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
627 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
628 <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
629
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
630 <listitem>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
631 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
632 ответа в секундах.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
633 Значение 0 запрещает кэшировать ответ.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
634 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
635 время в секундах с начала эпохи, до которого ответ может быть закэширован.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
636 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
637
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
638 <listitem>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
639 Если в заголовке нет поля <header>X-Accel-Expires</header>,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
640 параметры кэширования определяются по полям заголовка
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
641 <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
642 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
643
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
644 <listitem>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
645 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
646 не будет кэшироваться.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
647 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
648
1353
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
649 <listitem>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
650 Ответ, в заголовке которого есть поле <header>Vary</header>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
651 со специальным значением “<literal>*</literal>”,
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
652 не будет кэшироваться (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
653 Ответ, в заголовке которого есть поле <header>Vary</header>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
654 с другим значением, будет закэширован
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
655 с учётом соответствующих полей заголовка запроса (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
656 </listitem>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
657
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
658 </list>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
659 Обработка одного или более из этих полей заголовка может быть отключена
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
660 при помощи директивы <link id="scgi_ignore_headers"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
661 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
662
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
663 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
664
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
665
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
666 <directive name="scgi_connect_timeout">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
667 <syntax><value>время</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
668 <default>60s</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
669 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
670 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
671 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
672
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
673 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
674 Задаёт таймаут для установления соединения с SCGI-сервером.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
675 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
676 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
677
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
678 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
679
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
680
1337
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
681 <directive name="scgi_force_ranges">
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
682 <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
683 <default>off</default>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
684 <context>http</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
685 <context>server</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
686 <context>location</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
687 <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
688
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
689 <para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
690 Включает поддержку диапазонов запрашиваемых байт (byte-range)
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
691 для кэшированных и некэшированных ответов SCGI-сервера
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
692 вне зависимости от наличия поля <header>Accept-Ranges</header>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
693 в заголовках этих ответов.
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
694 </para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
695
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
696 </directive>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
697
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
698
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
699 <directive name="scgi_hide_header">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
700 <syntax><value>поле</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
701 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
702 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
703 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
704 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
705
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
706 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
707 По умолчанию
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
708 nginx не передаёт клиенту поля заголовка <header>Status</header> и
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
709 <header>X-Accel-...</header> из ответа SCGI-сервера.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
710 Директива <literal>scgi_hide_header</literal> задаёт дополнительные поля,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
711 которые не будут передаваться.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
712 Если же передачу полей нужно разрешить, можно воспользоваться
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
713 директивой <link id="scgi_pass_header"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
714 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
715
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
716 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
717
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
718
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
719 <directive name="scgi_ignore_client_abort">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
720 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
721 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
722 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
723 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
724 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
725
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
726 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
727 Определяет, закрывать ли соединение с SCGI-сервером
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
728 в случае, если клиент закрыл соединение, не дождавшись ответа.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
729 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
730
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
731 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
732
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
733
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
734 <directive name="scgi_ignore_headers">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
735 <syntax><value>поле</value> ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
736 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
737 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
738 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
739 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
740
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
741 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
742 Запрещает обработку некоторых полей заголовка из ответа SCGI-сервера.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
743 В директиве можно указать поля <header>X-Accel-Redirect</header>,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
744 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
745 <header>X-Accel-Buffering</header> (1.1.6),
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
746 <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
747 <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
748 и <header>Vary</header> (1.7.7).
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
749 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
750
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
751 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
752 Если не запрещено, обработка этих полей заголовка заключается в следующем:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
753 <list type="bullet" compact="no">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
754
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
755 <listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
756 <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
757 <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
758 и <header>Vary</header>
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
759 задают параметры <link id="scgi_cache_valid">кэширования</link> ответа;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
760 </listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
761
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
762 <listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
763 <header>X-Accel-Redirect</header> производит
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
764 <link doc="ngx_http_core_module.xml" id="internal">внутреннее
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
765 перенаправление</link> на указанный URI;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
766 </listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
767
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
768 <listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
769 <header>X-Accel-Limit-Rate</header> задаёт
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
770 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
771 скорости</link> передачи ответа клиенту;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
772 </listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
773
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
774 <listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
775 <header>X-Accel-Buffering</header> включает или выключает
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
776 <link id="scgi_buffering">буферизацию</link> ответа;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
777 </listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
778
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
779 <listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
780 <header>X-Accel-Charset</header> задаёт желаемую
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
781 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
782 ответа.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
783 </listitem>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
784
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
785 </list>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
786 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
787
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
788 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
789
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
790
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
791 <directive name="scgi_intercept_errors">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
792 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
793 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
794 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
795 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
796 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
797
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
798 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
799 Определяет, передавать ли клиенту ответы SCGI-сервера с кодом
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
800 больше либо равным 300, или же перенаправлять их на обработку nginx’у с помощью
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
801 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
802 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
803
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
804 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
805
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
806
1342
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
807 <directive name="scgi_limit_rate">
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
808 <syntax><value>скорость</value></syntax>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
809 <default>0</default>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
810 <context>http</context>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
811 <context>server</context>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
812 <context>location</context>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
813 <appeared-in>1.7.7</appeared-in>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
814
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
815 <para>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
816 Ограничивает скорость чтения ответа от SCGI-сервера.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
817 <value>Скорость</value> задаётся в байтах в секунду.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
818 Значение 0 отключает ограничение скорости.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
819 Ограничение устанавливается на запрос,
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
820 поэтому, если nginx одновременно
1343
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
821 откроет два соединения к SCGI-серверу,
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
822 суммарная скорость будет вдвое выше заданного ограничения.
1342
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
823 Ограничение работает только в случае, если включена
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
824 <link id="scgi_buffering">буферизация</link> ответов SCGI-сервера.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
825 </para>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
826
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
827 </directive>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
828
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
829
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
830 <directive name="scgi_max_temp_file_size">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
831 <syntax><value>размер</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
832 <default>1024m</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
833 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
834 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
835 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
836
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
837 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
838 Если включена <link id="scgi_buffering">буферизация</link> ответов
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
839 SCGI-сервера, и ответ не вмещается целиком в буферы,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
840 заданные директивами <link id="scgi_buffer_size"/> и
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
841 <link id="scgi_buffers"/>, часть ответа может быть записана во временный файл.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
842 Эта директива задаёт максимальный <value>размер</value> временного файла.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
843 Размер данных, сбрасываемых во временный файл за один раз, задаётся
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
844 директивой <link id="scgi_temp_file_write_size"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
845 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
846
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
847 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
848 Значение 0 отключает возможность буферизации ответов во временные файлы.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
849 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
850
1352
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
851 <para>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
852 <note>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
853 Данное ограничение не распространяется на ответы,
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
854 которые будут <link id="scgi_cache">закэшированы</link>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
855 или <link id="scgi_store">сохранены</link> на диске.
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
856 </note>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
857 </para>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
858
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
859 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
860
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
861
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
862 <directive name="scgi_next_upstream">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
863 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
864 <literal>error</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
865 <literal>timeout</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
866 <literal>invalid_header</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
867 <literal>http_500</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
868 <literal>http_503</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
869 <literal>http_403</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
870 <literal>http_404</literal> |
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
871 <literal>non_idempotent</literal> |
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
872 <literal>off</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
873 ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
874 <default>error timeout</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
875 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
876 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
877 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
878
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
879 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
880 Определяет, в каких случаях запрос будет передан следующему серверу:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
881 <list type="tag">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
882
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
883 <tag-name><literal>error</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
884 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
885 чтения заголовка ответа сервера;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
886
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
887 <tag-name><literal>timeout</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
888 <tag-desc>произошёл таймаут во время соединения с сервером,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
889 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
890
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
891 <tag-name><literal>invalid_header</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
892 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
893
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
894 <tag-name><literal>http_500</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
895 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
896
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
897 <tag-name><literal>http_503</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
898 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
899
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
900 <tag-name><literal>http_403</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
901 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
902
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
903 <tag-name><literal>http_404</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
904 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
905
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
906 <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
907 <tag-desc>обычно запросы с
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
908 <link url="http://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
909 методом
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
910 (<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
911 не передаются на другой сервер,
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
912 если запрос серверу группы уже был отправлен (1.9.13);
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
913 включение параметра явно разрешает повторять подобные запросы;
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
914 </tag-desc>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
915
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
916
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
917 <tag-name><literal>off</literal></tag-name>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
918 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
919
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
920 </list>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
921 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
922
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
923 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
924 Необходимо понимать, что передача запроса следующему серверу возможна
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
925 только при условии, что клиенту ещё ничего не передавалось.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
926 То есть, если ошибка или таймаут возникли в середине передачи ответа,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
927 то исправить это уже невозможно.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
928 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
929
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
930 <para>
1289
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
931 Директива также определяет, что считается
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
932 <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
933 попыткой</link> работы с сервером.
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
934 Случаи <literal>error</literal>, <literal>timeout</literal> и
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
935 <literal>invalid_header</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
936 всегда считаются неудачными попытками, даже если они не указаны в директиве.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
937 Случаи <literal>http_500</literal> и <literal>http_503</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
938 считаются неудачными попытками, только если они указаны в директиве.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
939 Случаи <literal>http_403</literal> и <literal>http_404</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
940 никогда не считаются неудачными попытками.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
941 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
942
1290
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
943 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
944 Передача запроса следующему серверу может быть ограничена по
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
945 <link id="scgi_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
946 и по <link id="scgi_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
947 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
948
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
949 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
950
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
951
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
952 <directive name="scgi_next_upstream_timeout">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
953 <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
954 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
955 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
956 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
957 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
958 <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
959
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
960 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
961 Ограничивает время, в течение которого возможна передача запроса
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
962 <link id="scgi_next_upstream">следующему серверу</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
963 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
964 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
965
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
966 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
967
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
968
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
969 <directive name="scgi_next_upstream_tries">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
970 <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
971 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
972 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
973 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
974 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
975 <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
976
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
977 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
978 Ограничивает число допустимых попыток для передачи запроса
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
979 <link id="scgi_next_upstream">следующему серверу</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
980 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
981 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
982
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
983 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
984
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
985
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
986 <directive name="scgi_no_cache">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
987 <syntax><value>строка</value> ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
988 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
989 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
990 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
991 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
992
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
993 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
994 Задаёт условия, при которых ответ не будет сохраняться в кэш.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
995 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
996 то ответ не будет сохранён:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
997 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
998 scgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
999 scgi_no_cache $http_pragma $http_authorization;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1000 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1001 Можно использовать совместно с директивой <link id="scgi_cache_bypass"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1002 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1003
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1004 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1005
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1006
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1007 <directive name="scgi_param">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1008 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1009 <value>параметр</value> <value>значение</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1010 [<literal>if_not_empty</literal>]</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1011 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1012 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1013 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1014 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1015
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1016 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1017 Задаёт <value>параметр</value>, который будет передаваться SCGI-серверу.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1018 В качестве значения можно использовать текст, переменные и их комбинации.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1019 Директивы наследуются с предыдущего уровня при условии, что на данном
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1020 уровне не описаны свои директивы <literal>scgi_param</literal>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1021 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1022
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1023 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1024 Стандартные
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1025 <link url="http://tools.ietf.org/html/rfc3875#section-4.1">переменные
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1026 окружения CGI</link>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1027 должны передаваться как заголовки SCGI, см. файл <path>scgi_params</path>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1028 из дистрибутива:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1029 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1030 location / {
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1031 include scgi_params;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1032 ...
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1033 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1034 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1035 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1036
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1037 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1038 Если директива указана с <literal>if_not_empty</literal> (1.1.11),
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1039 то такой параметр с пустым значением передаваться на сервер не будет:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1040 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1041 scgi_param HTTPS $https if_not_empty;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1042 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1043 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1044
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1045 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1046
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1047
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1048 <directive name="scgi_pass">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1049 <syntax><value>адрес</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1050 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1051 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1052 <context>if в location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1053
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1054 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1055 Задаёт адрес SCGI-сервера.
1622
c4c1dddfedac Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents: 1582
diff changeset
1056 Адрес может быть указан в виде доменного имени или IP-адреса,
c4c1dddfedac Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents: 1582
diff changeset
1057 и порта:
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1058 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1059 scgi_pass localhost:9000;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1060 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1061 или в виде пути UNIX-сокета:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1062 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1063 scgi_pass unix:/tmp/scgi.socket;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1064 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1065 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1066
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1067 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1068 Если доменному имени соответствует несколько адресов, то все они будут
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1069 использоваться по очереди (round-robin).
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1070 И, кроме того, адрес может быть
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1071 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1072 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1073
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1074 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1075
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1076
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1077 <directive name="scgi_pass_header">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1078 <syntax><value>поле</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1079 <default/>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1080 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1081 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1082 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1083
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1084 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1085 Разрешает передавать от SCGI-сервера клиенту
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1086 <link id="scgi_hide_header">запрещённые для передачи</link> поля заголовка.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1087 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1088
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1089 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1090
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1091
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1092 <directive name="scgi_pass_request_body">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1093 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1094 <default>on</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1095 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1096 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1097 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1098
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1099 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1100 Позволяет запретить передачу исходного тела запроса
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1101 на SCGI-сервер.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1102 См. также директиву <link id="scgi_pass_request_headers"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1103 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1104
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1105 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1106
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1107
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1108 <directive name="scgi_pass_request_headers">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1109 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1110 <default>on</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1111 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1112 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1113 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1114
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1115 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1116 Позволяет запретить передачу полей заголовка исходного запроса на
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1117 SCGI-сервер.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1118 См. также директивы <link id="scgi_pass_request_body"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1119 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1120
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1121 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1122
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1123
1524
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1124 <directive name="scgi_read_timeout">
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1125 <syntax><value>время</value></syntax>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1126 <default>60s</default>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1127 <context>http</context>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1128 <context>server</context>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1129 <context>location</context>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1130
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1131 <para>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1132 Задаёт таймаут при чтении ответа SCGI-сервера.
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1133 Таймаут устанавливается не на всю передачу ответа,
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1134 а только между двумя операциями чтения.
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1135 Если по истечении этого времени SCGI-сервер ничего не передаст,
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1136 соединение закрывается.
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1137 </para>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1138
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1139 </directive>
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1140
323b0d071166 Relocated proxy_read_timeout and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1141
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1142 <directive name="scgi_request_buffering">
1659
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
1143 <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
1144 <default>on</default>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1145 <context>http</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1146 <context>server</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1147 <context>location</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1148 <appeared-in>1.7.11</appeared-in>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1149
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1150 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1151 Разрешает или запрещает использовать буферизацию тела запроса клиента.
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1152 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1153
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1154 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1155 Если буферизация включена, то тело запроса полностью
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1156 <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
1157 от клиента перед отправкой запроса на SCGI-сервер.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1158 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1159
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1160 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1161 Если буферизация выключена, то тело запроса отправляется
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1162 на SCGI-сервер сразу же по мере его поступления.
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1163 В этом случае запрос не может быть передан
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1164 <link id="scgi_next_upstream">следующему серверу</link>,
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1165 если nginx уже начал отправку тела запроса.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1166 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1167
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1168 <para>
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1169 Если для отправки тела исходного запроса используется HTTP/1.1
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1170 и передача данных частями (chunked transfer encoding),
1443
a55553729d63 Unified text of scgi and uwsgi request buffering with proxy.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1171 то тело запроса буферизуется независимо от значения директивы.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1172 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1173
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1174 </directive>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1175
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1176
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1177 <directive name="scgi_send_timeout">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1178 <syntax><value>время</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1179 <default>60s</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1180 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1181 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1182 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1184 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1185 Задаёт таймаут при передаче запроса SCGI-серверу.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1186 Таймаут устанавливается не на всю передачу запроса,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1187 а только между двумя операциями записи.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1188 Если по истечении этого времени SCGI-сервер не примет новых данных,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1189 соединение закрывается.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1190 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1191
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1192 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1193
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1194
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1195 <directive name="scgi_store">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1196 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1197 <literal>on</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1198 <literal>off</literal> |
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1199 <value>строка</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1200 <default>off</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1201 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1202 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1203 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1204
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1205 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1206 Разрешает сохранение на диск файлов.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1207 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1208 указанными в директивах
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1209 <link doc="ngx_http_core_module.xml" id="alias"/> или
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1210 <link doc="ngx_http_core_module.xml" id="root"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1211 Параметр <literal>off</literal> запрещает сохранение файлов.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1212 Кроме того, имя файла можно задать явно с помощью строки с переменными:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1213 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1214 scgi_store /data/www$original_uri;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1215 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1216 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1217
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1218 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1219 Время изменения файлов выставляется согласно полученному полю
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1220 <header>Last-Modified</header> в заголовке ответа.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1221 Ответ сначала записывается во временный файл, а потом этот файл
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1222 переименовывается.
1724
ce3e89d13fa0 Removed unneeded comma in "Since ..." Russian constructs.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1696
diff changeset
1223 Начиная с версии 0.8.9 временный файл и постоянное место хранения ответа
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1224 могут располагаться на разных файловых системах.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1225 Однако нужно учитывать,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1226 что в этом случае вместо дешёвой операции переименовывания в пределах
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1227 одной файловой системы файл копируется с одной файловой системы на другую.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1228 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1229 системе, что и каталог с временными файлами, задаваемый директивой
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1230 <link id="scgi_temp_path"/> для данного location.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1231 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1232
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1233 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1234 Директиву можно использовать для создания локальных копий статических
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1235 неизменяемых файлов, например, так:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1236 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1237 location /images/ {
1184
55857cbf562d Fixed alignment issues after mechanical conversion from fastcgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1183
diff changeset
1238 root /data/www;
55857cbf562d Fixed alignment issues after mechanical conversion from fastcgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1183
diff changeset
1239 error_page 404 = /fetch$uri;
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1240 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1241
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1242 location /fetch/ {
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1243 internal;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1244
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1245 scgi_pass backend:9000;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1246 ...
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1247
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1248 scgi_store on;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1249 scgi_store_access user:rw group:rw all:r;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1250 scgi_temp_path /data/temp;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1251
1184
55857cbf562d Fixed alignment issues after mechanical conversion from fastcgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1183
diff changeset
1252 alias /data/www/;
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1253 }
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1254 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1255 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1256
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1257 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1258
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1259
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1260 <directive name="scgi_store_access">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1261 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1262 <default>user:rw</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1263 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1264 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1265 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1266
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1267 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1268 Задаёт права доступа для создаваемых файлов и каталогов, например,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1269 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1270 scgi_store_access user:rw group:rw all:r;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1271 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1272 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1273
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1274 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1275 Если заданы какие-либо права для <literal>group</literal> или
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1276 <literal>all</literal>, то права для <literal>user</literal>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1277 указывать необязательно:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1278 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1279 scgi_store_access group:rw all:r;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1280 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1281 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1282
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1283 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1284
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1285
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1286 <directive name="scgi_temp_file_write_size">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1287 <syntax><value>размер</value></syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1288 <default>8k|16k</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1289 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1290 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1291 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1292
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1293 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1294 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1295 за один раз, при включённой буферизации ответов SCGI-сервера
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1296 во временные файлы.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1297 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1298 директивами <link id="scgi_buffer_size"/> и <link id="scgi_buffers"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1299 Максимальный размер временного файла задаётся директивой
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1300 <link id="scgi_max_temp_file_size"/>.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1301 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1302
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1303 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1304
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1305
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1306 <directive name="scgi_temp_path">
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1307 <syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1308 <value>путь</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1309 [<value>уровень1</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1310 [<value>уровень2</value>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1311 [<value>уровень3</value>]]]</syntax>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1312 <default>scgi_temp</default>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1313 <context>http</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1314 <context>server</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1315 <context>location</context>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1316
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1317 <para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1318 Задаёт имя каталога для хранения временных файлов с данными,
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1319 полученными от SCGI-серверов.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1320 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1321 Например, при такой конфигурации
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1322 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1323 scgi_temp_path /spool/nginx/scgi_temp 1 2;
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1324 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1325 временный файл будет следующего вида:
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1326 <example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1327 /spool/nginx/scgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1328 </example>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1329 </para>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1330
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1331 <para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1332 См. также параметр <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
1333 <link id="scgi_cache_path"/>.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1334 </para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1335
1183
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1336 </directive>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1337
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1338 </section>
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1339
1ce4912eb182 Translated SCGI module documentation into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1340 </module>