annotate xml/ru/docs/http/ngx_http_uwsgi_module.xml @ 1191:ea85ba147fe9

Mechanically converted SCGI module docs to uwsgi.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 17 May 2014 01:55:03 +0400
parents
children b5268820c3f3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
3 <!--
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
4 Copyright (C) Igor Sysoev
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
5 Copyright (C) Nginx, Inc.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
6 -->
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Модуль ngx_http_uwsgi_module"
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_uwsgi_module.html"
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
12 lang="ru"
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
13 rev="1">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="summary">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 Модуль <literal>ngx_http_uwsgi_module</literal> позволяет передавать
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 запросы uwsgi-серверу.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 </section>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 <section id="example" name="Пример конфигурации">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 location / {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 include uwsgi_params;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31 uwsgi_pass localhost:9000;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 </section>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 <section id="directives" name="Директивы">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 <directive name="uwsgi_bind">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 <syntax><value>адрес</value> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 Задаёт локальный IP-<value>адрес</value>, который будет использоваться в
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50 исходящих соединениях с uwsgi-сервером.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 В значении параметра допустимо использование переменных (1.3.12).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52 Специальное значение <literal>off</literal> (1.3.12) отменяет действие
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 унаследованной с предыдущего уровня конфигурации
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 директивы <literal>uwsgi_bind</literal>, позволяя системе
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 самостоятельно выбирать локальный IP-адрес.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61 <directive name="uwsgi_buffer_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 <default>4k|8k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 Задаёт <value>размер</value> буфера, в который будет читаться
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 первая часть ответа, получаемого от uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
71 В этой части ответа находится, как правило, небольшой заголовок ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
72 По умолчанию размер буфера равен размеру одного буфера в директиве
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73 <link id="uwsgi_buffers"/>, однако его можно сделать меньше.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
74 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
75
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
76 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
78
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
79 <directive name="uwsgi_buffering">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81 <default>on</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 Разрешает или запрещает использовать буферизацию ответов uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 Если буферизация включена, то nginx принимает ответ uwsgi-сервера
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 как можно быстрее, сохраняя его в буферы, заданные директивами
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 <link id="uwsgi_buffer_size"/> и <link id="uwsgi_buffers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 Если ответ не вмещается целиком в память, то его часть может быть записана
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 на диск во <link id="uwsgi_temp_path">временный файл</link>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 Запись во временные файлы контролируется директивами
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97 <link id="uwsgi_max_temp_file_size"/> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 <link id="uwsgi_temp_file_write_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 по мере его поступления.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104 nginx не пытается считать весь ответ uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 Максимальный размер данных, который nginx может принять от сервера
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106 за один раз, задаётся директивой <link id="uwsgi_buffer_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
110 Буферизация может быть также включена или выключена путём передачи
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112 <header>X-Accel-Buffering</header> заголовка ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 Эту возможность можно запретить с помощью директивы
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 <link id="uwsgi_ignore_headers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
120 <directive name="uwsgi_buffers">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
121 <syntax><value>число</value> <value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
122 <default>8 4k|8k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
128 Задаёт <value>число</value> и <value>размер</value> буферов
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
129 для одного соединения,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130 в которые будет читаться ответ, получаемый от uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131 По умолчанию размер одного буфера равен размеру страницы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 В зависимости от платформы это или 4K, или 8K.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 <directive name="uwsgi_busy_buffers_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 <default>8k|16k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 При включённой <link id="uwsgi_buffering">буферизации</link> ответов
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 uwsgi-сервера, ограничивает суммарный <value>размер</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148 буферов, которые могут быть заняты для отправки ответа клиенту, пока
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 ответ ещё не прочитан целиком.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 Оставшиеся буферы тем временем могут использоваться для чтения ответа
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 и, при необходимости, буферизации части ответа во временный файл.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153 директивами <link id="uwsgi_buffer_size"/> и <link id="uwsgi_buffers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
156 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
157
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 <directive name="uwsgi_cache">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160 <syntax><value>зона</value> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
162 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 Задаёт зону разделяемой памяти, используемой для кэширования.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 Одна и та же зона может использоваться в нескольких местах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 Параметр <literal>off</literal> запрещает кэширование, унаследованное
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 с предыдущего уровня конфигурации.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 <directive name="uwsgi_cache_bypass">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177 <syntax><value>строка</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
179 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
180 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
181 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
182
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
183 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
184 Задаёт условия, при которых ответ не будет браться из кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
185 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
186 то ответ не берётся из кэша:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
187 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
188 uwsgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
189 uwsgi_cache_bypass $http_pragma $http_authorization;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
190 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
191 Можно использовать совместно с директивой <link id="uwsgi_no_cache"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
194 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
195
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
196
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
197 <directive name="uwsgi_cache_key">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
198 <syntax><value>строка</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
199 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
200 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
201 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
202 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
203
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
204 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
205 Задаёт ключ для кэширования, например,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
206 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
207 uwsgi_cache_key localhost:9000$request_uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
208 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
209 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
210
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
211 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
212
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
213
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
214 <directive name="uwsgi_cache_lock">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
215 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
216 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
217 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
218 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
219 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
220 <appeared-in>1.1.12</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
221
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
222 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
223 Если включено, одновременно только одному запросу будет позволено
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
224 заполнить новый элемент кэша, идентифицируемый согласно директиве
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
225 <link id="uwsgi_cache_key"/>, передав запрос на uwsgi-сервер.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
226 Остальные запросы этого же элемента будут либо ожидать
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
227 появления ответа в кэше, либо освобождения блокировки
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
228 этого элемента, в течение времени, заданного директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
229 <link id="uwsgi_cache_lock_timeout"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
230 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
231
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
232 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
233
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
234
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
235 <directive name="uwsgi_cache_lock_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
236 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
237 <default>5s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
238 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
239 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
240 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
241 <appeared-in>1.1.12</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
242
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
243 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
244 Задаёт таймаут для <link id="uwsgi_cache_lock"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
245 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
246
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
247 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
248
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
249
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
250 <directive name="uwsgi_cache_methods">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
251 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
252 <literal>GET</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
253 <literal>HEAD</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
254 <literal>POST</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
255 ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
256 <default>GET HEAD</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
257 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
258 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
259 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
260
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
261 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
262 Если метод запроса клиента указан в этой директиве,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
263 то ответ будет закэширован.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
264 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
265 в список, но тем не менее рекомендуется перечислять их явно.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
266 См. также директиву <link id="uwsgi_no_cache"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
267 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
268
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
269 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
270
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
271
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
272 <directive name="uwsgi_cache_min_uses">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
273 <syntax><value>число</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
274 <default>1</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
275 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
276 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
277 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
278
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
279 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
280 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
281 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
282
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
283 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
284
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
285
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
286 <directive name="uwsgi_cache_path">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
287 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
288 <value>путь</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
289 [<literal>levels</literal>=<value>уровни</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
290 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
291 [<literal>inactive</literal>=<value>время</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
292 [<literal>max_size</literal>=<value>размер</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
293 [<literal>loader_files</literal>=<value>число</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
294 [<literal>loader_sleep</literal>=<value>время</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
295 [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
296 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
297 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
298
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
299 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
300 Задаёт путь и другие параметры кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
301 Данные кэша хранятся в файлах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
302 Именем файла в кэше является результат функции MD5
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
303 от <link id="uwsgi_cache_key">ключа кэширования</link>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
304 Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
305 например, при использовании
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
306 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
307 uwsgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
308 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
309 имена файлов в кэше будут такого вида:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
310 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
311 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
312 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
313 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
314
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
315 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
316 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
317 переименовывается.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
318 Начиная с версии 0.8.9, временные файлы и кэш
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
319 могут располагаться на разных файловых системах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
320 Однако нужно учитывать,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
321 что в этом случае вместо дешёвой операции переименовывания в пределах
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
322 одной файловой системы файл копируется с одной файловой системы на другую.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
323 Поэтому лучше, если кэш будет находиться на той же файловой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
324 системе, что и каталог с временными файлами, задаваемый директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
325 <link id="uwsgi_temp_path"/> для данного location.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
326 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
327
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
328 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
329 Кроме того, все активные ключи и информация о данных хранятся в зоне
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
330 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
331 задаются параметром <literal>keys_zone</literal>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
332 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
333 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
334
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
335 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
336 Если к данным кэша не обращаются в течение времени, заданного параметром
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
337 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
338 По умолчанию <literal>inactive</literal> равен 10 минутам.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
339 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
340
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
341 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
342 Специальный процесс “cache manager” следит за максимальным размером кэша,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
343 заданным параметром <literal>max_size</literal>, и при превышении
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
344 его размеров удаляет наименее востребованные данные.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
345 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
346
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
347 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
348 Через минуту после старта активируется специальный процесс “cache loader”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
349 который загружает в зону кэша информацию о ранее закэшированных данных,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
350 хранящихся на файловой системе.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
351 Загрузка происходит итерациями.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
352 За одну итерацию загружается не более <literal>loader_files</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
353 элементов (по умолчанию 100).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
354 Кроме того, время работы одной итерации ограничено параметром
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
355 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
356 Между итерациями делается пауза на время, заданное параметром
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
357 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
358 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
359
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
360 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
361
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
362
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
363 <directive name="uwsgi_cache_purge">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
364 <syntax>строка ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
365 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
366 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
367 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
368 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
369 <appeared-in>1.5.7</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
370
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
371 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
372 Задаёт условия, при которых запрос будет считаться запросом
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
373 на очистку кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
374 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
375 то запись в кэше с соответствующим
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
376 <link id="uwsgi_cache_key">ключом кэширования</link> удаляется.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
377 В результате успешной операции возвращается ответ с кодом
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
378 <http-status code="204" text="No Content"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
379 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
380
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
381 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
382 Если <link id="uwsgi_cache_key">ключ кэширования</link>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
383 запроса на очистку заканчивается
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
384 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
385 этой маске, будут удалены из кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
386 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
387
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
388 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
389 Пример конфигурации:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
390 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
391 uwsgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
392
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
393 map $request_method $purge_method {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
394 PURGE 1;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
395 default 0;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
396 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
397
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
398 server {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
399 ...
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
400 location / {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
401 uwsgi_pass http://backend;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
402 uwsgi_cache cache_zone;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
403 uwsgi_cache_key $uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
404 uwsgi_cache_purge $purge_method;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
405 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
406 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
407 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
408 <note>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
409 Функциональность доступна как часть
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
410 <commercial_version>коммерческой подписки</commercial_version>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
411 </note>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
412 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
413
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
414 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
415
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
416
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
417 <directive name="uwsgi_cache_revalidate">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
418 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
419 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
420 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
421 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
422 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
423 <appeared-in>1.5.7</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
424
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
425 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
426 Разрешает ревалидацию просроченных элементов кэша при помощи
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
427 условных запросов с полем заголовка <header>If-Modified-Since</header>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
428 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
429
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
430 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
431
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
432
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
433 <directive name="uwsgi_cache_use_stale">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
434 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
435 <literal>error</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
436 <literal>timeout</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
437 <literal>invalid_header</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
438 <literal>updating</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
439 <literal>http_500</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
440 <literal>http_503</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
441 <literal>http_403</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
442 <literal>http_404</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
443 <literal>off</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
444 ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
445 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
446 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
447 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
448 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
449
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
450 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
451 Определяет, в каких случаях можно использовать устаревший закэшированный ответ,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
452 если при работе с uwsgi-сервером возникла ошибка.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
453 Параметры директивы совпадают с параметрами
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
454 директивы <link id="uwsgi_next_upstream"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
455 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
456
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
457 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
458 Кроме того, дополнительный параметр <literal>updating</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
459 разрешает использовать устаревший закэшированный ответ,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
460 если на данный момент он уже обновляется.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
461 Это позволяет минимизировать число обращений к uwsgi-серверам
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
462 при обновлении закэшированных данных.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
463 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
464
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
465 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
466 Чтобы минимизировать число обращений к uwsgi-серверам при
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
467 заполнении нового элемента кэша, можно воспользоваться директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
468 <link id="uwsgi_cache_lock"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
469 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
470
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
471 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
472
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
473
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
474 <directive name="uwsgi_cache_valid">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
475 <syntax>[<value>код</value> ...] <value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
476 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
477 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
478 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
479 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
480
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
481 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
482 Задаёт время кэширования для разных кодов ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
483 Например, директивы
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
484 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
485 uwsgi_cache_valid 200 302 10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
486 uwsgi_cache_valid 404 1m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
487 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
488 задают время кэширования 10 минут для ответов с кодами 200 и 302
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
489 и 1 минуту для ответов с кодом 404.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
490 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
491
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
492 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
493 Если указано только <value>время</value> кэширования,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
494 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
495 uwsgi_cache_valid 5m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
496 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
497 то кэшируются только ответы 200, 301 и 302.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
498 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
499
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
500 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
501 Кроме того, можно кэшировать любые ответы с помощью параметра
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
502 <literal>any</literal>:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
503 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
504 uwsgi_cache_valid 200 302 10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
505 uwsgi_cache_valid 301 1h;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
506 uwsgi_cache_valid any 1m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
507 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
508 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
509
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
510 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
511 Параметры кэширования могут также быть заданы непосредственно
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
512 в заголовке ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
513 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
514 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
515 ответа в секундах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
516 Значение 0 запрещает кэшировать ответ.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
517 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
518 время в секундах с начала эпохи, до которого ответ может быть закэширован.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
519 Если в заголовке нет поля <header>X-Accel-Expires</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
520 параметры кэширования определяются по полям заголовка
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
521 <header>Expires</header> или <header>Cache-Control</header>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
522 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
523 не будет кэшироваться.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
524 Обработка одного или более из этих полей заголовка может быть отключена
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
525 при помощи директивы <link id="uwsgi_ignore_headers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
526 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
527
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
528 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
529
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
530
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
531 <directive name="uwsgi_connect_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
532 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
533 <default>60s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
534 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
535 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
536 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
537
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
538 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
539 Задаёт таймаут для установления соединения с uwsgi-сервером.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
540 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
541 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
542
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
543 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
544
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
545
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
546 <directive name="uwsgi_hide_header">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
547 <syntax><value>поле</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
548 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
549 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
550 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
551 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
552
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
553 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
554 По умолчанию
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
555 nginx не передаёт клиенту поля заголовка <header>Status</header> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
556 <header>X-Accel-...</header> из ответа uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
557 Директива <literal>uwsgi_hide_header</literal> задаёт дополнительные поля,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
558 которые не будут передаваться.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
559 Если же передачу полей нужно разрешить, можно воспользоваться
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
560 директивой <link id="uwsgi_pass_header"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
561 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
562
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
563 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
564
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
565
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
566 <directive name="uwsgi_ignore_client_abort">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
567 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
568 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
569 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
570 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
571 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
572
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
573 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
574 Определяет, закрывать ли соединение с uwsgi-сервером
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
575 в случае, если клиент закрыл соединение, не дождавшись ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
576 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
577
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
578 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
579
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
580
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
581 <directive name="uwsgi_ignore_headers">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
582 <syntax><value>поле</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
583 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
584 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
585 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
586 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
587
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
588 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
589 Запрещает обработку некоторых полей заголовка из ответа uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
590 В директиве можно указать поля <header>X-Accel-Redirect</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
591 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
592 <header>X-Accel-Buffering</header> (1.1.6),
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
593 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
594 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
595 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
596
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
597 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
598 Если не запрещено, обработка этих полей заголовка заключается в следующем:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
599 <list type="bullet" compact="no">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
600
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
601 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
602 <header>X-Accel-Expires</header>, <header>Expires</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
603 <header>Cache-Control</header> и <header>Set-Cookie</header>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
604 задают параметры <link id="uwsgi_cache_valid">кэширования</link> ответа;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
605 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
606
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
607 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
608 <header>X-Accel-Redirect</header> производит
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
609 <link doc="ngx_http_core_module.xml" id="internal">внутреннее
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
610 перенаправление</link> на указанный URI;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
611 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
612
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
613 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
614 <header>X-Accel-Limit-Rate</header> задаёт
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
615 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
616 скорости</link> передачи ответа клиенту;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
617 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
618
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
619 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
620 <header>X-Accel-Buffering</header> включает или выключает
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
621 <link id="uwsgi_buffering">буферизацию</link> ответа;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
622 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
623
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
624 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
625 <header>X-Accel-Charset</header> задаёт желаемую
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
626 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
627 ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
628 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
629
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
630 </list>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
631 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
632
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
633 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
634
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
635
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
636 <directive name="uwsgi_intercept_errors">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
637 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
638 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
639 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
640 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
641 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
642
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
643 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
644 Определяет, передавать ли клиенту ответы uwsgi-сервера с кодом
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
645 больше либо равным 300, или же перенаправлять их на обработку nginx’у с помощью
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
646 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
647 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
648
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
649 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
650
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
651
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
652 <directive name="uwsgi_max_temp_file_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
653 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
654 <default>1024m</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
655 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
656 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
657 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
658
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
659 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
660 Если включена <link id="uwsgi_buffering">буферизация</link> ответов
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
661 uwsgi-сервера, и ответ не вмещается целиком в буферы,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
662 заданные директивами <link id="uwsgi_buffer_size"/> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
663 <link id="uwsgi_buffers"/>, часть ответа может быть записана во временный файл.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
664 Эта директива задаёт максимальный <value>размер</value> временного файла.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
665 Размер данных, сбрасываемых во временный файл за один раз, задаётся
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
666 директивой <link id="uwsgi_temp_file_write_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
667 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
668
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
669 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
670 Значение 0 отключает возможность буферизации ответов во временные файлы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
671 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
672
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
673 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
674
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
675
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
676 <directive name="uwsgi_next_upstream">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
677 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
678 <literal>error</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
679 <literal>timeout</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
680 <literal>invalid_header</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
681 <literal>http_500</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
682 <literal>http_503</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
683 <literal>http_403</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
684 <literal>http_404</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
685 <literal>off</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
686 ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
687 <default>error timeout</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
688 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
689 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
690 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
691
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
692 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
693 Определяет, в каких случаях запрос будет передан следующему серверу:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
694 <list type="tag">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
695
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
696 <tag-name><literal>error</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
697 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
698 чтения заголовка ответа сервера;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
699
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
700 <tag-name><literal>timeout</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
701 <tag-desc>произошёл таймаут во время соединения с сервером,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
702 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
703
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
704 <tag-name><literal>invalid_header</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
705 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
706
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
707 <tag-name><literal>http_500</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
708 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
709
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
710 <tag-name><literal>http_503</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
711 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
712
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
713 <tag-name><literal>http_403</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
714 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
715
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
716 <tag-name><literal>http_404</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
717 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
718
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
719 <tag-name><literal>off</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
720 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
721
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
722 </list>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
723 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
724
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
725 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
726 Необходимо понимать, что передача запроса следующему серверу возможна
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
727 только при условии, что клиенту ещё ничего не передавалось.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
728 То есть, если ошибка или таймаут возникли в середине передачи ответа,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
729 то исправить это уже невозможно.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
730 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
731
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
732 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
733 Директива также определяет, что считается неудачной попыткой работы с
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
734 <link doc="ngx_http_upstream_module.xml" id="server">сервером</link>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
735 Случаи <literal>error</literal>, <literal>timeout</literal> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
736 <literal>invalid_header</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
737 всегда считаются неудачными попытками, даже если они не указаны в директиве.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
738 Случаи <literal>http_500</literal> и <literal>http_503</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
739 считаются неудачными попытками, только если они указаны в директиве.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
740 Случаи <literal>http_403</literal> и <literal>http_404</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
741 никогда не считаются неудачными попытками.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
742 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
743
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
744 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
745
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
746
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
747 <directive name="uwsgi_no_cache">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
748 <syntax><value>строка</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
749 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
750 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
751 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
752 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
753
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
754 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
755 Задаёт условия, при которых ответ не будет сохраняться в кэш.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
756 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
757 то ответ не будет сохранён:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
758 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
759 uwsgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
760 uwsgi_no_cache $http_pragma $http_authorization;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
761 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
762 Можно использовать совместно с директивой <link id="uwsgi_cache_bypass"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
763 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
764
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
765 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
766
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
767
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
768 <directive name="uwsgi_param">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
769 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
770 <value>параметр</value> <value>значение</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
771 [<literal>if_not_empty</literal>]</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
772 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
773 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
774 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
775 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
776
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
777 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
778 Задаёт <value>параметр</value>, который будет передаваться uwsgi-серверу.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
779 В качестве значения можно использовать текст, переменные и их комбинации.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
780 Директивы наследуются с предыдущего уровня при условии, что на данном
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
781 уровне не описаны свои директивы <literal>uwsgi_param</literal>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
782 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
783
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
784 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
785 Стандартные
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
786 <link url="http://tools.ietf.org/html/rfc3875#section-4.1">переменные
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
787 окружения CGI</link>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
788 должны передаваться как заголовки uwsgi, см. файл <path>uwsgi_params</path>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
789 из дистрибутива:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
790 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
791 location / {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
792 include uwsgi_params;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
793 ...
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
794 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
795 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
796 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
797
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
798 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
799 Если директива указана с <literal>if_not_empty</literal> (1.1.11),
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
800 то такой параметр с пустым значением передаваться на сервер не будет:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
801 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
802 uwsgi_param HTTPS $https if_not_empty;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
803 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
804 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
805
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
806 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
807
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
808
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
809 <directive name="uwsgi_pass">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
810 <syntax><value>адрес</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
811 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
812 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
813 <context>if в location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
814
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
815 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
816 Задаёт адрес uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
817 Адрес может быть указан в виде доменного имени или адреса, и порта, например,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
818 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
819 uwsgi_pass localhost:9000;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
820 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
821 или в виде пути UNIX-сокета:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
822 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
823 uwsgi_pass unix:/tmp/uwsgi.socket;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
824 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
825 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
826
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
827 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
828 Если доменному имени соответствует несколько адресов, то все они будут
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
829 использоваться по очереди (round-robin).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
830 И, кроме того, адрес может быть
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
831 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
832 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
833
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
834 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
835
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
836
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
837 <directive name="uwsgi_pass_header">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
838 <syntax><value>поле</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
839 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
840 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
841 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
842 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
843
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
844 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
845 Разрешает передавать от uwsgi-сервера клиенту
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
846 <link id="uwsgi_hide_header">запрещённые для передачи</link> поля заголовка.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
847 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
848
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
849 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
850
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
851
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
852 <directive name="uwsgi_pass_request_body">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
853 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
854 <default>on</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
855 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
856 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
857 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
858
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
859 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
860 Позволяет запретить передачу исходного тела запроса
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
861 на uwsgi-сервер.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
862 См. также директиву <link id="uwsgi_pass_request_headers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
863 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
864
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
865 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
866
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
867
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
868 <directive name="uwsgi_pass_request_headers">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
869 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
870 <default>on</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
871 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
872 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
873 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
874
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
875 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
876 Позволяет запретить передачу полей заголовка исходного запроса на
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
877 uwsgi-сервер.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
878 См. также директивы <link id="uwsgi_pass_request_body"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
879 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
880
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
881 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
882
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
883
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
884 <directive name="uwsgi_read_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
885 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
886 <default>60s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
887 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
888 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
889 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
890
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
891 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
892 Задаёт таймаут при чтении ответа uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
893 Таймаут устанавливается не на всю передачу ответа,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
894 а только между двумя операциями чтения.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
895 Если по истечении этого времени uwsgi-сервер ничего не передаст,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
896 соединение закрывается.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
897 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
898
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
899 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
900
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
901
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
902 <directive name="uwsgi_send_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
903 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
904 <default>60s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
905 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
906 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
907 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
908
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
909 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
910 Задаёт таймаут при передаче запроса uwsgi-серверу.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
911 Таймаут устанавливается не на всю передачу запроса,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
912 а только между двумя операциями записи.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
913 Если по истечении этого времени uwsgi-сервер не примет новых данных,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
914 соединение закрывается.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
915 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
916
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
917 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
918
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
919
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
920 <directive name="uwsgi_store">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
921 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
922 <literal>on</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
923 <literal>off</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
924 <value>строка</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
925 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
926 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
927 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
928 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
929
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
930 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
931 Разрешает сохранение на диск файлов.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
932 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
933 указанными в директивах
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
934 <link doc="ngx_http_core_module.xml" id="alias"/> или
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
935 <link doc="ngx_http_core_module.xml" id="root"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
936 Параметр <literal>off</literal> запрещает сохранение файлов.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
937 Кроме того, имя файла можно задать явно с помощью строки с переменными:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
938 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
939 uwsgi_store /data/www$original_uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
940 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
941 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
942
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
943 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
944 Время изменения файлов выставляется согласно полученному полю
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
945 <header>Last-Modified</header> в заголовке ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
946 Ответ сначала записывается во временный файл, а потом этот файл
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
947 переименовывается.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
948 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
949 могут располагаться на разных файловых системах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
950 Однако нужно учитывать,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
951 что в этом случае вместо дешёвой операции переименовывания в пределах
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
952 одной файловой системы файл копируется с одной файловой системы на другую.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
953 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
954 системе, что и каталог с временными файлами, задаваемый директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
955 <link id="uwsgi_temp_path"/> для данного location.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
956 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
957
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
958 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
959 Директиву можно использовать для создания локальных копий статических
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
960 неизменяемых файлов, например, так:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
961 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
962 location /images/ {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
963 root /data/www;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
964 error_page 404 = /fetch$uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
965 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
966
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
967 location /fetch/ {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
968 internal;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
969
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
970 uwsgi_pass backend:9000;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
971 ...
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
972
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
973 uwsgi_store on;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
974 uwsgi_store_access user:rw group:rw all:r;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
975 uwsgi_temp_path /data/temp;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
976
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
977 alias /data/www/;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
978 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
979 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
980 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
981
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
982 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
983
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
984
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
985 <directive name="uwsgi_store_access">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
986 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
987 <default>user:rw</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
988 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
989 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
990 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
991
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
992 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
993 Задаёт права доступа для создаваемых файлов и каталогов, например,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
994 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
995 uwsgi_store_access user:rw group:rw all:r;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
996 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
997 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
998
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
999 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1000 Если заданы какие-либо права для <literal>group</literal> или
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1001 <literal>all</literal>, то права для <literal>user</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1002 указывать необязательно:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1003 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1004 uwsgi_store_access group:rw all:r;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1005 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1006 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1007
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1008 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1009
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1010
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1011 <directive name="uwsgi_temp_file_write_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1012 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1013 <default>8k|16k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1014 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1015 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1016 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1017
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1018 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1019 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1020 за один раз, при включённой буферизации ответов uwsgi-сервера
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1021 во временные файлы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1022 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1023 директивами <link id="uwsgi_buffer_size"/> и <link id="uwsgi_buffers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1024 Максимальный размер временного файла задаётся директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1025 <link id="uwsgi_max_temp_file_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1026 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1027
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1028 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1029
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1030
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1031 <directive name="uwsgi_temp_path">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1032 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1033 <value>путь</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1034 [<value>уровень1</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1035 [<value>уровень2</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1036 [<value>уровень3</value>]]]</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1037 <default>uwsgi_temp</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1038 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1039 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1040 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1041
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1042 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1043 Задаёт имя каталога для хранения временных файлов с данными,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1044 полученными от uwsgi-серверов.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1045 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1046 Например, при такой конфигурации
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1047 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1048 uwsgi_temp_path /spool/nginx/uwsgi_temp 1 2;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1049 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1050 временный файл будет следующего вида:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1051 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1052 /spool/nginx/uwsgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1053 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1054 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1055
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1056 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1057
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1058 </section>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1059
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1060 </module>