annotate xml/ru/docs/http/ngx_http_core_module.xml @ 467:c505c92c8658

Documented recent changes to the "keepalive_disable" directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 28 Mar 2012 07:41:43 +0000
parents daafc5600fc4
children 4070589eebce
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 108
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
4
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
5 <module name="Модуль ngx_http_core_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
6 link="/ru/docs/http/ngx_http_core_module.html"
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
7 lang="ru">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
9 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
10
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 <directive name="aio">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
12 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
13 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
14 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
15 <literal>sendfile</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
16 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
17 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
18 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
19 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
20 <appeared-in>0.8.11</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
23 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO)
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24 во FreeBSD и Linux.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
25 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
28 Во FreeBSD AIO можно использовать, начиная с FreeBSD&nbsp;4.3.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
29 AIO можно либо собрать в ядре статически:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
30 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31 options VFS_AIO
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
33 либо загрузить динамически через загружаемый модуль ядра:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 kldload aio
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
40 В версиях FreeBSD 5 и 6 включение AIO статически или динамически
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
41 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
42 будет использовать блокировку Giant, что может негативно сказаться на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
43 производительности системы в целом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
44 Это ограничение устранено во FreeBSD&nbsp;6.4-STABLE в 2009 году
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
45 и во FreeBSD&nbsp;7.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
46 Однако, начиная с FreeBSD&nbsp;5.3 есть возможность включать AIO,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
47 не связывая сетевую подсистему блокировкой Giant — для этого модуль
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
48 AIO нужно подгружать уже после загрузки ядра.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
49 В этом случае в <path>/var/log/messages</path> появится следующее сообщение:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
54 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
55 <note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
56 Требование использовать блокировку Giant в AIO связано с тем, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
57 FreeBSD поддерживает асинхронные вызовы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
58 <c-func>aio_read</c-func>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
59 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
60 <c-func>aio_write</c-func>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
61 для работы с сокетами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
62 Но поскольку nginx использует AIO только для работы с диском,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
63 то проблем не возникает.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64 </note>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
68 Для работы AIO нужно выключить
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
69 <link id="sendfile"/>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
71 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
72 sendfile off;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
73 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
74 output_buffers 1 64k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
76 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
80 Кроме того, начиная с FreeBSD&nbsp;5.2.1 и nginx&nbsp;0.8.12, AIO также можно
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
81 использовать для подгрузки данных для <c-func>sendfile</c-func>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
82 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
83 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
84 sendfile on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
85 tcp_nopush on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
86 aio sendfile;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
87 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
89 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
90 <c-def>SF_NODISKIO</c-def>, в результате она не блокируется на диске, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
91 сообщает об отсутствии данных в памяти, после чего nginx инициирует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
92 асинхронную подгрузку данных, читая только один байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
93 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
94 при последующих чтениях файл подгружается частями только по 16K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
95 Изменить это можно с помощью директивы
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
96 <link id="read_ahead"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
98
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
99 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
100 В Linux AIO можно использовать только начиная с версии ядра 2.6.22, и,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
101 кроме того, ещё необходимо дополнительно включать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
102 <link id="directio"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
103 иначе чтение будет блокирующимся:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
105 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
106 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
107 directio 512;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
108 output_buffers 1 128k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
109 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
111 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
112
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
113 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
114 Поскольку
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
115 <link id="directio"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
116 в Linux можно использовать только для чтения блоков, выравненных
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
117 на границу 512 байт (или 4К для XFS), то невыравненный конец файла
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
118 будет читаться блокированно.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
119 То же относится к запросам с указанием диапазона запрашиваемых байт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
120 (byte-range requests) и к запросам FLV не с начала файла: чтение
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
121 невыравненных начала и конца ответа будет блокирующимся.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
122 Явно выключать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
123 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
124 не нужно, так как при использовании
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
125 <link id="directio"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
126 он выключается автоматически.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
127 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
128
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
129 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
130
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
131
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
132 <directive name="alias">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
133 <syntax><value>путь</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
134 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
136
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
137 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
138 Задаёт замену для указанного location'а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
139 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
140 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
141 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
142 alias /data/w3/images/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
145 на запрос
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
146 “<literal>/i/top.gif</literal>” будет отдан файл
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
147 <path>/data/w3/images/top.gif</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
151 В значении параметра <value>путь</value> можно использовать переменные,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
152 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
153 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
156 Если <literal>alias</literal> используется внутри location'а, заданного
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
157 регулярным выражением, то регулярное выражение должно содержать
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
158 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
159 (0.7.40), например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161 location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
162 alias /data/w3/images/$1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
163 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
165 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
166
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
167 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
168 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
169 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
170 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
171 alias /data/w3/images/;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
172 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
173 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
174 то лучше воспользоваться директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
175 <link id="root"/>:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
176 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
177 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
178 root /data/w3;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
179 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
181 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
182
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
183 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
184
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
185
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
186 <directive name="chunked_transfer_encoding">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
187 <syntax><literal>on</literal> | <literal>off</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
188 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
189 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
190 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
191 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
192
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
193 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
194 Позволяет запретить формат передачи данных частями (chunked transfer
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
195 encoding) в HTTP/1.1.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
196 Это может понадобиться при использовании программ, не поддерживающих
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
197 chunked encoding, несмотря на требования стандарта.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
198 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
199
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
200 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
201
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
202
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
203 <directive name="client_body_buffer_size">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
204
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
205 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
206 <default>8k|16k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
207 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
208 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
209 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
210
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
211 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
212 Задаёт размер буфера для чтения тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
213 Если тело запроса больше заданного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
214 то всё тело запроса или только его часть записывается во
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
215 <link id="client_body_temp_path">временный файл</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
216 По умолчанию размер одного буфера равен двум размерам страницы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
217 На x86, других 32-битных платформах и x86-64 это 8K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
218 На других 64-битных платформах это обычно 16K.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
219 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
220
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
221 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
222
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224 <directive name="client_body_in_file_only">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
225 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
226 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
227 <literal>clean</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
228 <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
229 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
230 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
231 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
232 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
233
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
234 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
235 Определяет, сохранять ли всё тело запроса клиента в файл.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
236 Директиву можно использовать для отладки и при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
237 <var>$request_body_file</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
238 или метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
239 <link doc="ngx_http_perl_module.xml" id="methods">$r->request_body_file</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
240 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
241 <link doc="ngx_http_perl_module.xml">ngx_http_perl_module</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
242 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
245 При установке значения <literal>on</literal> временные файлы
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
246 по окончании обработки запроса не удаляются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
247 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
248
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
250 Значение <literal>clean</literal> разрешает удалять временные файлы,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
251 оставшиеся по окончании обработки запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
252 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
253
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
254 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
255
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
256
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
257 <directive name="client_body_in_single_buffer">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
258 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
259 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
260 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
261 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
262 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
263
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
264 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
265 Определяет, сохранять ли всё тело запроса клиента в одном буфере.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
266 Директива рекомендуется при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
267 <var>$request_body</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
268 для уменьшения требуемого числа операций копирования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
269 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
270
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
271 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
272
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
273
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
274 <directive name="client_body_temp_path">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
275 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
276 <value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
277 [<value>уровень1</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
278 [<value>уровень2</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
279 [<value>уровень3</value>]]]</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
280 <default>client_body_temp</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
281 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
282 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
283 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
284
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
285 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
286 Задаёт каталог для хранения временных файлов с телами запросов клиентов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
287 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
288 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
289 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
290 client_body_temp_path /spool/nginx/client_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
291 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
292 временный файл будет следующего вида:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
293 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
294 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
295 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
296 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
297
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
298 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
299
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
300
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
301 <directive name="client_body_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
302 <syntax><value>время</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
303 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
304 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
305 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
306 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
307
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
308 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
309 Задаёт таймаут при чтении тела запроса клиента.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
310 Таймаут устанавливается не на всю передачу тела запроса,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
311 а только между двумя последовательными операциями чтения.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312 Если по истечении этого времени клиент ничего не передаст,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
313 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
314 <http-status code="408" text="Request Time-out"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
315 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
316
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
317 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
318
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
319
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
320 <directive name="client_header_buffer_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
321 <syntax><value>размер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
322 <default>1k</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
323 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
324 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
325
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
326 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
327 Задаёт размер буфера для чтения заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
328 Для большинства запросов достаточно буфера размером в 1K байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
329 Однако если в запросе есть длинные cookies, или же запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
330 пришёл от WAP-клиента, то он может не поместиться в 1K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
331 Поэтому, если строка запроса или поле заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
332 не помещаются полностью в этот буфер, то выделяются буферы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
333 большего размера, задаваемые директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
334 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
336
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
337 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
338
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
339
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
340 <directive name="client_header_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
341 <syntax><value>время</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
342 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
343 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
344 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
345
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
346 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
347 Задаёт таймаут при чтении заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
348 Если по истечении этого времени клиент не передаст полностью заголовок,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
349 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
350 <http-status code="408" text="Request Time-out"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
351 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
352
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
353 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
354
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
355
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
356 <directive name="client_max_body_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
357 <syntax><value>размер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
358 <default>1m</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
359 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
360 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
361 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
362
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
363 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
364 Задаёт максимально допустимый размер тела запроса клиента,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
365 указываемый в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
366 <header>Content-Length</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
367 заголовка запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
368 Если размер больше заданного, то клиенту возвращается ошибка
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
369 <http-status code="413" text="Request Entity Too Large"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
370 Следует иметь в виду, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
371 <!--link doc="/web/upload.xml"-->браузеры не умеют корректно показывать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
372 эту ошибку<!--/link-->.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
373 Установка параметра <value>размер</value> в 0 отключает
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
374 проверку размера тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
375 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
376
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
377 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
378
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
379
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
380 <directive name="connection_pool_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
381 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
382 <default>256</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
383 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
384 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
385
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
386 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
387 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
388 под конкретные соединения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
389 Эта директива не оказывает существенного влияния на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
390 производительность и её не следует использовать.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
391 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
392
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
393 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
394
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
395
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
396 <directive name="default_type">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
397 <syntax><value>mime-тип</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
398 <default>text/plain</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
399 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
400 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
401 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
402
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
403 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
404 Задаёт MIME-тип ответов по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
405 См. также директиву <link id="types"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
406 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
407
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
408 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
409
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
410
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
411 <directive name="directio">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
412 <syntax><value>размер</value> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
413 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
414 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
415 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
416 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
417 <appeared-in>0.7.7</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
418
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
419 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
420 Разрешает использовать флаги
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
421 <c-def>O_DIRECT</c-def> (FreeBSD, Linux),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
422 <c-def>F_NOCACHE</c-def> (Mac OS X)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
423 или функцию <c-func>directio</c-func> (Solaris)
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
424 при чтении файлов, размер которых больше либо равен указанному.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
425 Директива автоматически запрещает (0.7.15) использование
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
426 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
427 для данного запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
428 Рекомендуется использовать для больших файлов:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
429 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
430 directio 4m;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
431 </example>
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
432 или при использовании <link id="aio"/> в Linux.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
433 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
434
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
435 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
436
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
437
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
438 <directive name="directio_alignment">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
439 <syntax><value>размер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
440 <default>512</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
441 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
442 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
443 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
444 <appeared-in>0.8.11</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
445
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
446 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
447 Устанавливает выравнивание для
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
448 <link id="directio"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
449 В большинстве случаев достаточно 512-байтового выравнивания, однако
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
450 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
451 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
452
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
453 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
454
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
455
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
456 <directive name="disable_symlinks">
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
457 <syntax><literal>off</literal></syntax>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
458 <syntax>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
459 <literal>on</literal> |
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
460 <literal>if_not_owner</literal>
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
461 [<literal>from</literal>=<value>часть</value>]</syntax>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
462 <default>off</default>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
463 <context>http</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
464 <context>server</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
465 <context>location</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
466 <appeared-in>1.1.15</appeared-in>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
467
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
468 <para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
469 Определяет, как следует поступать с символическими ссылками
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
470 при открытии файлов:
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
471 <list type="tag">
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
472
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
473 <tag-name><literal>off</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
474 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
475 Символические ссылки в пути допускаются и не проверяются.
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
476 Это стандартное поведение.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
477 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
478
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
479 <tag-name><literal>on</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
480 <tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
481 Если любой компонент пути является символической ссылкой,
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
482 доступ к файлу запрещается.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
483 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
484
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
485 <tag-name><literal>if_not_owner</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
486 <tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
487 Доступ к файлу запрещается, если любой компонент пути
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
488 является символической ссылкой, а ссылка и объект, на
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
489 который она ссылается, имеют разных владельцев.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
490 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
491
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
492 <tag-name><literal>from</literal>=<value>часть</value></tag-name>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
493 <tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
494 При проверке символических ссылок
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
495 (параметры <literal>on</literal> и <literal>if_not_owner</literal>)
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
496 обычно проверяются все компоненты пути.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
497 Можно не проверять символические ссылки в начальной части пути,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
498 указав дополнительно параметр
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
499 <literal>from</literal>=<value>часть</value>.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
500 В этом случае символические ссылки проверяются лишь начиная
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
501 с компонента пути, который следует за заданной начальной частью.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
502 Если значение не является начальной частью проверяемого пути,
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
503 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
504 Если значение целиком совпадает с именем файла,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
505 символические ссылки не проверяются.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
506 В значении параметра можно использовать переменные.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
507 </tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
508
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
509 </list>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
510 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
511
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
512 <para>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
513 Пример:
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
514 <example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
515 disable_symlinks on from=$document_root;
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
516 </example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
517 </para>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
518
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
519 <para>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
520 Эта директива доступна только на системах, в которых есть
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
521 интерфейсы <c-func>openat</c-func> и <c-func>fstatat</c-func>.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
522 К таким системам относятся современные версии FreeBSD, Linux и Solaris.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
523 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
524
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
525 <para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
526 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
527 требуют дополнительных затрат на обработку.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
528 <note>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
529 На системах, не поддерживающих операцию открытия каталогов только для поиска,
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
530 использование этих параметров требует, чтобы рабочие процессы
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
531 имели право читать все проверяемые каталоги.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
532 </note>
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
533 </para>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
534
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
535 <para>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
536 <note>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
537 Модули
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
538 <link doc="ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link>,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
539 <link doc="ngx_http_random_index_module.xml">ngx_http_random_index_module</link>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
540 и <link doc="ngx_http_dav_module.xml">ngx_http_dav_module.xml</link>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
541 в настоящий момент игнорируют эту директиву.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
542 </note>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
543 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
544
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
545 </directive>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
546
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
547
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
548 <directive name="error_page">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
549 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
550 <value>код</value> ...
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
551 [<literal>=</literal>[<value>ответ</value>]]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
552 <value>uri</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
553 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
554 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
555 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
556 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
557 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
558
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
559 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
560 Задаёт URI, который будет показываться для указанных ошибок.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
561 Директивы <literal>error_page</literal> наследуются с предыдущего уровня
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
562 при условии, что на данном уровне не описаны свои директивы
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
563 <literal>error_page</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
564 В значении URI можно использовать переменные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
565 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
566
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
567 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
568 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
569 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
570 error_page 404 /404.html;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
571 error_page 502 503 504 /50x.html;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
572 error_page 403 http://example.com/forbidden.html;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
573 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
574 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
575
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
576 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
577 Кроме того, можно поменять код ответа на другой, например:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
578 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
579 error_page 404 =200 /empty.gif;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
580 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
581 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
582
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
583 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
584 Если ошибочный ответ обрабатывается проксированным сервером или
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
585 FastCGI-сервером, и этот сервер может вернуть разные коды ответов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
586 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
587 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
588 error_page 404 = /404.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
589 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
590 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
591
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
592 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
593 Если при перенаправлении не нужно менять URI, то можно перенаправить
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
594 обработку ошибки в именованный location:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
595 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
596 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
597 error_page 404 = @fallback;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
598 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
599
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
600 location @fallback {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
601 proxy_pass http://backend;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
602 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
603 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
604 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
605
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
606 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
607
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
608
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
609 <directive name="if_modified_since">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
610 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
611 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
612 <literal>exact</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
613 <literal>before</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
614 <default>exact</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
615 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
616 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
617 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
618 <appeared-in>0.7.24</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
619
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
620 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
621 Определяет, как сравнивать время модификации ответа с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
622 временем в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
623 <header>If-Modified-Since</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
624 заголовка запроса:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
625
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
626 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
627
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
628 <tag-name><literal>off</literal></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
629 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
630 не проверять поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
631 <header>If-Modified-Since</header> заголовка запроса (0.7.34);
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
632 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
633
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
634 <tag-name><literal>exact</literal></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
635 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
636 точное совпадение;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
637 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
638
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
639 <tag-name><literal>before</literal></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
640 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
641 время модификации ответа меньше или равно времени, заданному в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
642 <header>If-Modified-Since</header> заголовка запроса.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
643 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
644
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
645 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
646 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
647
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
648 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
649
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
650
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
651 <directive name="ignore_invalid_headers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
652 <syntax><literal>on</literal> | <literal>off</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
653 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
654 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
655 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
656
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
657 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
658 Если включено, nginx игнорирует поля заголовка с недопустимыми именами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
659 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
660 и возможно знаков подчёркивания (последнее контролируется директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
661 <link id="underscores_in_headers"/>).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
662 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
663
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
664 <para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
665 Директива может быть указана на уровне <link id="server"/>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
666 в сервере по умолчанию.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
667 В этом случае её значение распространяется на все виртуальные серверы,
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
668 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
669 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
670
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
671 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
672
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
673
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
674 <directive name="internal">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
675 <syntax/>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
676 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
677 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
678
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
679 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
680 Указывает, что location может использоваться только для внутренних запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
681 Для внешних запросов клиенту будет возвращаться ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
682 <http-status code="404" text="Not Found"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
683 Внутренними запросами являются:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
684
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
685 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
686
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
687 <listitem>
429
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
688 запросы, перенаправленные директивами
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
689 <link id="error_page"/>,
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
690 <link doc="ngx_http_index_module.xml" id="index"/>,
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
691 <link doc="ngx_http_random_index_module.xml" id="random_index"/> и
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
692 <link id="try_files"/>;
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
693 </listitem>
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
694
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
695 <listitem>
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
696 запросы, перенаправленные с помощью поля
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
697 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
698 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
699
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
700 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
701 подзапросы, формируемые командой
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
702 “<command>include virtual</command>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
703 модуля
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
704 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
705 и директивами модуля
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
706 <link doc="ngx_http_addition_module.xml">ngx_http_addition_module</link>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
707 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
708
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
709 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
710 запросы, изменённые директивой
429
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
711 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
712 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
713
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
714 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
715 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
716
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
717 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
718 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
719 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
720 error_page 404 /404.html;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
721
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
722 location /404.html {
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
723 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
724 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
725 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
726 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
727
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
728 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
729
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
730
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
731 <directive name="keepalive_disable">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
732 <syntax><literal>none</literal> | <value>браузер</value> ...</syntax>
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
733 <default>msie6</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
734 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
735 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
736 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
737
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
738 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
739 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
740 Параметры <value>браузер</value> указывают, на какие браузеры это
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
741 распространяется.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
742 Значение <literal>msie6</literal> запрещает keep-alive соединения
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
743 со старыми версиями MSIE после получения запроса POST.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
744 Значение <literal>safari</literal> запрещает keep-alive соединения
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
745 с Safari и подобными им браузерами на Mac OS X и подобных ей ОС.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
746 Значение <literal>none</literal> разрешает keep-alive соединения
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
747 со всеми браузерами.
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
748 <note>
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
749 До версии 1.1.18 под значение <literal>safari</literal> подпадали
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
750 все Sarari и подобные им браузеры на всех ОС, и keep-alive
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
751 соединения с ними были по умолчанию запрещены.
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
752 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
753 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
754
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
755 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
756
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
757
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
758 <directive name="keepalive_requests">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
759 <syntax><value>число</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
760 <default>100</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
761 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
762 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
763 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
764 <appeared-in>0.8.0</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
765
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
766 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
767 Задаёт максимальное число запросов, которые можно
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
768 сделать по одному keep-alive соединению.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
769 После того, как будет сделано максимальное число запросов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
770 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
771 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
772
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
773 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
774
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
775
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
776 <directive name="keepalive_timeout">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
777 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
778 <value>таймаут</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
779 [<value>заголовок_таймаута</value>]</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
780 <default>75s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
781 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
782 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
783 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
784
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
785 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
786 Первый параметр задаёт таймаут, в течение которого keep-alive
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
787 соединение с клиентом не будет закрыто со стороны сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
788 Второй необязательный параметр задаёт значение в поле
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
789 <header>Keep-Alive: timeout=<value>время</value></header>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
790 заголовка ответа.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
791 Два параметра могут отличаться друг от друга.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
792 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
793
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
794 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
795 Поле
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
796 <header>Keep-Alive: timeout=<value>время</value></header>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
797 заголовка понимают Mozilla и Konqueror.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
798 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
799 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
800
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
801 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
802
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
803
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
804 <directive name="large_client_header_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
805 <syntax><value>число</value> <value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
806 <default>4 8k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
807 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
808 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
809
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
810 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
811 Задаёт максимальное <value>число</value> и <value>размер</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
812 буферов для чтения большого заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
813 Строка запроса не должна превышать размера одного буфера, иначе клиенту
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
814 возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
815 <http-status code="414" text="Request-URI Too Large"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
816 Поле заголовка запроса также не должно превышать размера одного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
817 иначе клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
818 <http-status code="400" text="Bad Request"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
819 Буферы выделяются только по мере необходимости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
820 По умолчанию размер одного буфера равен 8K байт.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
821 Если по окончании обработки запроса соединение переходит в состояние
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
822 keep-alive, эти буферы освобождаются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
823 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
824
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
825 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
826
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
827
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
828 <directive name="limit_except">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
829 <syntax block="yes"><value>метод</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
830 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
831 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
832
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
833 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
834 Ограничивает HTTP-методы, доступные внутри location.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
835 Параметр <value>метод</value> может быть одним из
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
836 <literal>GET</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
837 <literal>HEAD</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
838 <literal>POST</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
839 <literal>PUT</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
840 <literal>DELETE</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
841 <literal>MKCOL</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
842 <literal>COPY</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
843 <literal>MOVE</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
844 <literal>OPTIONS</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
845 <literal>PROPFIND</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
846 <literal>PROPPATCH</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
847 <literal>LOCK</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
848 <literal>UNLOCK</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
849 или
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
850 <literal>PATCH</literal>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
851 Если разрешён метод <literal>GET</literal>, то метод
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
852 <literal>HEAD</literal> также будет разрешён.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
853 Доступ к остальным методам может быть ограничен при помощи директив модулей
79
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
854 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
855 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
856 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
857 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
858 limit_except GET {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
859 allow 192.168.1.0/32;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
860 deny all;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
861 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
862 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
863 Обратите внимание, что данное ограничение действует для всех методов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
864 <emphasis>кроме</emphasis> GET и HEAD.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
865 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
866
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
867 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
868
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
869
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
870 <directive name="limit_rate">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
871 <syntax><value>скорость</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
872 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
873 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
874 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
875 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
876 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
877
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
878 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
879 Ограничивает скорость передачи ответа клиенту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
880 Скорость задаётся в байтах в секунду.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
881 Значение 0 (установка по умолчанию) отключает ограничение скорости.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
882 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
883 Чем меньше скорость, тем более аккуратным будет ограничение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
884 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
885 Ограничение срабатывает только для одного соединения, то есть если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
886 клиент откроет 2 соединения, то суммарная скорость будет в 2 раза
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
887 выше заданного ограничения.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
888 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
889
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
890 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
891 Если необходимо ограничить скорость для части клиентов на уровне
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
892 <link id="server">сервера</link>, то директива <literal>limit_rate</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
893 для этого не подходит.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
894 Вместо этого следует задать желаемое ограничение скорости в переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
895 <var>$limit_rate</var>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
896 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
897 server {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
898
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
899 if ($slow) {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
900 set $limit_rate 4k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
901 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
902
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
903 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
904 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
905 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
906 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
907
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
908 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
909
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
910
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
911 <directive name="limit_rate_after">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
912 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
913 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
914 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
915 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
916 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
917 <context>if в location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
918 <appeared-in>0.8.0</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
919
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
920 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
921 Задаёт начальный объём данных, после передачи которого начинает
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
922 ограничиваться скорость передачи ответа клиенту.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
923 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
924
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
925 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
926 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
927 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
928 location /flv/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
929 flv;
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
930 limit_rate_after 500k;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
931 limit_rate 50k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
932 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
933 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
934 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
935
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
936 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
937
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
938
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
939 <directive name="lingering_close">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
940 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
941 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
942 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
943 <literal>always</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
944 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
945 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
946 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
947 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
948 <appeared-in>1.1.0</appeared-in>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
949 <appeared-in>1.0.6</appeared-in>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
950
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
951 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
952 Управляет закрытием соединений с клиентами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
953 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
954
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
955 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
956 Со значением по умолчанию “<literal>on</literal>” nginx будет
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
957 <link id="lingering_timeout">ждать</link> и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
958 <link id="lingering_time">обрабатывать</link> дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
959 поступающие от клиента, перед полным закрытием соединения, но только
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
960 если эвристика указывает на то, что клиент может ещё послать данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
961 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
962
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
963 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
964 Со значением “<literal>always</literal>” nginx всегда будет
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
965 ждать и обрабатывать дополнительные данные, поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
966 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
967
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
968 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
969 Со значением “<literal>off</literal>” nginx не будет ждать поступления
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
970 дополнительных данных и сразу же закроет соединение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
971 Это нарушает протокол, поэтому не следует это использовать без нужды.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
972 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
973
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
974 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
975
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
976
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
977 <directive name="lingering_time">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
978 <syntax><value>время</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
979 <default>30s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
980 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
981 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
982 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
983
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
984 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
985 Если действует <link id="lingering_close"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
986 эта директива задаёт максимальное время, в течение которого nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
987 будет обрабатывать (читать и игнорировать) дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
988 поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
989 По прошествии этого времени соединение будет закрыто, даже если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
990 будут ещё данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
991 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
992
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
993 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
994
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
995
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
996 <directive name="lingering_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
997 <syntax><value>время</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
998 <default>5s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
999 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1000 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1001 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1002
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1003 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1004 Если действует <link id="lingering_close"/>, эта директива задаёт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1005 максимальное время ожидания поступления дополнительных данных от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1006 Если в течение этого времени данные не были получены, соединение закрывается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1007 Иначе данные читаются и игнорируются, затем nginx снова ждёт поступления данных.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1008 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1009 директивой <link id="lingering_time"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1010 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1011
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1012 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1013
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1014
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1015 <directive name="listen">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1016 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1017 <value>адрес</value>[:<value>порт</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1018 [<literal>default_server</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1019 [<literal>setfib</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1020 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1021 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1022 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1023 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1024 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1025 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1026 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1027 [<literal>ssl</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1028 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1029 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1030 <value>порт</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1031 [<literal>default_server</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1032 [<literal>setfib</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1033 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1034 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1035 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1036 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1037 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1038 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1039 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1040 [<literal>ssl</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1041 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1042 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1043 <literal>unix:</literal><value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1044 [<literal>default_server</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1045 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1046 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1047 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1048 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1049 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1050 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1051 [<literal>ssl</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1052 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1053 <default>*:80 | *:8000</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1054 <context>server</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1055
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1056 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1057 Задаёт <value>адрес</value> и <value>порт</value> для IP
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1058 или <value>путь</value> для UNIX-сокета,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1059 на которых сервер будет принимать запросы.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1060 Можно указать только <value>адрес</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1061 или только <value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1062 Кроме того, <value>адрес</value> может быть именем хоста, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1063 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1064 listen 127.0.0.1:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1065 listen 127.0.0.1;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1066 listen 8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1067 listen *:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1068 listen localhost:8000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1069 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1070 IPv6-адреса (0.7.36) задаются в квадратных скобках:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1071 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1072 listen [::]:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1073 listen [fe80::1];
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1074 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1075 UNIX-сокеты (0.8.21) задаются при помощи префикса “<literal>unix:</literal>”:
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1076 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1077 listen unix:/var/run/nginx.sock;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1078 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1079 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1080
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1081 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1082 Если указан только <value>адрес</value>, то используется порт 80.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1083 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1084
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1085 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1086 Если директива не указана, то используется либо <literal>*:80</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1087 (если nginx работает с привилегиями суперпользователя),
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1088 либо <literal>*:8000</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1089 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1090
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1091 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1092 Если у директивы есть параметр <literal>default_server</literal>, то сервер,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1093 в котором описана эта директива, будет сервером по умолчанию для указанной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1094 <value>адрес</value>:<value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1095 Если же директив с параметром <literal>default_server</literal> нет, то
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1096 сервером по умолчанию будет первый сервер, в котором описана пара
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1097 <value>адрес</value>:<value>порт</value>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1098 адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1099 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1100 До версии 0.8.21 этот параметр назывался просто
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1101 <literal>default</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1102 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1103 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1104
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1105 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1106 В директиве <literal>listen</literal> можно также указать несколько
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1107 дополнительных параметров, специфичных для системных вызовов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1108 <c-func>listen</c-func> и <c-func>bind</c-func>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1109 Эти параметры можно задать в любой директиве <literal>listen</literal>,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1110 но только один раз для указанной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1111 <value>адрес</value>:<value>порт</value>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1112 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1113 До версии 0.8.21 их можно было указывать лишь в директиве
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1114 <literal>listen</literal> с параметром <literal>default</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1115 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1116 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1117
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1118 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1119 <literal>setfib</literal>=<value>число</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1120 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1121 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1122 этот параметр (0.8.44) задаёт для слушающего сокета соответствующую
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1123 таблицу маршрутизации (FIB).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1124 В настоящий момент это работает только на FreeBSD.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1125 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1126
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1127 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1128 <literal>backlog</literal>=<value>число</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1129 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1130 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1131 задаёт параметр <literal>backlog</literal> в вызове
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1132 <c-func>listen</c-func>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1133 По умолчанию <literal>backlog</literal> равен -1 для FreeBSD
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1134 и 511 для других платформ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1135 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1136
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1137 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1138 <literal>rcvbuf</literal>=<value>размер</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1139 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1140 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1141 задаёт параметр <c-def>SO_RCVBUF</c-def> для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1142 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1143
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1144 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1145 <literal>sndbuf</literal>=<value>размер</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1146 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1147 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1148 задаёт параметр <c-def>SO_SNDBUF</c-def> для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1149 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1150
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1151 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1152 <literal>accept_filter</literal>=<value>фильтр</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1153 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1154 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1155 задаёт название accept-фильтра.
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1156 Работает только на FreeBSD, можно использовать два фильтра —
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1157 <literal>dataready</literal> и <literal>httpready</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1158 По сигналу <c-def>SIGHUP</c-def> accept-фильтр можно менять только в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1159 последних версиях FreeBSD, начиная с 6.0, 5.4-STABLE и 4.11-STABLE.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1160 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1161
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1162 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1163 <literal>deferred</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1164 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1165 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1166 указывает использовать отложенный <c-func>accept</c-func> на Linux
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1167 с помощью опции <c-def>TCP_DEFER_ACCEPT</c-def>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1168 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1169
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1170 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1171 <literal>bind</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1172 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1173 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1174 указывает, что для данной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1175 <value>адрес</value>:<value>порт</value> нужно делать
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1176 <c-func>bind</c-func> отдельно.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1177 Дело в том, что если описаны несколько директив <literal>listen</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1178 с одинаковым портом, но разными адресами и одна из директив
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1179 <literal>listen</literal> слушает на всех адресах для данного порта
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1180 (<literal>*:</literal><value>порт</value>, то nginx сделает
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1181 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1182 Необходимо заметить, что в этом случае для определения адреса, на которой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1183 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1184 Если же используются параметры <literal>backlog</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1185 <literal>rcvbuf</literal>, <literal>sndbuf</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1186 <literal>accept_filter</literal>, <literal>deferred</literal>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1187 или <literal>so_keepalive</literal>, то для данной пары
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1188 <value>адрес</value>:<value>порт</value> всегда делается
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1189 отдельный вызов <c-func>bind</c-func>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1190 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1191
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1192 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1193 <literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1194 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1195 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1196 параметр (0.7.42) задаёт значение параметра <c-def>IPV6_V6ONLY</c-def>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1197 для слушающего сокета.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1198 Установить этот параметр можно только один раз на старте.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1199 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1200
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1201 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1202 <literal>ssl</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1203 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1204 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1205 этот параметр (0.7.14) не имеет отношения к системным вызовам
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1206 <c-func>listen</c-func> и <c-func>bind</c-func>, а позволяет указать,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1207 что все соединения, принимаемые на этом порту, должны работать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1208 в режиме SSL.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1209 Это позволяет задать компактную конфигурацию для сервера,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1210 работающего сразу в двух режимах — HTTP и HTTPS.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1211 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1212 listen 80;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1213 listen 443 default ssl;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1214 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1215 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1216
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1217 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1218 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1219 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1220 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1221 этот параметр (1.1.11) конфигурирует для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1222 поведение “TCP keepalive”.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1223 Если этот параметр опущен, то для сокета будут действовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1224 стандартные системные настройки.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1225 Если он установлен в значение “<literal>on</literal>”, то для сокета
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1226 включается опция <c-def>SO_KEEPALIVE</c-def>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1227 Если он установлен в значение “<literal>off</literal>”, то для сокета
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1228 опция <c-def>SO_KEEPALIVE</c-def> выключается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1229 Некоторые операционные системы поддерживают настройку параметров
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1230 “TCP keepalive” на уровне сокета посредством опций
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1231 <c-def>TCP_KEEPIDLE</c-def>, <c-def>TCP_KEEPINTVL</c-def> и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1232 <c-def>TCP_KEEPCNT</c-def>.
397
f1c0ae9c1c48 FreeBSD 10.0-CURRENT supports the TCP_KEEPIDLE, TCP_KEEPINTVL, and
Ruslan Ermilov <ru@nginx.com>
parents: 381
diff changeset
1233 На таких системах (в настоящий момент это Linux 2.4+, NetBSD 5+ и
454
daafc5600fc4 FreeBSD 9.0-STABLE supports the TCP_KEEPIDLE, TCP_KEEPINTVL, and
Ruslan Ermilov <ru@nginx.com>
parents: 453
diff changeset
1234 FreeBSD 9.0-STABLE)
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1235 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1236 <value>keepintvl</value> и <value>keepcnt</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1237 Один или два параметра могут быть опущены, в таком случае для
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1238 соответствующей опции сокета будут действовать стандартные
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1239 системные настройки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1240 Например,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1241 <example>so_keepalive=30m::10</example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1242 установит таймаут бездействия (<c-def>TCP_KEEPIDLE</c-def>) в 30 минут,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1243 для интервала проб (<c-def>TCP_KEEPINTVL</c-def>) будет действовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1244 стандартная системная настройка, а счётчик проб (<c-def>TCP_KEEPCNT</c-def>)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1245 будет равен 10.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1246 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1247
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1248 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1249 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1250
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1251 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1252 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1253 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1254 listen 127.0.0.1 default accept_filter=dataready backlog=1024;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1255 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1256 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1257
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1258 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1259
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1260
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1261 <directive name="location">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1262 <syntax block="yes">[
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1263 <literal>=</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1264 <literal>~</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1265 <literal>~*</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1266 <literal>^~</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1267 ] <value>uri</value></syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1268 <syntax block="yes"><literal>@</literal><value>имя</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
1269 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1270 <context>server</context>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1271 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1272
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1273 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1274 Устанавливает конфигурацию в зависимости от URI запроса.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1275 location можно задать префиксной строкой или регулярным выражением.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1276 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1277 (для поиска совпадения без учёта регистра символов),
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1278 либо с префиксом “<literal>~</literal>” (с учётом регистра).
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1279 Чтобы найти location, соответствующий запросу, вначале проверяются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1280 location'ы, заданные префиксными строками (префиксные location'ы).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1281 Среди них ищется максимальное совпадение.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1282 Затем проверяются регулярные выражения, в порядке их следования
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1283 в конфигурационном файле.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1284 Проверка регулярных выражений прекращается после первого же совпадения,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1285 и используется соответствующая конфигурация.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1286 Если совпадение с регулярным выражением не найдено, то используется
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1287 конфигурация максимально совпавшего префиксного location'а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1288 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1289
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1290 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1291 location'ы могут быть вложенными, с некоторыми исключениями,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1292 о которых говорится ниже.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1293 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1294
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1295 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1296 Для операционных систем, нечувствительных к регистру символов, таких
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1297 как Mac OS X и Cygwin, сравнение с префиксными строками производится
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1298 без учёта регистра (0.7.7).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1299 Однако, сравнение ограничено только однобайтными locale'ями.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1300 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1301
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1302 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1303 Регулярные выражения могут содержать выделения (0.7.40), которые могут
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1304 затем использоваться в других директивах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1305 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1306
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1307 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1308 Если у максимального совпавшего префиксного location'а указан префикс
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1309 “<literal>^~</literal>”, то регулярные выражения не проверяются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1310 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1311
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1312 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1313 Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1314 совпадение URI и location.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1315 При точном совпадении поиск сразу же прекращается.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1316 Например, если запрос “<literal>/</literal>” случается часто, то
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1317 указав “<literal>location = /</literal>”, можно ускорить обработку
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1318 этих запросов, так как поиск прекратится после первого же сравнения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1319 Очевидно, что такой location не может иметь вложенные location'ы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1320 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1321
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1322 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1323 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1324 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1325 location'ом без префиксов “<literal>=</literal>” и “<literal>^~</literal>”,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1326 то поиск тоже сразу же прекращается и регулярные выражения также
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1327 не проверяются.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1328 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1329 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1330
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1331 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1332 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1333 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1334 location = / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1335 [ конфигурация А ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1336 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1337
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1338 location / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1339 [ конфигурация Б ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1340 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1341
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1342 location ^~ /images/ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1343 [ конфигурация В ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1344 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1345
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1346 location ~* \.(gif|jpg|jpeg)$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1347 [ конфигурация Г ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1348 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1349 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1350 Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1351 для запроса “<literal>/documents/document.html</literal>” — конфигурация Б,
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1352 для запроса “<literal>/images/1.gif</literal>” — конфигурация В,
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1353 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Г.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1354 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1355
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1356 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1357 Префикс “<literal>@</literal>” задаёт именованный location.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1358 Такой location не используется при обычной обработке запросов, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1359 предназначен только для перенаправления в него запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1360 Такие location'ы не могут быть вложенными и не могут содержать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1361 вложенные location'ы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1362 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1363
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1364 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1365 <migration from="Apache" directive="Location" />
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1366 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1367
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1368 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1369
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1370
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1371 <directive name="log_not_found">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1372 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1373 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1374 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1375 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1376 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1377
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1378 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1379 Разрешает или запрещает записывать в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1380 <link doc="../ngx_core_module.xml" id="error_log"/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1381 ошибки о том, что файл не найден.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1382 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1383
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1384 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1385
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1386
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1387 <directive name="log_subrequest">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1388 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1389 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1390 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1391 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1392 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1393
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1394 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1395 Разрешает или запрещает записывать в
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
1396 <link doc="ngx_http_log_module.xml" id="access_log"/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1397 подзапросы.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1398 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1399
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1400 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1401
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1402
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1403 <directive name="max_ranges">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1404 <syntax><value>число</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1405 <default/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1406 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1407 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1408 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1409
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1410 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1411 Ограничивает максимальное допустимое число диапазонов в запросах с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1412 указанием диапазона запрашиваемых байт (byte-range requests).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1413 Запросы, превышающие указанное ограничение, обрабатываются как
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1414 если бы они не содержали указания диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1415 По умолчанию ограничения нет.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1416 Значение 0 полностью запрещает поддержку диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1417 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1418
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1419 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1420
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1421
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1422 <directive name="merge_slashes">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1423 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1424 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1425 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1426 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1427
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1428 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1429 Разрешает или запрещает преобразование URI путём замены двух и более подряд
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1430 идущих слэшей (“<literal>/</literal>”) в один.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1431 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1432
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1433 <para>
280
cbb789d3ce5e Fixed grammar error.
Ruslan Ermilov <ru@nginx.com>
parents: 274
diff changeset
1434 Необходимо иметь в виду, что это преобразование необходимо для корректной
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1435 проверки префиксных строк и регулярных выражений.
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1436 Если его не делать, то запрос “<literal>//scripts/one.php</literal>”
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1437 не попадёт в
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1438 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1439 location /scripts/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1440 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1441 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1442 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1443 и может быть обслужен как статический файл.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1444 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1445 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1446
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1447 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1448 Запрет преобразования может понадобиться, если в URI используются имена,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1449 закодированные методом base64, в котором задействован символ
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1450 “<literal>/</literal>”.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1451 Однако по соображениям безопасности лучше избегать отключения преобразования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1452 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1453
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1454 <para>
442
b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents: 438
diff changeset
1455 Директива может быть указана на уровне <link id="server"/>
b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents: 438
diff changeset
1456 в сервере по умолчанию.
b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents: 438
diff changeset
1457 В этом случае её значение распространяется на все виртуальные серверы,
b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents: 438
diff changeset
1458 слушающие на том же адресе и порту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1459 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1460
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1461 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1462
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1463
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1464 <directive name="msie_padding">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1465 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1466 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1467 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1468 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1469 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1470
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1471 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1472 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1473 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1474 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1475
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1476 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1477
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1478
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1479 <directive name="msie_refresh">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1480 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1481 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1482 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1483 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1484 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1485
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1486 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1487 Разрешает или запрещает выдавать для MSIE клиентов refresh'ы вместо
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1488 перенаправлений.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1489 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1490
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1491 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1492
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1493
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1494 <directive name="open_file_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1495 <syntax><literal>off</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1496 <syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1497 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1498 [<literal>inactive</literal>=<value>время</value>]</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1499 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1500 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1501 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1502 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1503
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1504 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1505 Задаёт кэш, в котором могут храниться:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1506 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1507
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1508 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1509 дескрипторы открытых файлов, информация об их размерах и времени модификации;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1510 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1511
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1512 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1513 информация о существовании каталогов;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1514 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1515
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1516 <listitem>
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1517 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1518 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1519 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1520 Кэширование ошибок нужно разрешить отдельно директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1521 <link id="open_file_cache_errors"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1522 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1523 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1524
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1525 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1526 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1527
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1528 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1529 У директивы есть следующие параметры:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1530 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1531
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1532 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1533 <literal>max</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1534 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1535 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1536 задаёт максимальное число элементов в кэше;
274
457c54242cfa Stole translation of LRU from ngx_http_proxy_module.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1537 при переполнении кэша удаляются самые невостребованные элементы (LRU);
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1538 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1539
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1540 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1541 <literal>inactive</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1542 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1543 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1544 задаёт время, после которого элемент кэша удаляется, если к нему
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1545 не было обращений в течение этого времени; по умолчанию 60 секунд;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1546 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1547
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1548 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1549 <literal>off</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1550 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1551 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1552 запрещает кэш.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1553 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1554
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1555 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1556 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1557
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1558 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1559 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1560 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1561 open_file_cache max=1000 inactive=20s;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1562 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1563 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1564 open_file_cache_errors on;
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1565 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1566 open_file_cache_events on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1567 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1568 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1569 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1570
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1571 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1572
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1573
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1574 <directive name="open_file_cache_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1575 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1576 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1577 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1578 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1579 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1580
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1581 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1582 Разрешает или запрещает кэширование ошибок поиска файлов в
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1583 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1584 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1585
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1586 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1587
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1588
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1589 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1590
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1591 <directive name="open_file_cache_events">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1592 <syntax><literal>on</literal> | <literal>off</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1593 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1594 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1595 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1596 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1597
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1598 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1599 Разрешает использование событий ядра для проверки актуальности элементов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1600 <link id="open_file_cache"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1601 Эта директива работает только совместно с методом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1602 <link doc="../events.xml" id="kqueue"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1603 Заметьте, что только NetBSD&nbsp;2.0+ и FreeBSD&nbsp;6.0+
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1604 поддерживают события для файловых систем произвольного типа.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1605 Другие операционные системы поддерживают события только для
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1606 основных файловых систем, таких как UFS или FFS.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1607 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1608
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1609 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1610
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1611 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1612
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1613
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1614 <directive name="open_file_cache_min_uses">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1615 <syntax><value>число</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1616 <default>1</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1617 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1618 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1619 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1620
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1621 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1622 Задаёт минимальное <value>число</value> обращений к файлу
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1623 в течение времени, заданного параметром <literal>inactive</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1624 директивы <link id="open_file_cache"/>, после которого дескриптор
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1625 файла будет оставаться открытым в кэше.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1626 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1627
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1628 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1629
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1630
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1631 <directive name="open_file_cache_valid">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1632 <syntax><value>время</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1633 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1634 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1635 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1636 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1637
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1638 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1639 Определяет время, через которое следует проверять актуальность информации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1640 об элементе в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1641 <link id="open_file_cache"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1642 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1643 При включенном
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1644 <link id="open_file_cache_events"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1645 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1646 по факту их изменения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1647 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1648 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1649
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1650 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1651
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1652
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1653 <directive name="optimize_server_names">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1654 <syntax><literal>on</literal> | <literal>off</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1655 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1656 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1657 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1658
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1659 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1660 Директива устарела, вместо неё следует использовать директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1661 <link id="server_name_in_redirect"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1662 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1663
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1664 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1665 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1666 Разрешает или запрещает оптимизировать проверку имени хоста в name-based
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1667 виртуальных серверах.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1668 Проверка в частности влияет на имя хоста, используемого в перенаправлениях.
381
8ad9df891e23 Fixed grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1669 Если оптимизация разрешена и все name-based серверы, слушающие на одной
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1670 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1671 имена не проверяются и в перенаправлениях используется первое имя сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1672 Если в перенаправлении нужно использовать имя хоста, переданное клиентом,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1673 то оптимизацию нужно выключить.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1674 </para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1675 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1676
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1677 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1678
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1679
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1680 <directive name="port_in_redirect">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1681 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1682 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1683 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1684 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1685 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1686
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1687 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1688 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx'ом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1689 </para>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1690
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1691 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1692 См. также директиву <link id="server_name_in_redirect"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1693 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1694
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1695 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1696
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1697
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1698 <directive name="postpone_output">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1699 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1700 <default>1460</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1701 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1702 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1703 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1704
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1705 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1706 Если это возможно, то отправка данных клиенту будет отложена пока nginx не
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1707 накопит по крайней мере указанное количество байт для отправки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1708 Значение 0 запрещает отложенную отправку данных.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1709 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1710
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1711 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1712
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1713
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1714 <directive name="read_ahead">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1715 <syntax><value>размер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1716 <default>0</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1717 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1718 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1719 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1720
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1721 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1722 Задаёт ядру размер предчтения при работе с файлами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1723 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1724
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1725 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1726 На Linux используется системный вызов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1727 <literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1728 поэтому параметр <value>размер</value> там игнорируется.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1729 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1730
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1731 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1732 На FreeBSD используется системный вызов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1733 <literal>fcntl(O_READAHEAD,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1734 </literal><value>размер</value><literal>)</literal>,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1735 появившийся во FreeBSD&nbsp;9.0-CURRENT.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1736 Для FreeBSD&nbsp;7 необходимо установить
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1737 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1738 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1739
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1740 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1741
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1742
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1743 <directive name="recursive_error_pages">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1744 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1745 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1746 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1747 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1748 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1749
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1750 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1751 Разрешает или запрещает делать несколько перенаправлений через директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1752 <link id="error_page"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1753 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1754
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1755 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1756
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1757
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1758 <directive name="request_pool_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1759 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1760 <default>4k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1761 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1762 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1763
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1764 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1765 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1766 под конкретные запросы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1767 Эта директива не оказывает существенного влияния на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1768 производительность и её не следует использовать.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1769 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1770
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1771 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1772
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1773
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1774 <directive name="reset_timedout_connection">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1775 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1776 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1777 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1778 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1779 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1780
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1781 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1782 Разрешает или запрещает сброс соединений по таймауту.
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1783 Сброс делается следующим образом — перед закрытием сокета для него
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1784 ставится опция
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1785 <c-def>SO_LINGER</c-def>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1786 с таймаутом 0.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1787 После чего при закрытии сокета клиенту отсылается TCP RST, а вся память,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1788 связанная с этим сокетом, освобождается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1789 Это позволяет избежать длительного нахождения уже закрытого сокета в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1790 состоянии FIN_WAIT1 с заполненными буферами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1791 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1792
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1793 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1794 Необходимо отметить, что keep-alive соединения по истечении таймаута
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1795 закрываются обычным образом.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1796 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1797
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1798 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1799
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1800
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1801 <directive name="resolver">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1802 <syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1803 <value>адрес</value> ...
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1804 [<literal>valid</literal>=<value>время</value>]</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
1805 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1806 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1807 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1808 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1809
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1810 <para>
318
4a0fe9283dc7 Word polishing in the description of the "server" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 280
diff changeset
1811 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1812 в адреса, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1813 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1814 resolver 127.0.0.1 192.0.2.1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1815 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1816 Параметр <value>адрес</value> может быть задан либо
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1817 IPv4-адресом, либо именем хоста;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1818 во втором случае используется первый полученный IPv4-адрес.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1819 Серверы DNS опрашиваются циклически.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1820 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1821 До версии 1.1.7 можно было задать лишь один DNS-сервер.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1822 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1823 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1824 Необязательный параметр <literal>valid</literal> позволяет это
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1825 переопределить:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1826 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1827 resolver 127.0.0.1 192.0.2.1 valid=30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1828 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1829 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1830 До версии 1.1.9 настройка времени кэширования была невозможна
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1831 и nginx всегда кэшировал ответы на срок в 5 минут.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1832 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1833 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1834
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1835 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1836
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1837
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1838 <directive name="resolver_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1839 <syntax><value>время</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1840 <default>30s</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1841 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1842 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1843 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1844
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1845 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1846 Задаёт таймаут для преобразования имени в адрес, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1847 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1848 resolver_timeout 5s;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1849 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1850 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1851
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1852 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1853
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1854
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1855 <directive name="root">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1856 <syntax><value>путь</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1857 <default>html</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1858 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1859 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1860 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1861 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1862
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1863 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1864 Задаёт корневой каталог для запросов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1865 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1866 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1867 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1868 root /data/w3;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1869 }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1870 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1871 в ответ на запрос “<literal>/i/top.gif</literal>” будет отдан файл
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1872 <path>/data/w3/i/top.gif</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1873 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1874
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1875 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1876 В значении параметра <value>путь</value> можно использовать переменные,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1877 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1878 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1879
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1880 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1881 Путь к файлу формируется путём простого добавления URI к значению директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1882 <literal>root</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1883 Если же URI необходимо поменять, следует воспользоваться директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1884 <link id="alias"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1885 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1886
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1887 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1888
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1889
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1890 <directive name="satisfy">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1891 <syntax><literal>all</literal> | <literal>any</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1892 <default>all</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1893 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1894 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1895 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1896
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1897 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1898 Разрешает доступ, если оба (<literal>all</literal>)
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1899 или хотя бы один (<literal>any</literal>) из модулей
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1900 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1901 и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1902 разрешают доступ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1903 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1904
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1905 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1906 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1907 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1908 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1909 satisfy any;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1910
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1911 allow 192.168.1.0/32;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1912 deny all;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1913
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1914 auth_basic "closed site";
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1915 auth_basic_user_file conf/htpasswd;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1916 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1917 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1918 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1919
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1920 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1921
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1922
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1923 <directive name="satisfy_any">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1924 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1925 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1926 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1927 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1928 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1929
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1930 <para>
406
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
1931 Эта директива была заменена параметром <literal>any</literal>
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
1932 директивы <link id="satisfy"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1933 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1934
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1935 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1936
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1937
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1938 <directive name="send_lowat">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1939 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1940 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1941 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1942 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1943 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1944
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1945 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1946 При установке в ненулевое значение nginx будет пытаться минимизировать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1947 число операций отправки на клиентских сокетах либо при помощи флага
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1948 <c-def>NOTE_LOWAT</c-def> метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1949 <link doc="../events.xml" id="kqueue"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1950 либо при помощи опции сокета <c-def>SO_SNDLOWAT</c-def>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1951 с указанным размером.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1952 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1953
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1954 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1955 Эта директива игнорируется на Linux, Solaris и Windows.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1956 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1957
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1958 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1959
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1960
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1961 <directive name="send_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1962 <syntax><value>время</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1963 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1964 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1965 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1966 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1967
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1968 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1969 Задаёт таймаут при передаче ответа клиенту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1970 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1971 а только между двумя операциями записями.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1972 Если по истечении этого времени клиент ничего не примет,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1973 соединение будет закрыто.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1974 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1975
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1976 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1977
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1978
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1979 <directive name="sendfile">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1980
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1981 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
1982 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1983 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1984 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1985 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1986 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1987
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1988 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1989 Разрешает или запрещает использовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1990 <c-func>sendfile</c-func>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1991 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1992
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1993 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1994
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1995
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1996 <directive name="sendfile_max_chunk">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1997
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1998 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1999 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2000 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2001 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2002 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2003
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2004 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2005 При установке в ненулевое значение ограничивает объём данных,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2006 который может передан за один вызов <c-func>sendfile</c-func>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2007 Без этого ограничения одно быстрое соединение может целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2008 захватить рабочий процесс.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2009 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2010
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2011 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2012
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2013
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2014 <directive name="server">
108
72524ae53106 Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
2015 <syntax block="yes"/>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
2016 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2017 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2018
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2019 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2020 Задаёт конфигурацию для виртуального сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2021 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2022 и name-based (на основании поля <header>Host</header> заголовка запроса) нет.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2023 Вместо этого директивами <link id="listen"/> описываются все
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2024 адреса и порты, на которых нужно принимать соединения для этого сервера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2025 а в директиве <link id="server_name"/> указываются все имена серверов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2026 Пример конфигурации описан в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2027 <link doc="../virtual_hosts.xml">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2028 настройке виртуальных серверов</link>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2029 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2030
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2031 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2032
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2033
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2034 <directive name="server_name">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2035 <syntax><value>имя</value> ...</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2036 <default>""</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2037 <context>server</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2038
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2039 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2040 Задаёт имена виртуального сервера, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2041 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2042 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2043 server_name example.com www.example.com;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2044 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2045 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2046 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2047
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2048 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2049 Первое имя становится основным именем сервера.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2050 В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2051 для замены первой или последней части имени:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2052 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2053 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2054 server_name example.com *.example.com www.example.*;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2055 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2056 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2057 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2058
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2059 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2060 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2061 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2062 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2063 server_name .example.com;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2064 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2065 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2066 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2067
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2068 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2069 Если параметр равен “<var>$hostname</var>” (0.9.4), то
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2070 подставляется имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2071 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2072
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2073 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2074 В качестве имени сервера можно также использовать регулярное выражение,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2075 указав перед ним тильду (“<literal>~</literal>”):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2076 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2077 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2078 server_name www.example.com ~^www\d+\.example\.com$;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2079 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2080 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2081 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2082
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2083 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2084 Регулярное выражение может содержать выделения (0.7.40),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2085 которые могут затем использоваться в других директивах:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2086 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2087 server {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2088 server_name ~^(www\.)?(.+)$;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2089
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2090 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2091 root /sites/$2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2092 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2093 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2094
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2095 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2096 server_name _;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2097
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2098 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2099 root /sites/default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2100 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2101 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2102 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2103 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2104
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2105 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2106 Именованные выделения в регулярном выражении создают переменные (0.8.25),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2107 которые могут затем использоваться в других директивах:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2108 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2109 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2110 server_name ~^(www\.)?(?&lt;domain&gt;.+)$;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2111
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2112 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2113 root /sites/$domain;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2114 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2115 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2116
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2117 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2118 server_name _;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2119
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2120 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2121 root /sites/default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2122 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2123 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2124 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2125 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2126
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2127 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2128 Возможно также указать пустое имя сервера (0.7.11):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2129 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2130 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2131 server_name www.example.com "";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2132 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2133 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2134 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2135 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2136 Это настройка по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2137 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2138 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2139 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2140 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2141
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2142 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2143 Порядок проверки имён следующий:
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2144 <list type="enum">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2145
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2146 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2147 полные имена
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2148 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2149
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2150 <listitem>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2151 имена с маской в начале имени, например “<literal>*.example.com</literal>”
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2152 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2153
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2154 <listitem>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2155 имена с маской в конце имени, например “<literal>mail.*</literal>”
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2156 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2157
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2158 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2159 регулярные выражения
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2160 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2161
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2162 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2163 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2164
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2165 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2166
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2167
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2168 <directive name="server_name_in_redirect">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2169 <syntax><literal>on</literal> | <literal>off</literal></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2170 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2171 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2172 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2173 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2174
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2175 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2176 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx'ом,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2177 основное имя сервера, задаваемое директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2178 <link id="server_name"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2179 Если запрещено, то используется имя, указанное в поле <header>Host</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2180 заголовка запроса.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2181 Если же этого поля нет, то используется IP-адрес сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2182 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2183
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2184 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2185 См. также директиву <link id="port_in_redirect"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2186 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2187
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2188 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2189
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2190
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2191 <directive name="server_names_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2192 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2193 <default>32|64|128</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2194 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2195
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2196 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2197 Задаёт размер корзины в хэш-таблицах имён серверов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2198 Значение по умолчанию зависит от размера строки кэша процессора.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2199 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2200 <link doc="../hash.xml">настройке хэшей</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2201 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2202
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2203 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2204
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2205
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2206 <directive name="server_names_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2207 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2208 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2209 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2210
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2211 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2212 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2213 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2214 <link doc="../hash.xml">настройке хэшей</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2215 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2216
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2217 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2218
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2219
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2220 <directive name="server_tokens">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2221 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2222 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2223 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2224 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2225 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2226
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2227 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2228 Разрешает или запрещает выдавать версию nginx'а в сообщениях об ошибках и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2229 в поле <header>Server</header> заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2230 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2231
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2232 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2233
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2234
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2235 <directive name="tcp_nodelay">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2236 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2237 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2238 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2239 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2240 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2241
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2242 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2243 Разрешает или запрещает использование опции <c-def>TCP_NODELAY</c-def>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2244 Опция включаются только при переходе соединения в состояние keep-alive.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2245 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2246
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2247 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2248
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2249
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2250 <directive name="tcp_nopush">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2251 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2252 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2253 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2254 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2255 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2256
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2257 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2258 Разрешает или запрещает использование опции сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2259 <c-def>TCP_NOPUSH</c-def> во FreeBSD или
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2260 <c-def>TCP_CORK</c-def> в Linux.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2261 Опции включаются только при использовании <link id="sendfile"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2262 Включение опции позволяет
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2263 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2264
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2265 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2266 передавать заголовок ответа и начало файла в одном пакете
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2267 в Linux и во FreeBSD&nbsp;4.*;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2268 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2269
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2270 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2271 передавать файл полными пакетами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2272 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2273
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2274 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2275 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2276
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2277 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2278
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2279
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2280 <directive name="try_files">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2281 <syntax><value>файл</value> ... <value>uri</value></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2282 <syntax><value>файл</value> ... =<value>код</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
2283 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2284 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2285 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2286
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2287 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2288 Проверяет существование файлов в заданном порядке и использует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2289 для обработки запроса первый найденный файл, причём обработка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2290 делается в контексте этого же location'а.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2291 Путь к файлу строится из параметра <value>файл</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2292 в соответствии с директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2293 <link id="root"/> и <link id="alias"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2294 С помощью слэша в конце имени можно проверить существование каталога,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2295 например, “<literal>$uri/</literal>”.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2296 В случае, если ни один файл не найден, то делается внутреннее
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2297 перенаправление на <value>uri</value>, заданный последним параметром.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2298 Например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2299 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2300 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2301 try_files $uri /images/default.gif;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2302 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2303
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2304 location = /images/default.gif {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2305 expires 30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2306 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2307 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2308 Последний параметр может также указывать на именованный location,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2309 смотрите примеры ниже.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2310 С версии 0.7.51 последний параметр может также быть кодом:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2311 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2312 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2313 try_files $uri $uri/index.html $uri.html =404;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2314 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2315 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2316 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2317
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2318 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2319 Пример использования при проксировании Mongrel:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2320 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2321 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2322 try_files /system/maintenance.html
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2323 $uri $uri/index.html $uri.html
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2324 @mongrel;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2325 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2326
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2327 location @mongrel {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2328 proxy_pass http://mongrel;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2329 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2330 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2331 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2332
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2333 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2334 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2335 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2336 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2337 try_files $uri $uri/ @drupal;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2338 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2339
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2340 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2341 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2342
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2343 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2344
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2345 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2346 fastcgi_param SCRIPT_NAME $fastcgi_script_name;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2347 fastcgi_param QUERY_STRING $args;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2348
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2349 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2350 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2351
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2352 location @drupal {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2353 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2354
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2355 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2356 fastcgi_param SCRIPT_NAME /index.php;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2357 fastcgi_param QUERY_STRING q=$uri&amp;$args;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2358
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2359 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2360 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2361 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2362 В следующем примере директива <literal>try_files</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2363 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2364 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2365 try_files $uri $uri/ @drupal;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2366 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2367 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2368 аналогична директивам
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2369 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2370 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2371 error_page 404 = @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2372 log_not_found off;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2373 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2374 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2375 А здесь
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2376 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2377 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2378 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2379
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2380 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2381
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2382 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2383
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2384 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2385 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2386 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2387 <literal>try_files</literal> проверяет существование PHP-файла,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2388 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2389 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2390
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2391 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2392 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2393 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2394 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2395 try_files $uri $uri/ @wordpress;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2396 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2397
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2398 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2399 try_files $uri @wordpress;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2400
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2401 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2402
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2403 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2404 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2405 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2406
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2407 location @wordpress {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2408 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2409
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2410 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2411 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2412 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2413 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2414 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2415
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2416 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2417
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2418
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2419 <directive name="types">
108
72524ae53106 Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
2420 <syntax block="yes"/>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2421 <default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2422 text/html html;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2423 image/gif gif;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2424 image/jpeg jpg;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2425 </default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2426 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2427 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2428 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2429
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2430 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2431 Задаёт соответствие расширений имён файлов и MIME-типов ответов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2432 Расширения нечувствительны к регистру символов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2433 Одному MIME-типу может соответствовать несколько расширений, например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2434 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2435 types {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2436 application/octet-stream bin exe dll;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2437 application/octet-stream deb;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2438 application/octet-stream dmg;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2439 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2440 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2441 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2442
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2443 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2444 Достаточно полная таблица соответствий входит в дистрибутив nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2445 и находится в файле <path>conf/mime.types</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2446 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2447
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2448 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2449 Для того, чтобы для определённого location'а для всех ответов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2450 выдавался MIME-тип “<literal>application/octet-stream</literal>”,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2451 можно использовать следующее:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2452 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2453 location /download/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2454 types { }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2455 default_type application/octet-stream;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2456 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2457 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2458 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2459
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2460 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2461
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2462
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2463 <directive name="types_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2464 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2465 <default>32|64|128</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2466 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2467 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2468 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2469
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2470 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2471 Задаёт размер корзины в хэш-таблицах типов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2472 Значение по умолчанию зависит от размера строки кэша процессора.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2473 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2474 <link doc="../hash.xml">настройке хэшей</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2475 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2476
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2477 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2478
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2479
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2480 <directive name="types_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2481 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2482 <default>1024</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2483 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2484 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2485 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2486
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2487 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2488 Задаёт максимальный <value>размер</value> хэш-таблиц типов.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2489 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2490 <link doc="../hash.xml">настройке хэшей</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2491 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2492
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2493 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2494
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2495
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2496 <directive name="underscores_in_headers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2497 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2498 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2499 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2500 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2501
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2502 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2503 Разрешает или запрещает использование символов подчёркивания в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2504 полях заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2505 Если запрещено, поля заголовка запроса, в чьих именах есть подчёркивания,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2506 помечаются как недопустимые и подпадают под действие директивы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2507 <link id="ignore_invalid_headers"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2508 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2509
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2510 <para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2511 Директива может быть указана на уровне <link id="server"/>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2512 в сервере по умолчанию.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2513 В этом случае её значение распространяется на все виртуальные серверы,
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2514 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2515 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2516
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2517 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2518
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2519
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2520 <directive name="variables_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2521 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2522 <default>64</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2523 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2524
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2525 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2526 Задаёт размер корзины в хэш-таблице переменных.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2527 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2528 <link doc="../hash.xml">настройке хэшей</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2529 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2530
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2531 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2532
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2533
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2534 <directive name="variables_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2535 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2536 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2537 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2538
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2539 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2540 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2541 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2542 <link doc="../hash.xml">настройке хэшей</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2543 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2544
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2545 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2546
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2547 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2548
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2549
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2550 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2551
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2552 <para>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2553 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2554 переменные, имена которых совпадают с именами переменных веб-сервера Apache.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2555 Прежде всего, это переменные, представляющие из себя поля заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2556 запроса клиента, такие как <var>$http_user_agent</var>, <var>$http_cookie</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2557 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2558 Кроме того, есть и другие переменные:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2559 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2560
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2561 <tag-name><var>$arg_</var><value>имя</value></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2562 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2563 аргумент <value>имя</value> в строке запроса
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2564 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2565
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2566 <tag-name><var>$args</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2567 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2568 аргументы в строке запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2569 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2570
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2571 <tag-name><var>$binary_remote_addr</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2572 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2573 адрес клиента в бинарном виде, длина значения всегда 4 байта
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2574 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2575
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2576 <tag-name><var>$body_bytes_sent</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2577 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2578 число байт, переданное клиенту, без учёта заголовка ответа
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2579 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2580
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2581 <tag-name><var>$content_length</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2582 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2583 поле <header>Content-Length</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2584 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2585
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2586 <tag-name><var>$content_type</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2587 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2588 поле <header>Content-Type</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2589 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2590
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2591 <tag-name><var>$cookie_</var><value>имя</value></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2592 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2593 cookie <value>имя</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2594 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2595
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2596 <tag-name><var>$document_root</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2597 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2598 значение директивы <link id="root"/> или <link id="alias"/>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2599 для текущего запроса
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2600 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2601
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2602 <tag-name><var>$document_uri</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2603 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2604 то же, что и <var>$uri</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2605 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2606
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2607 <tag-name><var>$host</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2608 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2609 поле <header>Host</header> заголовка запроса,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2610 или имя сервера, соответствующего запросу, если этого поля нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2611 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2612
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2613 <tag-name><var>$hostname</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2614 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2615 имя хоста
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2616 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2617
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2618 <tag-name><var>$http_</var><value>имя</value></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2619 <tag-desc>
448
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2620 произвольное поле заголовка запроса;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2621 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2622 к нижнему регистру, с заменой символов тире на символы подчёркивания
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2623 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2624
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2625 <tag-name><var>$https</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2626 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2627 “<literal>on</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2628 если соединение работает в режиме SSL,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2629 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2630 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2631
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2632 <tag-name><var>$is_args</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2633 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2634 “<literal>?</literal>”, если в строке запроса есть аргументы,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2635 и пустая строка, если их нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2636 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2637
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2638 <tag-name><var>$limit_rate</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2639 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2640 позволяет ограничивать скорость соединения
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2641 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2642
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2643 <tag-name><var>$nginx_version</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2644 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2645 версия nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2646 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2647
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2648 <tag-name><var>$pid</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2649 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2650 номер (PID) рабочего процесса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2651 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2652
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2653 <tag-name><var>$query_string</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2654 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2655 то же, что и <var>$args</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2656 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2657
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2658 <tag-name><var>$realpath_root</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2659 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2660 абсолютный путь, соответствующий
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2661 значению директивы <link id="root"/> или <link id="alias"/>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2662 для текущего запроса,
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2663 в котором все символические ссылки преобразованы в реальные пути
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2664 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2665
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2666 <tag-name><var>$remote_addr</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2667 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2668 адрес клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2669 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2670
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2671 <tag-name><var>$remote_port</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2672 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2673 порт клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2674 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2675
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2676 <tag-name><var>$remote_user</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2677 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2678 имя пользователя, использованное в Basic аутентификации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2679 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2680
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2681 <tag-name><var>$request</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2682 <tag-desc>
431
0412333658fe Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents: 429
diff changeset
2683 первоначальная строка запроса целиком
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2684 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2685
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2686 <tag-name><var>$request_body</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2687 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2688 тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2689 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2690 Значение переменной появляется в location'ах, обрабатываемых
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2691 директивами
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
2692 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2693 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2694 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2695 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2696 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2697
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2698 <tag-name><var>$request_body_file</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2699 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2700 имя временного файла, в котором хранится тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2701 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2702 По завершению обработки файл необходимо удалить.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2703 Для того, чтобы тело запроса всегда записывалось в файл,
406
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
2704 следует включить <link id="client_body_in_file_only"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2705 При передаче имени временного файла в проксированном запросе
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2706 или в запросе к FastCGI-серверу следует запретить передачу самого
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2707 тела директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2708 <link doc="ngx_http_proxy_module.xml" id="proxy_pass_request_body">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2709 proxy_pass_request_body off</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2710 или
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2711 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass_request_body">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2712 fastcgi_pass_request_body off</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2713 соответственно.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2714 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2715 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2716
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2717 <tag-name><var>$request_completion</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2718 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2719 “<literal>OK</literal>” если запрос завершился,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2720 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2721 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2722
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2723 <tag-name><var>$request_filename</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2724 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2725 путь к файлу для текущего запроса, формируемый из директив
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2726 <link id="root"/> или <link id="alias"/> и URI запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2727 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2728
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2729 <tag-name><var>$request_method</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2730 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2731 метод запроса, обычно
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2732 “<literal>GET</literal>” или “<literal>POST</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2733 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2734
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2735 <tag-name><var>$request_uri</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2736 <tag-desc>
431
0412333658fe Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents: 429
diff changeset
2737 первоначальный URI запроса целиком (с аргументами)
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2738 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2739
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2740 <tag-name><var>$scheme</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2741 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2742 схема запроса, “<literal>http</literal>” или “<literal>https</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2743 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2744
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2745 <tag-name><var>$sent_http_</var><value>имя</value></tag-name>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2746 <tag-desc>
448
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2747 произвольное поле заголовка ответа;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2748 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2749 к нижнему регистру, с заменой символов тире на символы подчёркивания
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2750 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2751
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2752 <tag-name><var>$server_addr</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2753 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2754 адрес сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2755 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2756 Получение значения этой переменной обычно требует одного системного вызова.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2757 Чтобы избежать системного вызова, в директивах <link id="listen"/>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2758 следует указывать адреса и использовать параметр <literal>bind</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2759 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2760 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2761
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2762 <tag-name><var>$server_name</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2763 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2764 имя сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2765 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2766
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2767 <tag-name><var>$server_port</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2768 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2769 порт сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2770 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2771
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2772 <tag-name><var>$server_protocol</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2773 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2774 протокол сервера, обычно
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2775 “<literal>HTTP/1.0</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2776 или
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2777 “<literal>HTTP/1.1</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2778 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2779
453
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2780 <tag-name>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2781 <var>$tcpinfo_rtt</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2782 <var>$tcpinfo_rttvar</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2783 <var>$tcpinfo_snd_cwnd</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2784 <var>$tcpinfo_rcv_space</var>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2785 </tag-name>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2786 <tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2787 информация о клиентском TCP-соединении; доступна на системах,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2788 поддерживающих опцию сокета <c-def>TCP_INFO</c-def>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2789 </tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
2790
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2791 <tag-name><var>$uri</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2792 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2793 текущий URI запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2794 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2795 Он может отличаться от первоначального, например, при внутренних
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2796 перенаправлениях или при использовании индексных файлов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2797 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2798 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2799
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2800 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2801 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2802
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2803 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2804
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2805 </module>