Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_core_module.xml @ 659:77a3314c74a7
Avoid the uses of second person.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 28 Aug 2012 09:23:40 +0000 |
parents | eba81bfb6aaf |
children | c48c0936b4df |
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 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
576
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
576
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
576
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
576
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
576
diff
changeset
|
7 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
9 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
10 <module name="Модуль ngx_http_core_module" |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 link="/ru/docs/http/ngx_http_core_module.html" |
589 | 12 lang="ru" |
651
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
13 rev="3"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
14 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
15 <section id="directives" name="Директивы"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
16 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
17 <directive name="aio"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
18 <syntax> |
364 | 19 <literal>on</literal> | |
20 <literal>off</literal> | | |
21 <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
|
22 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
23 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
24 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
25 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
26 <appeared-in>0.8.11</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
27 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
28 <para> |
253
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 во FreeBSD и Linux. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
31 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
32 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
33 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
34 Во FreeBSD AIO можно использовать, начиная с FreeBSD 4.3. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
35 AIO можно либо собрать в ядре статически: |
76
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 options VFS_AIO |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
39 либо загрузить динамически через загружаемый модуль ядра: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
40 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 kldload aio |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
42 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
43 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
44 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
45 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
46 В версиях FreeBSD 5 и 6 включение AIO статически или динамически |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
47 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
48 будет использовать блокировку Giant, что может негативно сказаться на |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
49 производительности системы в целом. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
50 Это ограничение устранено во FreeBSD 6.4-STABLE в 2009 году |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
51 и во FreeBSD 7. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
52 Однако, начиная с FreeBSD 5.3 есть возможность включать AIO, |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
53 не связывая сетевую подсистему блокировкой Giant — для этого модуль |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
54 AIO нужно подгружать уже после загрузки ядра. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
55 В этом случае в <path>/var/log/messages</path> появится следующее сообщение: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
56 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
57 WARNING: Network stack Giant-free, but aio requires Giant. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
58 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
59 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
60 которое можно смело проигнорировать. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
61 <note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
62 Требование использовать блокировку Giant в AIO связано с тем, что |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
63 FreeBSD поддерживает асинхронные вызовы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
64 <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
|
65 и |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
66 <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
|
67 для работы с сокетами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
68 Но поскольку nginx использует AIO только для работы с диском, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
69 то проблем не возникает. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 </note> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
71 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
72 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
73 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
74 Для работы AIO нужно выключить |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
75 <link id="sendfile"/>: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
76 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
77 location /video/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
78 sendfile off; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
79 aio on; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
80 output_buffers 1 64k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
81 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
82 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
83 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
84 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
85 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
86 Кроме того, начиная с FreeBSD 5.2.1 и nginx 0.8.12, AIO также можно |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
87 использовать для подгрузки данных для <c-func>sendfile</c-func>: |
76
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 location /video/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
90 sendfile on; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
91 tcp_nopush on; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
92 aio sendfile; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
93 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
94 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
95 В такой конфигурации функция <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
|
96 <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
|
97 сообщает об отсутствии данных в памяти, после чего nginx инициирует |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
98 асинхронную подгрузку данных, читая только один байт. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
99 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
100 при последующих чтениях файл подгружается частями только по 16K. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
101 Изменить это можно с помощью директивы |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
102 <link id="read_ahead"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
103 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
105 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
106 В 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
|
107 кроме того, ещё необходимо дополнительно включать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
108 <link id="directio"/>, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
109 иначе чтение будет блокирующимся: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
110 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
111 location /video/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
112 aio on; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
113 directio 512; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
114 output_buffers 1 128k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
115 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
116 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
117 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
118 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
119 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
120 Поскольку |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
121 <link id="directio"/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
122 в Linux можно использовать только для чтения блоков, выравненных |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
123 на границу 512 байт (или 4К для XFS), то невыравненный конец файла |
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 То же относится к запросам с указанием диапазона запрашиваемых байт |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
126 (byte-range requests) и к запросам FLV не с начала файла: чтение |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
127 невыравненных начала и конца ответа будет блокирующимся. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
128 Явно выключать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
129 <link id="sendfile"/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
130 не нужно, так как при использовании |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
131 <link id="directio"/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
132 он выключается автоматически. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
133 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
134 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
135 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
138 <directive name="alias"> |
271 | 139 <syntax><value>путь</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
140 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
141 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
142 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
143 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
144 Задаёт замену для указанного location’а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
145 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
146 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
147 location /i/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
148 alias /data/w3/images/; |
76
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 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
151 на запрос |
271 | 152 “<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
|
153 <path>/data/w3/images/top.gif</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
154 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
155 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
156 <para> |
271 | 157 В значении параметра <value>путь</value> можно использовать переменные, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
158 кроме <var>$document_root</var> и <var>$realpath_root</var>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
159 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
160 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
161 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
162 Если <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
|
163 регулярным выражением, то регулярное выражение должно содержать |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
164 выделения, а сам <literal>alias</literal> — ссылки на эти выделения |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
165 (0.7.40), например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
166 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
167 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
|
168 alias /data/w3/images/$1; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
169 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
170 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
171 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
172 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
173 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
174 Если location и последняя часть значения директивы совпадают: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
175 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
176 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
177 alias /data/w3/images/; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
178 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
179 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
180 то лучше воспользоваться директивой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
181 <link id="root"/>: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
182 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
183 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
184 root /data/w3; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
185 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
186 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
187 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
188 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
189 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
190 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
191 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
192 <directive name="chunked_transfer_encoding"> |
271 | 193 <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
|
194 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
195 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
196 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
197 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
198 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
199 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
200 Позволяет запретить формат передачи данных частями (chunked transfer |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
201 encoding) в HTTP/1.1. |
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 chunked encoding, несмотря на требования стандарта. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
204 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
205 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
206 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
207 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
208 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
209 <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
|
210 |
271 | 211 <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
|
212 <default>8k|16k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
213 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
214 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
215 <context>location</context> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
218 Задаёт размер буфера для чтения тела запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
219 Если тело запроса больше заданного буфера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
220 то всё тело запроса или только его часть записывается во |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
221 <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
|
222 По умолчанию размер одного буфера равен двум размерам страницы. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
223 На 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
|
224 На других 64-битных платформах это обычно 16K. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
225 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
226 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
227 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
228 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
229 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
230 <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
|
231 <syntax> |
364 | 232 <literal>on</literal> | |
233 <literal>clean</literal> | | |
234 <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
|
235 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
236 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
237 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
238 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
239 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
240 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
241 Определяет, сохранять ли всё тело запроса клиента в файл. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
242 Директиву можно использовать для отладки и при использовании переменной |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
243 <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
|
244 или метода |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
245 <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
|
246 модуля |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
247 <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
|
248 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
249 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
250 <para> |
271 | 251 При установке значения <literal>on</literal> временные файлы |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
252 по окончании обработки запроса не удаляются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
253 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
254 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
255 <para> |
271 | 256 Значение <literal>clean</literal> разрешает удалять временные файлы, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
257 оставшиеся по окончании обработки запроса. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
258 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
259 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
260 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
261 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
262 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
263 <directive name="client_body_in_single_buffer"> |
271 | 264 <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
|
265 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
266 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
267 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
268 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
269 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
270 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
271 Определяет, сохранять ли всё тело запроса клиента в одном буфере. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
272 Директива рекомендуется при использовании переменной |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
273 <var>$request_body</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
274 для уменьшения требуемого числа операций копирования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
275 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
276 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
277 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
278 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
279 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
280 <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
|
281 <syntax> |
364 | 282 <value>путь</value> |
283 [<value>уровень1</value> | |
284 [<value>уровень2</value> | |
285 [<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
|
286 <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
|
287 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
288 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
289 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
290 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
291 <para> |
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 В каталоге может использоваться иерархия подкаталогов до трёх уровней. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
294 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
295 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
296 client_body_temp_path /spool/nginx/client_temp 1 2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
297 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
298 временный файл будет следующего вида: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
299 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
300 /spool/nginx/client_temp/7/45/00000123457 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
301 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
302 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
303 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
304 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
305 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
306 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
307 <directive name="client_body_timeout"> |
271 | 308 <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
|
309 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
310 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
311 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
312 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
313 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
314 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
315 Задаёт таймаут при чтении тела запроса клиента. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
316 Таймаут устанавливается не на всю передачу тела запроса, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
317 а только между двумя последовательными операциями чтения. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
318 Если по истечении этого времени клиент ничего не передаст, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
319 то клиенту возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
320 <http-status code="408" text="Request Time-out"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
321 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
322 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
323 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
324 |
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 <directive name="client_header_buffer_size"> |
271 | 327 <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
|
328 <default>1k</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
329 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
330 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
331 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
332 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
333 Задаёт размер буфера для чтения заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
334 Для большинства запросов достаточно буфера размером в 1K байт. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
335 Однако если в запросе есть длинные cookies, или же запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
336 пришёл от WAP-клиента, то он может не поместиться в 1K. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
337 Поэтому, если строка запроса или поле заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
338 не помещаются полностью в этот буфер, то выделяются буферы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
339 большего размера, задаваемые директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
340 <link id="large_client_header_buffers"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
341 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
342 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
343 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
344 |
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 <directive name="client_header_timeout"> |
271 | 347 <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
|
348 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
349 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
350 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
351 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
352 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
353 Задаёт таймаут при чтении заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
354 Если по истечении этого времени клиент не передаст полностью заголовок, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
355 то клиенту возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
356 <http-status code="408" text="Request Time-out"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
357 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
358 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
359 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
360 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
361 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
362 <directive name="client_max_body_size"> |
271 | 363 <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
|
364 <default>1m</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
365 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
366 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
367 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
368 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
369 <para> |
253
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 указываемый в поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
372 <header>Content-Length</header> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
373 заголовка запроса. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
374 Если размер больше заданного, то клиенту возвращается ошибка |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
375 <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
|
376 Следует иметь в виду, что |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
377 <!--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
|
378 эту ошибку<!--/link-->. |
271 | 379 Установка параметра <value>размер</value> в 0 отключает |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
380 проверку размера тела запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
381 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
382 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
383 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
384 |
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 <directive name="connection_pool_size"> |
271 | 387 <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
|
388 <default>256</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
389 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
390 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
391 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
392 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
393 Позволяет производить точную настройку выделений памяти |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
394 под конкретные соединения. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
395 Эта директива не оказывает существенного влияния на |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
396 производительность и её не следует использовать. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
397 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
398 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
399 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
400 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
401 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
402 <directive name="default_type"> |
271 | 403 <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
|
404 <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
|
405 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
406 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
407 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
408 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
409 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
410 Задаёт MIME-тип ответов по умолчанию. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
411 Соответствие расширений имён файлов MIME-типу ответов задаётся |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
412 с помощью директивы <link id="types"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
413 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
414 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
415 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
416 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
417 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
418 <directive name="directio"> |
271 | 419 <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
|
420 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
421 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
422 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
423 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
424 <appeared-in>0.7.7</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
425 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
426 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
427 Разрешает использовать флаги |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
428 <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
|
429 <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
|
430 или функцию <c-func>directio</c-func> (Solaris) |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
431 при чтении файлов, размер которых больше либо равен указанному. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
432 Директива автоматически запрещает (0.7.15) использование |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
433 <link id="sendfile"/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
434 для данного запроса. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
435 Рекомендуется использовать для больших файлов: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
436 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
437 directio 4m; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
438 </example> |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
439 или при использовании <link id="aio"/> в Linux. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
440 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
441 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
442 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
443 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
444 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
445 <directive name="directio_alignment"> |
271 | 446 <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
|
447 <default>512</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
448 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
449 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
450 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
451 <appeared-in>0.8.11</appeared-in> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
454 Устанавливает выравнивание для |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
455 <link id="directio"/>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
456 В большинстве случаев достаточно 512-байтового выравнивания, однако |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
457 при использовании XFS под Linux его нужно увеличить до 4K. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
458 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
459 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
460 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
461 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
462 |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
463 <directive name="disable_symlinks"> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
464 <syntax><literal>off</literal></syntax> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
465 <syntax> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
466 <literal>on</literal> | |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
467 <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
|
468 [<literal>from</literal>=<value>часть</value>]</syntax> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
469 <default>off</default> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
470 <context>http</context> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
471 <context>server</context> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
472 <context>location</context> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
473 <appeared-in>1.1.15</appeared-in> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
474 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
475 <para> |
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 при открытии файлов: |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
478 <list type="tag"> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
479 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
480 <tag-name><literal>off</literal></tag-name> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
481 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
482 Символические ссылки в пути допускаются и не проверяются. |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
483 Это стандартное поведение. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
484 </tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
485 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
486 <tag-name><literal>on</literal></tag-name> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
487 <tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
488 Если любой компонент пути является символической ссылкой, |
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 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
492 <tag-name><literal>if_not_owner</literal></tag-name> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
493 <tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
494 Доступ к файлу запрещается, если любой компонент пути |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
495 является символической ссылкой, а ссылка и объект, на |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
496 который она ссылается, имеют разных владельцев. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
497 </tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
498 |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
499 <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
|
500 <tag-desc> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
501 При проверке символических ссылок |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
502 (параметры <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
|
503 обычно проверяются все компоненты пути. |
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 <literal>from</literal>=<value>часть</value>. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
507 В этом случае символические ссылки проверяются лишь начиная |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
508 с компонента пути, который следует за заданной начальной частью. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
509 Если значение не является начальной частью проверяемого пути, |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
510 путь проверяется целиком, как если бы этот параметр не был указан вовсе. |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
511 Если значение целиком совпадает с именем файла, |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
512 символические ссылки не проверяются. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
513 В значении параметра можно использовать переменные. |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
514 </tag-desc> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
515 |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
516 </list> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
517 </para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
518 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
519 <para> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
520 Пример: |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
521 <example> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
522 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
|
523 </example> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
524 </para> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
525 |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
526 <para> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
527 Эта директива доступна только на системах, в которых есть |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
528 интерфейсы <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
|
529 К таким системам относятся современные версии FreeBSD, Linux и Solaris. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
530 </para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
531 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
532 <para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
533 Параметры <literal>on</literal> и <literal>if_not_owner</literal> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
534 требуют дополнительных затрат на обработку. |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
535 <note> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
536 На системах, не поддерживающих операцию открытия каталогов только для поиска, |
438
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 имели право читать все проверяемые каталоги. |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
539 </note> |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
540 </para> |
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 <para> |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
543 <note> |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
544 Модули |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
545 <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
|
546 <link doc="ngx_http_random_index_module.xml">ngx_http_random_index_module</link> |
477
c5680571ec09
Unnecessary extensions removed from links.
Andrey Belov <defan@nginx.com>
parents:
476
diff
changeset
|
547 и <link doc="ngx_http_dav_module.xml">ngx_http_dav_module</link> |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
548 в настоящий момент игнорируют эту директиву. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
549 </note> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
550 </para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
551 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
552 </directive> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
553 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
554 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
555 <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
|
556 <syntax> |
364 | 557 <value>код</value> ... |
558 [<literal>=</literal>[<value>ответ</value>]] | |
559 <value>uri</value></syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
560 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
561 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
562 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
563 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
564 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
565 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
566 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
567 Задаёт URI, который будет показываться для указанных ошибок. |
271 | 568 Директивы <literal>error_page</literal> наследуются с предыдущего уровня |
569 при условии, что на данном уровне не описаны свои директивы | |
570 <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
|
571 В значении URI можно использовать переменные. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
572 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
573 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
574 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
575 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
576 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
577 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
|
578 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
|
579 error_page 403 http://example.com/forbidden.html; |
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 Кроме того, можно поменять код ответа на другой, например: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
585 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
586 error_page 404 =200 /empty.gif; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
587 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
588 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
589 |
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 Если ошибочный ответ обрабатывается проксированным сервером или |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
592 FastCGI-сервером, и этот сервер может вернуть разные коды ответов, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
593 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
594 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
595 error_page 404 = /404.php; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
596 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
597 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
600 Если при перенаправлении не нужно менять URI, то можно перенаправить |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
601 обработку ошибки в именованный location: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
602 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
603 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
604 error_page 404 = @fallback; |
76
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
607 location @fallback { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
608 proxy_pass http://backend; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
609 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
610 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
611 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
612 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
613 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
614 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
615 |
576
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
616 <directive name="etag"> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
617 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
618 <default>on</default> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
619 <context>http</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
620 <context>server</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
621 <context>location</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
622 <appeared-in>1.3.3</appeared-in> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
623 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
624 <para> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
625 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
626 заголовка ответа для статических ресурсов. |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
627 </para> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
628 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
629 </directive> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
630 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
631 |
651
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
632 <directive name="http"> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
633 <syntax block="yes"/> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
634 <default/> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
635 <context>main</context> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
636 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
637 <para> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
638 Предоставляет контекст конфигурационного файла, в котором указываются |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
639 директивы HTTP-сервера. |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
640 </para> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
641 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
642 </directive> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
643 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
644 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
645 <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
|
646 <syntax> |
364 | 647 <literal>off</literal> | |
648 <literal>exact</literal> | | |
649 <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
|
650 <default>exact</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
651 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
652 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
653 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
654 <appeared-in>0.7.24</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
655 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
656 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
657 Определяет, как сравнивать время модификации ответа с |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
658 временем в поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
659 <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
|
660 заголовка запроса: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
661 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
662 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
663 |
271 | 664 <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
|
665 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
666 не проверять поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
667 <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
|
668 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
669 |
271 | 670 <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
|
671 <tag-desc> |
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 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
674 |
271 | 675 <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
|
676 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
677 время модификации ответа меньше или равно времени, заданному в поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
678 <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
|
679 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
680 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
681 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
682 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
683 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
684 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
685 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
686 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
687 <directive name="ignore_invalid_headers"> |
271 | 688 <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
|
689 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
690 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
691 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
692 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
693 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
694 Если включено, nginx игнорирует поля заголовка с недопустимыми именами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
695 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
696 и возможно знаков подчёркивания (последнее контролируется директивой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
697 <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
|
698 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
699 |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
700 <para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
701 Директива может быть указана на уровне <link id="server"/> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
702 в сервере по умолчанию. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
703 В этом случае её значение распространяется на все виртуальные серверы, |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
704 слушающие на том же адресе и порту. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
705 </para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
706 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
707 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
708 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
709 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
710 <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
|
711 <syntax/> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
712 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
713 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
714 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
715 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
716 Указывает, что location может использоваться только для внутренних запросов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
717 Для внешних запросов клиенту будет возвращаться ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
718 <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
|
719 Внутренними запросами являются: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
720 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
721 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
722 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
723 <listitem> |
429
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
724 запросы, перенаправленные директивами |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
725 <link id="error_page"/>, |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
726 <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
|
727 <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
|
728 <link id="try_files"/>; |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
729 </listitem> |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
730 |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
731 <listitem> |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
732 запросы, перенаправленные с помощью поля |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
733 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
735 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
736 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
737 подзапросы, формируемые командой |
271 | 738 “<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
|
739 модуля |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
740 <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
|
741 и директивами модуля |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
742 <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
|
743 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
744 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
745 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
746 запросы, изменённые директивой |
429
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
747 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
748 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
749 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
750 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
751 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
752 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
753 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
754 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
755 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
756 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
|
757 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
758 location /404.html { |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
759 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
760 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
761 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
762 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
763 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
764 </directive> |
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 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
767 <directive name="keepalive_disable"> |
271 | 768 <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
|
769 <default>msie6</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
770 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
771 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
772 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
773 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
774 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
775 Запрещает keep-alive соединения с некорректно ведущими себя браузерами. |
271 | 776 Параметры <value>браузер</value> указывают, на какие браузеры это |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
777 распространяется. |
271 | 778 Значение <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
|
779 со старыми версиями MSIE после получения запроса POST. |
271 | 780 Значение <literal>safari</literal> запрещает keep-alive соединения |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
781 с Safari и подобными им браузерами на Mac OS X и подобных ей ОС. |
271 | 782 Значение <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
|
783 со всеми браузерами. |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
784 <note> |
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
785 До версии 1.1.18 под значение <literal>safari</literal> подпадали |
549 | 786 все Safari и подобные им браузеры на всех ОС, и keep-alive |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
787 соединения с ними были по умолчанию запрещены. |
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
788 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
789 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
790 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
791 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
792 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
793 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
794 <directive name="keepalive_requests"> |
271 | 795 <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
|
796 <default>100</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
797 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
798 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
799 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
800 <appeared-in>0.8.0</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
801 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
802 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
803 Задаёт максимальное число запросов, которые можно |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
804 сделать по одному keep-alive соединению. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
805 После того, как будет сделано максимальное число запросов, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
806 соединение закрывается. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
807 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
808 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
809 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
810 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
811 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
812 <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
|
813 <syntax> |
364 | 814 <value>таймаут</value> |
815 [<value>заголовок_таймаута</value>]</syntax> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
816 <default>75s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
817 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
818 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
819 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
820 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
821 <para> |
271 | 822 Первый параметр задаёт таймаут, в течение которого keep-alive |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
823 соединение с клиентом не будет закрыто со стороны сервера. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
824 Второй необязательный параметр задаёт значение в поле |
271 | 825 <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
|
826 заголовка ответа. |
271 | 827 Два параметра могут отличаться друг от друга. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
828 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
829 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
830 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
831 Поле |
271 | 832 <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
|
833 заголовка понимают Mozilla и Konqueror. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
834 MSIE сам закрывает keep-alive соединение примерно через 60 секунд. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
835 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
836 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
837 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
838 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
839 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
840 <directive name="large_client_header_buffers"> |
271 | 841 <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
|
842 <default>4 8k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
843 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
844 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
845 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
846 <para> |
271 | 847 Задаёт максимальное <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
|
848 буферов для чтения большого заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
849 Строка запроса не должна превышать размера одного буфера, иначе клиенту |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
850 возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
851 <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
|
852 Поле заголовка запроса также не должно превышать размера одного буфера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
853 иначе клиенту возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
854 <http-status code="400" text="Bad Request"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
855 Буферы выделяются только по мере необходимости. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
856 По умолчанию размер одного буфера равен 8K байт. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
857 Если по окончании обработки запроса соединение переходит в состояние |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
858 keep-alive, эти буферы освобождаются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
859 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
860 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
861 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
862 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
863 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
864 <directive name="limit_except"> |
271 | 865 <syntax block="yes"><value>метод</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
866 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
867 <context>location</context> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
870 Ограничивает HTTP-методы, доступные внутри location. |
271 | 871 Параметр <value>метод</value> может быть одним из |
872 <literal>GET</literal>, | |
873 <literal>HEAD</literal>, | |
874 <literal>POST</literal>, | |
875 <literal>PUT</literal>, | |
876 <literal>DELETE</literal>, | |
877 <literal>MKCOL</literal>, | |
878 <literal>COPY</literal>, | |
879 <literal>MOVE</literal>, | |
880 <literal>OPTIONS</literal>, | |
881 <literal>PROPFIND</literal>, | |
882 <literal>PROPPATCH</literal>, | |
883 <literal>LOCK</literal>, | |
884 <literal>UNLOCK</literal> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
885 или |
271 | 886 <literal>PATCH</literal>. |
887 Если разрешён метод <literal>GET</literal>, то метод | |
888 <literal>HEAD</literal> также будет разрешён. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
889 Доступ к остальным методам может быть ограничен при помощи директив модулей |
79
0a45870d0160
Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents:
76
diff
changeset
|
890 <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
|
891 и |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
892 <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
|
893 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
894 limit_except GET { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
895 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
|
896 deny all; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
897 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
898 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
899 Обратите внимание, что данное ограничение действует для всех методов, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
900 <emphasis>кроме</emphasis> GET и HEAD. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
901 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
904 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
905 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
906 <directive name="limit_rate"> |
271 | 907 <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
|
908 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
909 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
910 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
911 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
912 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
913 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
914 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
915 Ограничивает скорость передачи ответа клиенту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
916 Скорость задаётся в байтах в секунду. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
917 Значение 0 (установка по умолчанию) отключает ограничение скорости. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
918 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
919 Чем меньше скорость, тем более аккуратным будет ограничение. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
920 --> |
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 клиент откроет 2 соединения, то суммарная скорость будет в 2 раза |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
923 выше заданного ограничения. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
924 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
925 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
926 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
927 Если необходимо ограничить скорость для части клиентов на уровне |
271 | 928 <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
|
929 для этого не подходит. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
930 Вместо этого следует задать желаемое ограничение скорости в переменной |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
931 <var>$limit_rate</var>: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
932 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
933 server { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
934 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
935 if ($slow) { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
936 set $limit_rate 4k; |
76
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
939 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
940 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
941 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
942 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
943 |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
944 <para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
945 Кроме того, ограничение скорости может быть задано в поле |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
946 <header>X-Accel-Limit-Rate</header> заголовка ответа. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
947 Эту возможность можно запретить с помощью директив |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
948 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
949 и |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
950 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
951 </para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
952 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
953 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
954 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
955 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
956 <directive name="limit_rate_after"> |
271 | 957 <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
|
958 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
959 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
960 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
961 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
962 <context>if в location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
963 <appeared-in>0.8.0</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
964 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
965 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
966 Задаёт начальный объём данных, после передачи которого начинает |
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> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
969 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
970 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
971 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
972 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
973 location /flv/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
974 flv; |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
975 limit_rate_after 500k; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
976 limit_rate 50k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
977 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
978 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
979 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
980 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
981 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
982 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
983 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
984 <directive name="lingering_close"> |
271 | 985 <syntax> |
364 | 986 <literal>off</literal> | |
987 <literal>on</literal> | | |
988 <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
|
989 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
990 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
991 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
992 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
993 <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
|
994 <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
|
995 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
996 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
997 Управляет закрытием соединений с клиентами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
998 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
999 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1000 <para> |
271 | 1001 Со значением по умолчанию “<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
|
1002 <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
|
1003 <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
|
1004 поступающие от клиента, перед полным закрытием соединения, но только |
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 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1007 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1008 <para> |
271 | 1009 Со значением “<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
|
1010 ждать и обрабатывать дополнительные данные, поступающие от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1011 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1012 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1013 <para> |
271 | 1014 Со значением “<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
|
1015 дополнительных данных и сразу же закроет соединение. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1016 Это нарушает протокол, поэтому не следует это использовать без нужды. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1017 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1018 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1019 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1020 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1021 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1022 <directive name="lingering_time"> |
271 | 1023 <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
|
1024 <default>30s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1025 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1026 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1027 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1028 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1029 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1030 Если действует <link id="lingering_close"/>, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1031 эта директива задаёт максимальное время, в течение которого nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1032 будет обрабатывать (читать и игнорировать) дополнительные данные, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1033 поступающие от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1034 По прошествии этого времени соединение будет закрыто, даже если |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1035 будут ещё данные. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1036 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1037 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1038 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1039 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1040 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1041 <directive name="lingering_timeout"> |
271 | 1042 <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
|
1043 <default>5s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1044 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1045 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1046 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1047 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1048 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1049 Если действует <link id="lingering_close"/>, эта директива задаёт |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1050 максимальное время ожидания поступления дополнительных данных от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1051 Если в течение этого времени данные не были получены, соединение закрывается. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1052 Иначе данные читаются и игнорируются, затем nginx снова ждёт поступления данных. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1053 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1054 директивой <link id="lingering_time"/>. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1055 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1056 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1057 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1058 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1059 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1060 <directive name="listen"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1061 <syntax> |
364 | 1062 <value>адрес</value>[:<value>порт</value>] |
1063 [<literal>default_server</literal>] | |
1064 [<literal>setfib</literal>=<value>число</value>] | |
1065 [<literal>backlog</literal>=<value>число</value>] | |
1066 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1067 [<literal>sndbuf</literal>=<value>размер</value>] | |
1068 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1069 [<literal>deferred</literal>] | |
1070 [<literal>bind</literal>] | |
1071 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] | |
1072 [<literal>ssl</literal>] | |
1073 [<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
|
1074 <syntax> |
364 | 1075 <value>порт</value> |
1076 [<literal>default_server</literal>] | |
1077 [<literal>setfib</literal>=<value>число</value>] | |
1078 [<literal>backlog</literal>=<value>число</value>] | |
1079 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1080 [<literal>sndbuf</literal>=<value>размер</value>] | |
1081 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1082 [<literal>deferred</literal>] | |
1083 [<literal>bind</literal>] | |
1084 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] | |
1085 [<literal>ssl</literal>] | |
1086 [<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
|
1087 <syntax> |
364 | 1088 <literal>unix:</literal><value>путь</value> |
1089 [<literal>default_server</literal>] | |
1090 [<literal>backlog</literal>=<value>число</value>] | |
1091 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1092 [<literal>sndbuf</literal>=<value>размер</value>] | |
1093 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1094 [<literal>deferred</literal>] | |
1095 [<literal>bind</literal>] | |
1096 [<literal>ssl</literal>] | |
1097 [<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
|
1098 <default>*:80 | *:8000</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1099 <context>server</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1100 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1101 <para> |
271 | 1102 Задаёт <value>адрес</value> и <value>порт</value> для IP |
1103 или <value>путь</value> для UNIX-сокета, | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1104 на которых сервер будет принимать запросы. |
271 | 1105 Можно указать только <value>адрес</value> |
1106 или только <value>порт</value>. | |
1107 Кроме того, <value>адрес</value> может быть именем хоста, например: | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1108 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1109 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
|
1110 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
|
1111 listen 8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1112 listen *:8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1113 listen localhost:8000; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1114 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1115 IPv6-адреса (0.7.36) задаются в квадратных скобках: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1116 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1117 listen [::]:8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1118 listen [fe80::1]; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1119 </example> |
271 | 1120 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
|
1121 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1122 listen unix:/var/run/nginx.sock; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1123 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1124 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1125 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1126 <para> |
271 | 1127 Если указан только <value>адрес</value>, то используется порт 80. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1128 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1129 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1130 <para> |
271 | 1131 Если директива не указана, то используется либо <literal>*:80</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1132 (если nginx работает с привилегиями суперпользователя), |
271 | 1133 либо <literal>*:8000</literal>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1134 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1135 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1136 <para> |
271 | 1137 Если у директивы есть параметр <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
|
1138 в котором описана эта директива, будет сервером по умолчанию для указанной пары |
271 | 1139 <value>адрес</value>:<value>порт</value>. |
1140 Если же директив с параметром <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
|
1141 сервером по умолчанию будет первый сервер, в котором описана пара |
271 | 1142 <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
|
1143 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1144 До версии 0.8.21 этот параметр назывался просто |
271 | 1145 <literal>default</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1146 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1147 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1148 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1149 <para> |
271 | 1150 В директиве <literal>listen</literal> можно также указать несколько |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1151 дополнительных параметров, специфичных для связанных с сокетами |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1152 системных вызовов. |
271 | 1153 Эти параметры можно задать в любой директиве <literal>listen</literal>, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1154 но только один раз для указанной пары |
271 | 1155 <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
|
1156 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1157 До версии 0.8.21 их можно было указывать лишь в директиве |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1158 <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
|
1159 </note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1160 <list type="tag"> |
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 | 1163 <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
|
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> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1166 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1167 (параметр <c-def>SO_SETFIB</c-def>) для слушающего сокета. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1168 В настоящий момент это работает только на FreeBSD. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1169 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1170 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1171 <tag-name> |
271 | 1172 <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
|
1173 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1174 <tag-desc> |
271 | 1175 задаёт параметр <literal>backlog</literal> в вызове |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1176 <c-func>listen</c-func>, который ограничивает |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1177 максимальный размер очереди ожидающих приёма соединений. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1178 По умолчанию <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
|
1179 и 511 для других платформ. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1180 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1181 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1182 <tag-name> |
271 | 1183 <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
|
1184 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1185 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1186 задаёт размер буфера приёма |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1187 (параметр <c-def>SO_RCVBUF</c-def>) для слушающего сокета. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1188 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1189 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1190 <tag-name> |
271 | 1191 <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
|
1192 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1193 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1194 задаёт размер буфера передачи |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1195 (параметр <c-def>SO_SNDBUF</c-def>) для слушающего сокета. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1196 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1197 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1198 <tag-name> |
271 | 1199 <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
|
1200 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1201 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1202 задаёт название accept-фильтра |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1203 (параметр <c-def>SO_ACCEPTFILTER</c-def>) для слушающего сокета, |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1204 который включается для фильтрации входящих соединений |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1205 перед передачей их в <c-func>accept</c-func>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1206 Работает только на FreeBSD и NetBSD 5.0+. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1207 Можно использовать два фильтра — |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1208 <link url="http://man.freebsd.org/accf_data">dataready</link> |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1209 и |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1210 <link url="http://man.freebsd.org/accf_http">httpready</link>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1211 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1212 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1213 <tag-name> |
271 | 1214 <literal>deferred</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1215 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1216 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1217 указывает использовать отложенный <c-func>accept</c-func> |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1218 (параметр <c-def>TCP_DEFER_ACCEPT</c-def> сокета) на Linux. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1219 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1220 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1221 <tag-name> |
271 | 1222 <literal>bind</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1223 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1224 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1225 указывает, что для данной пары |
271 | 1226 <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
|
1227 <c-func>bind</c-func> отдельно. |
271 | 1228 Дело в том, что если описаны несколько директив <literal>listen</literal> |
629 | 1229 с одинаковым портом, но разными адресами, и одна из директив |
271 | 1230 <literal>listen</literal> слушает на всех адресах для данного порта |
629 | 1231 (<literal>*:</literal><value>порт</value>), то nginx сделает |
271 | 1232 <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
|
1233 Необходимо заметить, что в этом случае для определения адреса, на которой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1234 пришло соединение, делается системный вызов <c-func>getsockname</c-func>. |
271 | 1235 Если же используются параметры <literal>backlog</literal>, |
1236 <literal>rcvbuf</literal>, <literal>sndbuf</literal>, | |
1237 <literal>accept_filter</literal>, <literal>deferred</literal> | |
1238 или <literal>so_keepalive</literal>, то для данной пары | |
1239 <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
|
1240 отдельный вызов <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
|
1241 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1242 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1243 <tag-name> |
271 | 1244 <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
|
1245 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1246 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1247 этот параметр (0.7.42) определяет |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1248 (через параметр сокета <c-def>IPV6_V6ONLY</c-def>), |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1249 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1250 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения. |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1251 По умолчанию параметр включён. |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1252 Установить его можно только один раз на старте. |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1253 <note> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1254 До версии 1.3.4, |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1255 если этот параметр не был задан явно, то для сокета действовали |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1256 настройки операционной системы. |
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1257 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1258 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1259 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1260 <tag-name> |
271 | 1261 <literal>ssl</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1262 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1263 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1264 этот параметр (0.7.14) не имеет отношения к связанным с сокетами системным |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1265 вызовам, а позволяет указать, что все соединения, принимаемые на этом порту, |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1266 должны работать в режиме SSL. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1267 Это позволяет задать компактную <link doc="configuring_https_servers.xml" |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1268 id="single_http_https_server">конфигурацию</link> для сервера, |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1269 работающего сразу в двух режимах — HTTP и HTTPS. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1270 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1271 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1272 <tag-name> |
271 | 1273 <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
|
1274 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1275 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1276 этот параметр (1.1.11) конфигурирует для слушающего сокета |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1277 поведение “TCP keepalive”. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1278 Если этот параметр опущен, то для сокета будут действовать |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1279 настройки операционной системы. |
271 | 1280 Если он установлен в значение “<literal>on</literal>”, то для сокета |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1281 включается параметр <c-def>SO_KEEPALIVE</c-def>. |
271 | 1282 Если он установлен в значение “<literal>off</literal>”, то для сокета |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1283 параметр <c-def>SO_KEEPALIVE</c-def> выключается. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1284 Некоторые операционные системы поддерживают настройку параметров |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1285 “TCP keepalive” на уровне сокета посредством параметров |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1286 <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
|
1287 <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
|
1288 На таких системах (в настоящий момент это 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
|
1289 FreeBSD 9.0-STABLE) |
271 | 1290 их можно сконфигурировать с помощью параметров <value>keepidle</value>, |
1291 <value>keepintvl</value> и <value>keepcnt</value>. | |
1292 Один или два параметра могут быть опущены, в таком случае для | |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1293 соответствующего параметра сокета будут действовать стандартные |
253
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 Например, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1296 <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
|
1297 установит таймаут бездействия (<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
|
1298 для интервала проб (<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
|
1299 стандартная системная настройка, а счётчик проб (<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
|
1300 будет равен 10. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1301 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1302 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1303 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1304 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1305 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1306 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1307 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1308 <example> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1309 listen 127.0.0.1 default_server accept_filter=dataready backlog=1024; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1310 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1311 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1312 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1313 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1314 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1315 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1316 <directive name="location"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1317 <syntax block="yes">[ |
364 | 1318 <literal>=</literal> | |
1319 <literal>~</literal> | | |
1320 <literal>~*</literal> | | |
1321 <literal>^~</literal> | |
1322 ] <value>uri</value></syntax> | |
271 | 1323 <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
|
1324 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1325 <context>server</context> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1326 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1327 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1328 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1329 Устанавливает конфигурацию в зависимости от URI запроса. |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1330 </para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1331 |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1332 <para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1333 Для сопоставления используется URI запроса в нормализованном виде, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1334 после декодирования текста, заданного в виде “<literal>%XX</literal>”, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1335 преобразования относительных элементов пути “<literal>.</literal>” и |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1336 “<literal>..</literal>” в реальные, и возможной |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1337 <link id="merge_slashes">замены</link> двух и более подряд идущих |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1338 слэшей на один. |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1339 </para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1340 |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1341 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1342 location можно задать префиксной строкой или регулярным выражением. |
271 | 1343 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1344 (для поиска совпадения без учёта регистра символов), |
271 | 1345 либо с префиксом “<literal>~</literal>” (с учётом регистра). |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1346 Чтобы найти location, соответствующий запросу, вначале проверяются |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1347 location’ы, заданные префиксными строками (префиксные location’ы). |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1348 Среди них ищется максимальное совпадение. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1349 Затем проверяются регулярные выражения, в порядке их следования |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1350 в конфигурационном файле. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1351 Проверка регулярных выражений прекращается после первого же совпадения, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1352 и используется соответствующая конфигурация. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1353 Если совпадение с регулярным выражением не найдено, то используется |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1354 конфигурация максимально совпавшего префиксного location’а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1355 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1356 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1357 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1358 location’ы могут быть вложенными, с некоторыми исключениями, |
253
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 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1361 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1362 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1363 Для операционных систем, нечувствительных к регистру символов, таких |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1364 как Mac OS X и Cygwin, сравнение с префиксными строками производится |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1365 без учёта регистра (0.7.7). |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1366 Однако, сравнение ограничено только однобайтными locale’ями. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1367 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1368 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1369 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1370 Регулярные выражения могут содержать выделения (0.7.40), которые могут |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1371 затем использоваться в других директивах. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1372 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1373 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1374 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1375 Если у максимального совпавшего префиксного location’а указан префикс |
271 | 1376 “<literal>^~</literal>”, то регулярные выражения не проверяются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1377 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1378 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1379 <para> |
271 | 1380 Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1381 совпадение URI и location. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1382 При точном совпадении поиск сразу же прекращается. |
271 | 1383 Например, если запрос “<literal>/</literal>” случается часто, то |
1384 указав “<literal>location = /</literal>”, можно ускорить обработку | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1385 этих запросов, так как поиск прекратится после первого же сравнения. |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1386 Очевидно, что такой location не может иметь вложенные location’ы. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1387 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1388 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1389 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1390 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1391 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1392 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
|
1393 то поиск тоже сразу же прекращается и регулярные выражения также |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1394 не проверяются. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1395 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1396 </para> |
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 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1401 location = / { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1402 [ конфигурация А ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1403 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1404 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1405 location / { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1406 [ конфигурация Б ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1407 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1408 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1409 location ^~ /images/ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1410 [ конфигурация В ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1411 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1412 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1413 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
|
1414 [ конфигурация Г ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1415 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1416 </example> |
271 | 1417 Для запроса “<literal>/</literal>” будет выбрана конфигурация А, |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1418 для запроса “<literal>/documents/document.html</literal>” — конфигурация Б, |
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1419 для запроса “<literal>/images/1.gif</literal>” — конфигурация В, |
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1420 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Г. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1421 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1422 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1423 <para> |
271 | 1424 Префикс “<literal>@</literal>” задаёт именованный location. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1425 Такой location не используется при обычной обработке запросов, а |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1426 предназначен только для перенаправления в него запросов. |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1427 Такие location’ы не могут быть вложенными и не могут содержать |
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1428 вложенные location’ы. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1429 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1430 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1431 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1432 <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
|
1433 --> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1434 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1435 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1436 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1437 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1438 <directive name="log_not_found"> |
271 | 1439 <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
|
1440 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1441 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1442 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1443 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1444 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1445 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1446 Разрешает или запрещает записывать в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1447 <link doc="../ngx_core_module.xml" id="error_log"/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1448 ошибки о том, что файл не найден. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1449 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1450 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1451 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1452 |
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 <directive name="log_subrequest"> |
271 | 1455 <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
|
1456 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1457 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1458 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1459 <context>location</context> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1462 Разрешает или запрещает записывать в |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
1463 <link doc="ngx_http_log_module.xml" id="access_log"/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1464 подзапросы. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1465 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1466 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1467 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1468 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1469 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1470 <directive name="max_ranges"> |
271 | 1471 <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
|
1472 <default/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1473 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1474 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1475 <context>location</context> |
499
76a8eca844d0
Documented that "max_ranges" appeared in 1.1.2.
Ruslan Ermilov <ru@nginx.com>
parents:
477
diff
changeset
|
1476 <appeared-in>1.1.2</appeared-in> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1477 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1478 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1479 Ограничивает максимальное допустимое число диапазонов в запросах с |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1480 указанием диапазона запрашиваемых байт (byte-range requests). |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1481 Запросы, превышающие указанное ограничение, обрабатываются как |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1482 если бы они не содержали указания диапазонов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1483 По умолчанию ограничения нет. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1484 Значение 0 полностью запрещает поддержку диапазонов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1485 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1486 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1487 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1488 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1489 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1490 <directive name="merge_slashes"> |
271 | 1491 <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
|
1492 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1493 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1494 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1495 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1496 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1497 Разрешает или запрещает преобразование URI путём замены двух и более подряд |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1498 идущих слэшей (“<literal>/</literal>”) на один. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1499 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1500 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1501 <para> |
280 | 1502 Необходимо иметь в виду, что это преобразование необходимо для корректной |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1503 проверки префиксных строк и регулярных выражений. |
364 | 1504 Если его не делать, то запрос “<literal>//scripts/one.php</literal>” |
1505 не попадёт в | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1506 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1507 location /scripts/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1508 ... |
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 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1511 и может быть обслужен как статический файл. |
271 | 1512 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1513 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1514 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1515 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1516 Запрет преобразования может понадобиться, если в URI используются имена, |
271 | 1517 закодированные методом base64, в котором задействован символ |
1518 “<literal>/</literal>”. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1519 Однако по соображениям безопасности лучше избегать отключения преобразования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1520 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1521 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1522 <para> |
442
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1523 Директива может быть указана на уровне <link id="server"/> |
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1524 в сервере по умолчанию. |
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1525 В этом случае её значение распространяется на все виртуальные серверы, |
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1526 слушающие на том же адресе и порту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1527 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1528 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1529 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1530 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1531 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1532 <directive name="msie_padding"> |
271 | 1533 <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
|
1534 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1535 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1536 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1537 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1538 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1539 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1540 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1541 комментарий для увеличения размера ответа до 512 байт. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1542 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1543 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1544 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1545 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1546 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1547 <directive name="msie_refresh"> |
271 | 1548 <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
|
1549 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1550 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1551 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1552 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1553 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1554 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1555 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1556 перенаправлений. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1557 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1558 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1559 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1560 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1561 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1562 <directive name="open_file_cache"> |
271 | 1563 <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
|
1564 <syntax> |
271 | 1565 <literal>max</literal>=<value>N</value> |
1566 [<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
|
1567 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1568 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1569 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1570 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1571 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1572 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1573 Задаёт кэш, в котором могут храниться: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1574 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1575 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1576 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1577 дескрипторы открытых файлов, информация об их размерах и времени модификации; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1578 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1579 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1580 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1581 информация о существовании каталогов; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1582 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1583 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1584 <listitem> |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1585 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1586 и тому подобное. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1587 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1588 Кэширование ошибок нужно разрешить отдельно директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1589 <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
|
1590 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1591 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1592 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1593 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1594 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1595 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1596 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1597 У директивы есть следующие параметры: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1598 <list type="tag"> |
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 <tag-name> |
271 | 1601 <literal>max</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1602 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1603 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1604 задаёт максимальное число элементов в кэше; |
507 | 1605 при переполнении кэша удаляются наименее востребованные элементы (LRU); |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1606 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1607 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1608 <tag-name> |
271 | 1609 <literal>inactive</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1610 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1611 <tag-desc> |
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 не было обращений в течение этого времени; по умолчанию 60 секунд; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1614 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1615 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1616 <tag-name> |
271 | 1617 <literal>off</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1618 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1619 <tag-desc> |
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 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1622 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1623 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1624 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1625 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1626 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1627 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1628 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1629 open_file_cache max=1000 inactive=20s; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1630 open_file_cache_valid 30s; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1631 open_file_cache_min_uses 2; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1632 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
|
1633 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1634 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
|
1635 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1636 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1637 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1638 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1639 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1640 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1641 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1642 <directive name="open_file_cache_errors"> |
271 | 1643 <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
|
1644 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1645 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1646 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1647 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1648 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1649 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1650 Разрешает или запрещает кэширование ошибок поиска файлов в |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1651 <link id="open_file_cache"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1652 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1653 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1654 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1655 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1656 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1657 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1658 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1659 <directive name="open_file_cache_events"> |
271 | 1660 <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
|
1661 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1662 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1663 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1664 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1665 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1666 <para> |
253
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 <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
|
1669 Эта директива работает только совместно с методом |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1670 <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
|
1671 Заметьте, что только NetBSD 2.0+ и FreeBSD 6.0+ |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1672 поддерживают события для файловых систем произвольного типа. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1673 Другие операционные системы поддерживают события только для |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1674 основных файловых систем, таких как UFS или FFS. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1675 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1676 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1677 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1678 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1679 --> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1680 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1681 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1682 <directive name="open_file_cache_min_uses"> |
271 | 1683 <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
|
1684 <default>1</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1685 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1686 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1687 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1688 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1689 <para> |
271 | 1690 Задаёт минимальное <value>число</value> обращений к файлу |
1691 в течение времени, заданного параметром <literal>inactive</literal> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1692 директивы <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
|
1693 файла будет оставаться открытым в кэше. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1694 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1695 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1696 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1697 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1698 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1699 <directive name="open_file_cache_valid"> |
271 | 1700 <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
|
1701 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1702 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1703 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1704 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1705 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1706 <para> |
253
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 об элементе в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1709 <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
|
1710 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1711 При включенном |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1712 <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
|
1713 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1714 по факту их изменения. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1715 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1716 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1717 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1718 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1719 |
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 <directive name="optimize_server_names"> |
271 | 1722 <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
|
1723 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1724 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1725 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1726 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1727 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1728 Директива устарела, вместо неё следует использовать директиву |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1729 <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
|
1730 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1731 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1732 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1733 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1734 Разрешает или запрещает оптимизировать проверку имени хоста в name-based |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1735 виртуальных серверах. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1736 Проверка в частности влияет на имя хоста, используемого в перенаправлениях. |
381 | 1737 Если оптимизация разрешена и все name-based серверы, слушающие на одной |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1738 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1739 имена не проверяются и в перенаправлениях используется первое имя сервера. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1740 Если в перенаправлении нужно использовать имя хоста, переданное клиентом, |
76
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 </para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1743 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1744 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1745 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1746 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1747 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1748 <directive name="port_in_redirect"> |
271 | 1749 <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
|
1750 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1751 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1752 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1753 <context>location</context> |
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 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1756 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx’ом. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1757 </para> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1758 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1759 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
1760 Использование в перенаправлениях основного имени сервера управляется |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
1761 директивой <link id="server_name_in_redirect"/>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1762 </para> |
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 </directive> |
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 <directive name="postpone_output"> |
271 | 1768 <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
|
1769 <default>1460</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1770 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1771 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1772 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1773 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1774 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1775 Если это возможно, то отправка данных клиенту будет отложена пока nginx не |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1776 накопит по крайней мере указанное количество байт для отправки. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1777 Значение 0 запрещает отложенную отправку данных. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1778 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1779 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1780 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1781 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1782 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1783 <directive name="read_ahead"> |
271 | 1784 <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
|
1785 <default>0</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1786 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1787 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1788 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1789 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1790 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1791 Задаёт ядру размер предчтения при работе с файлами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1792 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1793 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1794 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1795 На Linux используется системный вызов |
271 | 1796 <literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>, |
1797 поэтому параметр <value>размер</value> там игнорируется. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1798 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1799 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1800 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1801 На FreeBSD используется системный вызов |
271 | 1802 <literal>fcntl(O_READAHEAD, |
1803 </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
|
1804 появившийся во FreeBSD 9.0-CURRENT. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1805 Для FreeBSD 7 необходимо установить |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1806 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1807 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1808 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1809 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1810 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1811 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1812 <directive name="recursive_error_pages"> |
271 | 1813 <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
|
1814 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1815 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1816 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1817 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1818 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1819 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1820 Разрешает или запрещает делать несколько перенаправлений через директиву |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1821 <link id="error_page"/>. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1822 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1823 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1824 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1827 <directive name="request_pool_size"> |
271 | 1828 <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
|
1829 <default>4k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1830 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1831 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1832 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1833 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1834 Позволяет производить точную настройку выделений памяти |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1835 под конкретные запросы. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1836 Эта директива не оказывает существенного влияния на |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1837 производительность и её не следует использовать. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1838 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1839 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1840 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1841 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1842 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1843 <directive name="reset_timedout_connection"> |
364 | 1844 <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
|
1845 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1846 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1847 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1848 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1849 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1850 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1851 Разрешает или запрещает сброс соединений по таймауту. |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1852 Сброс делается следующим образом — перед закрытием сокета для него |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1853 ставится параметр |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1854 <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
|
1855 с таймаутом 0. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1856 После чего при закрытии сокета клиенту отсылается TCP RST, а вся память, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1857 связанная с этим сокетом, освобождается. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1858 Это позволяет избежать длительного нахождения уже закрытого сокета в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1859 состоянии FIN_WAIT1 с заполненными буферами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1860 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1861 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1862 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1863 Необходимо отметить, что keep-alive соединения по истечении таймаута |
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 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1866 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1867 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1868 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1869 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1870 <directive name="resolver"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1871 <syntax> |
271 | 1872 <value>адрес</value> ... |
1873 [<literal>valid</literal>=<value>время</value>]</syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
1874 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1875 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1876 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1877 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1878 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1879 <para> |
318
4a0fe9283dc7
Word polishing in the description of the "server" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
280
diff
changeset
|
1880 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1881 в адреса, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1882 <example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1883 resolver 127.0.0.1 [::1]:5353; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1884 </example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1885 Адрес может быть указан в виде доменного имени или IP-адреса, |
566 | 1886 и необязательного порта (1.3.1, 1.2.2). |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1887 Если порт не указан, используется порт 53. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1888 Серверы DNS опрашиваются циклически. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1889 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1890 До версии 1.1.7 можно было задать лишь один DNS-сервер. |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1891 Задание DNS-серверов с помощью IPv6-адресов поддерживается |
566 | 1892 начиная с версий 1.3.1 и 1.2.2. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1893 </note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1894 По умолчанию nginx кэширует ответы, используя значение TTL из ответа. |
271 | 1895 Необязательный параметр <literal>valid</literal> позволяет это |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1896 переопределить: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1897 <example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1898 resolver 127.0.0.1 [::1]:5353 valid=30s; |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1899 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1900 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1901 До версии 1.1.9 настройка времени кэширования была невозможна |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1902 и nginx всегда кэшировал ответы на срок в 5 минут. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1903 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1904 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1905 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1906 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1907 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1908 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1909 <directive name="resolver_timeout"> |
271 | 1910 <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
|
1911 <default>30s</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1912 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1913 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1914 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1915 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1916 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1917 Задаёт таймаут для преобразования имени в адрес, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1918 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1919 resolver_timeout 5s; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1920 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1921 </para> |
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> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1924 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1925 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1926 <directive name="root"> |
271 | 1927 <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
|
1928 <default>html</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1929 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1930 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1931 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1932 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1933 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1934 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1935 Задаёт корневой каталог для запросов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1936 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1937 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1938 location /i/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1939 root /data/w3; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1940 } |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1941 </example> |
271 | 1942 в ответ на запрос “<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
|
1943 <path>/data/w3/i/top.gif</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1944 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1945 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1946 <para> |
271 | 1947 В значении параметра <value>путь</value> можно использовать переменные, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1948 кроме <var>$document_root</var> и <var>$realpath_root</var>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1949 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1950 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1951 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1952 Путь к файлу формируется путём простого добавления URI к значению директивы |
271 | 1953 <literal>root</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1954 Если же URI необходимо поменять, следует воспользоваться директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1955 <link id="alias"/>. |
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="satisfy"> |
271 | 1962 <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
|
1963 <default>all</default> |
253
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> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1966 <context>location</context> |
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> |
271 | 1969 Разрешает доступ, если оба (<literal>all</literal>) |
1970 или хотя бы один (<literal>any</literal>) из модулей | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1971 <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
|
1972 и <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
|
1973 разрешают доступ. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1974 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1975 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1976 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1977 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1978 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1979 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1980 satisfy any; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1981 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1982 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
|
1983 deny all; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1984 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1985 auth_basic "closed site"; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1986 auth_basic_user_file conf/htpasswd; |
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1989 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1990 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1991 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1992 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1993 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1994 <directive name="satisfy_any"> |
271 | 1995 <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
|
1996 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1997 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1998 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1999 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2000 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2001 <para> |
406
98dac2bd7598
Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents:
400
diff
changeset
|
2002 Эта директива была заменена параметром <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
|
2003 директивы <link id="satisfy"/>. |
253
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 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2009 <directive name="send_lowat"> |
271 | 2010 <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
|
2011 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2012 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2013 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2014 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2015 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2016 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2017 При установке в ненулевое значение nginx будет пытаться минимизировать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2018 число операций отправки на клиентских сокетах либо при помощи флага |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2019 <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
|
2020 <link doc="../events.xml" id="kqueue"/>, |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2021 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2022 с указанным размером. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2023 </para> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2026 Эта директива игнорируется на Linux, Solaris и Windows. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2027 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2028 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2029 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2032 <directive name="send_timeout"> |
271 | 2033 <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
|
2034 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2035 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2036 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2037 <context>location</context> |
76
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 Таймаут устанавливается не на всю передачу ответа, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2042 а только между двумя операциями записями. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2043 Если по истечении этого времени клиент ничего не примет, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2044 соединение будет закрыто. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2045 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2046 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2047 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2048 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2049 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2050 <directive name="sendfile"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2051 |
271 | 2052 <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
|
2053 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2054 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2055 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2056 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2057 <context>if в location</context> |
76
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> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2060 Разрешает или запрещает использовать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2061 <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
|
2062 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2063 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2064 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2065 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2066 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2067 <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
|
2068 |
271 | 2069 <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
|
2070 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2071 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2072 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2073 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2074 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2075 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2076 При установке в ненулевое значение ограничивает объём данных, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2077 который может передан за один вызов <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
|
2078 Без этого ограничения одно быстрое соединение может целиком |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2079 захватить рабочий процесс. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2080 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2081 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2082 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2083 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2084 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2085 <directive name="server"> |
108
72524ae53106
Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
2086 <syntax block="yes"/> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2087 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2088 <context>http</context> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2091 Задаёт конфигурацию для виртуального сервера. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2092 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса) |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2093 и 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
|
2094 Вместо этого директивами <link id="listen"/> описываются все |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2095 адреса и порты, на которых нужно принимать соединения для этого сервера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2096 а в директиве <link id="server_name"/> указываются все имена серверов. |
522
ef11546f75ee
Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
2097 Примеры конфигураций описаны в документе |
ef11546f75ee
Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
2098 “<link doc="request_processing.xml"/>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2099 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2102 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2103 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2104 <directive name="server_name"> |
271 | 2105 <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
|
2106 <default>""</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2107 <context>server</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2108 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2109 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2110 Задаёт имена виртуального сервера, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2111 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2112 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2113 server_name example.com www.example.com; |
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2116 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2117 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2118 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2119 Первое имя становится основным именем сервера. |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2120 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2121 |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2122 <para> |
271 | 2123 В именах серверов можно использовать звёздочку (“<literal>*</literal>”) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2124 для замены первой или последней части имени: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2125 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2126 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2127 server_name example.com *.example.com www.example.*; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2128 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2129 </example> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2130 Такие имена называются именами с маской. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2131 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2134 Два первых вышеприведённых имени можно объединить в одно: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2135 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2136 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2137 server_name .example.com; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2138 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2139 </example> |
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> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2143 В качестве имени сервера можно также использовать регулярное выражение, |
271 | 2144 указав перед ним тильду (“<literal>~</literal>”): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2145 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2146 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2147 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
|
2148 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2149 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2150 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2151 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2152 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2153 Регулярное выражение может содержать выделения (0.7.40), |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2154 которые могут затем использоваться в других директивах: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2155 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2156 server { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2157 server_name ~^(www\.)?(.+)$; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2158 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2159 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2160 root /sites/$2; |
76
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 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2163 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2164 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2165 server_name _; |
76
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 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2168 root /sites/default; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2169 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2170 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2171 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2172 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2173 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2174 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2175 Именованные выделения в регулярном выражении создают переменные (0.8.25), |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2176 которые могут затем использоваться в других директивах: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2177 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2178 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2179 server_name ~^(www\.)?(?<domain>.+)$; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2180 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2181 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2182 root /sites/$domain; |
76
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 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2185 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2186 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2187 server_name _; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2188 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2189 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2190 root /sites/default; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2191 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2192 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2193 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2194 </para> |
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> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2197 Если параметр равен “<var>$hostname</var>” (0.9.4), то |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2198 подставляется имя хоста (hostname) машины. |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2199 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2200 |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2201 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2202 Возможно также указать пустое имя сервера (0.7.11): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2203 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2204 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2205 server_name www.example.com ""; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2206 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2207 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2208 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2209 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт. |
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 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2212 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2213 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2214 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2215 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2216 <para> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2217 При поиске виртуального сервера по имени, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2218 если имени соответствует несколько из указанных вариантов, |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2219 например, одновременно подходят и имя с маской, и регулярное выражение, |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2220 будет выбран первый подходящий вариант в следующем порядке приоритета: |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2221 <list type="enum"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2222 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2223 <listitem> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2224 точное имя |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2225 </listitem> |
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 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2228 самое длинное имя с маской в начале, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2229 например “<literal>*.example.com</literal>” |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2230 </listitem> |
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 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2233 самое длинное имя с маской в конце, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2234 например “<literal>mail.*</literal>” |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2235 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2236 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2237 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2238 первое подходящее регулярное выражение |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2239 (в порядке следования в конфигурационном файле) |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2240 </listitem> |
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 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2243 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2244 |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2245 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2246 Подробнее имена серверов обсуждаются в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2247 <link doc="server_names.xml">документе</link>. |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2248 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2249 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2250 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2251 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2252 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2253 <directive name="server_name_in_redirect"> |
271 | 2254 <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
|
2255 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2256 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2257 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2258 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2259 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2260 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2261 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2262 основное имя сервера, задаваемое директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2263 <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
|
2264 Если запрещено, то используется имя, указанное в поле <header>Host</header> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2265 заголовка запроса. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2266 Если же этого поля нет, то используется IP-адрес сервера. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2267 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2268 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2269 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2270 Использование в перенаправлениях порта управляется |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2271 директивой <link id="port_in_redirect"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2272 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2275 |
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 name="server_names_hash_bucket_size"> |
271 | 2278 <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
|
2279 <default>32|64|128</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2280 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2281 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2282 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2283 Задаёт размер корзины в хэш-таблицах имён серверов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2284 Значение по умолчанию зависит от размера строки кэша процессора. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2285 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2286 <link doc="../hash.xml">документе</link>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2287 </para> |
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 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2290 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2291 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2292 <directive name="server_names_hash_max_size"> |
271 | 2293 <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
|
2294 <default>512</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2295 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2296 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2297 <para> |
271 | 2298 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2299 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2300 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2301 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2302 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2303 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2304 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2305 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2306 <directive name="server_tokens"> |
271 | 2307 <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
|
2308 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2309 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2310 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2311 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2312 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2313 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2314 Разрешает или запрещает выдавать версию nginx’а в сообщениях об ошибках и |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2315 в поле <header>Server</header> заголовка ответа. |
76
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2319 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2320 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2321 <directive name="tcp_nodelay"> |
271 | 2322 <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
|
2323 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2324 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2325 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2326 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2327 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2328 <para> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2329 Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2330 Параметр включаются только при переходе соединения в состояние keep-alive. |
76
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2334 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2335 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2336 <directive name="tcp_nopush"> |
271 | 2337 <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
|
2338 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2339 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2340 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2341 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2342 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2343 <para> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2344 Разрешает или запрещает использование параметра сокета |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2345 <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
|
2346 <c-def>TCP_CORK</c-def> в Linux. |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2347 Параметр включаются только при использовании <link id="sendfile"/>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2348 Включение параметра позволяет |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2349 <list type="bullet"> |
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 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2352 передавать заголовок ответа и начало файла в одном пакете |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2353 в Linux и во FreeBSD 4.*; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2354 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2355 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2356 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2357 передавать файл полными пакетами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2358 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2359 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2360 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2361 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2362 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2363 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2364 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2365 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2366 <directive name="try_files"> |
364 | 2367 <syntax><value>файл</value> ... <value>uri</value></syntax> |
2368 <syntax><value>файл</value> ... =<value>код</value></syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2369 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2370 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2371 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2372 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2373 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2374 Проверяет существование файлов в заданном порядке и использует |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2375 для обработки запроса первый найденный файл, причём обработка |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2376 делается в контексте этого же location’а. |
271 | 2377 Путь к файлу строится из параметра <value>файл</value> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2378 в соответствии с директивами |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2379 <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
|
2380 С помощью слэша в конце имени можно проверить существование каталога, |
271 | 2381 например, “<literal>$uri/</literal>”. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2382 В случае, если ни один файл не найден, то делается внутреннее |
271 | 2383 перенаправление на <value>uri</value>, заданный последним параметром. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2384 Например: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2385 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2386 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2387 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
|
2388 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2389 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2390 location = /images/default.gif { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2391 expires 30s; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2392 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2393 </example> |
271 | 2394 Последний параметр может также указывать на именованный location, |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2395 как в примерах ниже. |
271 | 2396 С версии 0.7.51 последний параметр может также быть кодом: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2397 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2398 location / { |
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 $uri/index.html $uri.html =404; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2400 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2401 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2402 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2403 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2404 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2405 Пример использования при проксировании Mongrel: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2406 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2407 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2408 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
|
2409 $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
|
2410 @mongrel; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2411 } |
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 location @mongrel { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2414 proxy_pass http://mongrel; |
76
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2417 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2420 Пример использования вместе с Drupal/FastCGI: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2421 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2422 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2423 try_files $uri $uri/ @drupal; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2424 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2425 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2426 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2427 try_files $uri @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2428 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2429 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2430 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2431 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
|
2432 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
|
2433 fastcgi_param QUERY_STRING $args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2434 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2435 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2436 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2437 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2438 location @drupal { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2439 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2440 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2441 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
|
2442 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
|
2443 fastcgi_param QUERY_STRING q=$uri&$args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2444 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2445 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2446 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2447 </example> |
271 | 2448 В следующем примере директива <literal>try_files</literal> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2449 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2450 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2451 try_files $uri $uri/ @drupal; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2452 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2453 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2454 аналогична директивам |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2455 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2456 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2457 error_page 404 = @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2458 log_not_found off; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2459 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2460 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2461 А здесь |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2462 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2463 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2464 try_files $uri @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2465 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2466 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2467 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2468 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2469 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2470 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2471 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2472 </example> |
271 | 2473 <literal>try_files</literal> проверяет существование PHP-файла, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2474 прежде чем передать запрос FastCGI-серверу. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2475 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2476 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2477 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2478 Пример использования вместе с Wordpress и Joomla: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2479 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2480 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2481 try_files $uri $uri/ @wordpress; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2482 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2483 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2484 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2485 try_files $uri @wordpress; |
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 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2488 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2489 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2490 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2491 } |
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 location @wordpress { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2494 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2495 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2496 fastcgi_param SCRIPT_FILENAME /path/to/index.php; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2497 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2498 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2499 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2500 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2503 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2504 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2505 <directive name="types"> |
108
72524ae53106
Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
2506 <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
|
2507 <default> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2508 text/html html; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2509 image/gif gif; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2510 image/jpeg jpg; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2511 </default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2512 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2513 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2514 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2515 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2516 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2517 Задаёт соответствие расширений имён файлов и MIME-типов ответов. |
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 Одному MIME-типу может соответствовать несколько расширений, например: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2520 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2521 types { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2522 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
|
2523 application/octet-stream deb; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2524 application/octet-stream dmg; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2525 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2526 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2527 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2528 |
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 Достаточно полная таблица соответствий входит в дистрибутив nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2531 и находится в файле <path>conf/mime.types</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2532 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2533 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2534 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2535 Для того, чтобы для определённого location’а для всех ответов |
271 | 2536 выдавался 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
|
2537 можно использовать следующее: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2538 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2539 location /download/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2540 types { } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2541 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
|
2542 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2543 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2544 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2545 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2546 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2547 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2548 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2549 <directive name="types_hash_bucket_size"> |
271 | 2550 <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
|
2551 <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
|
2552 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2553 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2554 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2555 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2556 <para> |
253
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 Значение по умолчанию зависит от размера строки кэша процессора. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2559 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2560 <link doc="../hash.xml">документе</link>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2561 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2562 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2563 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2564 |
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 <directive name="types_hash_max_size"> |
271 | 2567 <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
|
2568 <default>1024</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2569 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2570 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2571 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2572 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2573 <para> |
271 | 2574 Задаёт максимальный <value>размер</value> хэш-таблиц типов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2575 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2576 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2577 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2578 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2579 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2580 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2581 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2582 <directive name="underscores_in_headers"> |
271 | 2583 <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
|
2584 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2585 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2586 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2587 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2588 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2589 Разрешает или запрещает использование символов подчёркивания в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2590 полях заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2591 Если запрещено, поля заголовка запроса, в чьих именах есть подчёркивания, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2592 помечаются как недопустимые и подпадают под действие директивы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2593 <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
|
2594 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2595 |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2596 <para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2597 Директива может быть указана на уровне <link id="server"/> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2598 в сервере по умолчанию. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2599 В этом случае её значение распространяется на все виртуальные серверы, |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2600 слушающие на том же адресе и порту. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2601 </para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2602 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2603 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2604 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2605 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2606 <directive name="variables_hash_bucket_size"> |
271 | 2607 <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
|
2608 <default>64</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2609 <context>http</context> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2612 Задаёт размер корзины в хэш-таблице переменных. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2613 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2614 <link doc="../hash.xml">документе</link>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2615 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2616 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2617 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2618 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2619 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2620 <directive name="variables_hash_max_size"> |
271 | 2621 <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
|
2622 <default>512</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2623 <context>http</context> |
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 <para> |
271 | 2626 Задаёт максимальный <value>размер</value> хэш-таблицы переменных. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2627 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2628 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2629 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2630 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2631 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2632 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2633 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2634 |
364 | 2635 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2636 <section id="variables" name="Встроенные переменные"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2637 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2638 <para> |
364 | 2639 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные |
2640 переменные, имена которых совпадают с именами переменных веб-сервера Apache. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2641 Прежде всего, это переменные, представляющие из себя поля заголовка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2642 запроса клиента, такие как <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
|
2643 и тому подобное. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2644 Кроме того, есть и другие переменные: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2645 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2646 |
271 | 2647 <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
|
2648 <tag-desc> |
271 | 2649 аргумент <value>имя</value> в строке запроса |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2650 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2651 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2652 <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
|
2653 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2654 аргументы в строке запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2655 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2656 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2657 <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
|
2658 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2659 адрес клиента в бинарном виде, длина значения всегда 4 байта |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2660 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2661 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2662 <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
|
2663 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2664 число байт, переданное клиенту, без учёта заголовка ответа |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2665 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2666 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2667 <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
|
2668 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2669 поле <header>Content-Length</header> заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2670 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2671 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2672 <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
|
2673 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2674 поле <header>Content-Type</header> заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2675 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2676 |
271 | 2677 <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
|
2678 <tag-desc> |
271 | 2679 cookie <value>имя</value> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2680 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2681 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2682 <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
|
2683 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2684 значение директивы <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
|
2685 для текущего запроса |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2686 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2687 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2688 <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
|
2689 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2690 то же, что и <var>$uri</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2691 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2692 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2693 <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
|
2694 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2695 поле <header>Host</header> заголовка запроса, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2696 или имя сервера, соответствующего запросу, если этого поля нет |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2697 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2698 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2699 <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
|
2700 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2701 имя хоста |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2702 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2703 |
271 | 2704 <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
|
2705 <tag-desc> |
448
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2706 произвольное поле заголовка запроса; |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2707 последняя часть имени переменной соответствует имени поля, приведённому |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2708 к нижнему регистру, с заменой символов тире на символы подчёркивания |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2709 </tag-desc> |
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 <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
|
2712 <tag-desc> |
271 | 2713 “<literal>on</literal>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2714 если соединение работает в режиме SSL, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2715 либо пустая строка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2716 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2717 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2718 <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
|
2719 <tag-desc> |
271 | 2720 “<literal>?</literal>”, если в строке запроса есть аргументы, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2721 и пустая строка, если их нет |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2722 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2723 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2724 <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
|
2725 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2726 позволяет ограничивать скорость соединения |
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>$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
|
2730 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2731 версия nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2732 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2733 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2734 <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
|
2735 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2736 номер (PID) рабочего процесса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2737 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2738 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2739 <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
|
2740 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2741 то же, что и <var>$args</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2742 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2743 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2744 <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
|
2745 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2746 абсолютный путь, соответствующий |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2747 значению директивы <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
|
2748 для текущего запроса, |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
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>$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
|
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 </tag-desc> |
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 <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
|
2758 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2759 порт клиента |
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>$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
|
2763 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2764 имя пользователя, использованное в Basic аутентификации |
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>$request</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> |
431
0412333658fe
Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents:
429
diff
changeset
|
2769 первоначальная строка запроса целиком |
253
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>$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
|
2773 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2774 тело запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2775 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2776 Значение переменной появляется в location’ах, обрабатываемых |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2777 директивами |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
2778 <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
|
2779 и |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2780 <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
|
2781 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2782 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2783 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2784 <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
|
2785 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2786 имя временного файла, в котором хранится тело запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2787 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2788 По завершению обработки файл необходимо удалить. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2789 Для того, чтобы тело запроса всегда записывалось в файл, |
406
98dac2bd7598
Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents:
400
diff
changeset
|
2790 следует включить <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
|
2791 При передаче имени временного файла в проксированном запросе |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2792 или в запросе к FastCGI-серверу следует запретить передачу самого |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2793 тела директивами |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2794 <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
|
2795 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
|
2796 или |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2797 <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
|
2798 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
|
2799 соответственно. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2800 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2801 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2802 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2803 <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
|
2804 <tag-desc> |
271 | 2805 “<literal>OK</literal>” если запрос завершился, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2806 либо пустая строка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2807 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2808 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2809 <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
|
2810 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2811 путь к файлу для текущего запроса, формируемый из директив |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2812 <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
|
2813 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2814 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2815 <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
|
2816 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2817 метод запроса, обычно |
271 | 2818 “<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
|
2819 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2820 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2821 <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
|
2822 <tag-desc> |
431
0412333658fe
Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents:
429
diff
changeset
|
2823 первоначальный URI запроса целиком (с аргументами) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2824 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2825 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2826 <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
|
2827 <tag-desc> |
271 | 2828 схема запроса, “<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
|
2829 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2830 |
271 | 2831 <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
|
2832 <tag-desc> |
448
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2833 произвольное поле заголовка ответа; |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2834 последняя часть имени переменной соответствует имени поля, приведённому |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2835 к нижнему регистру, с заменой символов тире на символы подчёркивания |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2836 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2837 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2838 <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
|
2839 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2840 адрес сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2841 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2842 Получение значения этой переменной обычно требует одного системного вызова. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2843 Чтобы избежать системного вызова, в директивах <link id="listen"/> |
271 | 2844 следует указывать адреса и использовать параметр <literal>bind</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2845 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2846 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2847 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2848 <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
|
2849 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2850 имя сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2851 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2852 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2853 <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
|
2854 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2855 порт сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2856 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2857 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2858 <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
|
2859 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2860 протокол сервера, обычно |
271 | 2861 “<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
|
2862 или |
271 | 2863 “<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
|
2864 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2865 |
541
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2866 <tag-name><var>$status</var></tag-name> |
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2867 <tag-desc> |
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2868 статус ответа |
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2869 </tag-desc> |
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2870 |
453
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2871 <tag-name> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2872 <var>$tcpinfo_rtt</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2873 <var>$tcpinfo_rttvar</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2874 <var>$tcpinfo_snd_cwnd</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2875 <var>$tcpinfo_rcv_space</var> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2876 </tag-name> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2877 <tag-desc> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2878 информация о клиентском TCP-соединении; доступна на системах, |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2879 поддерживающих параметр сокета <c-def>TCP_INFO</c-def> |
453
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2880 </tag-desc> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2881 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2882 <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
|
2883 <tag-desc> |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2884 текущий URI запроса в <link id="location">нормализованном</link> виде |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2885 <para> |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2886 Значение <var>$uri</var> может изменяться в процессе обработки запроса, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2887 например, при внутренних перенаправлениях |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2888 или при использовании индексных файлов. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2889 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2890 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2891 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2892 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2893 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2894 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2895 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2896 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2897 </module> |