Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_core_module.xml @ 852:0621cbf2d932
Reordered contents of "introduction" and "howto" sections.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 28 Feb 2013 11:59:39 +0400 |
parents | 9dab69f2b71d |
children | ade81792bdaa |
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" |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
13 rev="17"> |
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>. | |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
571 В значении <literal>uri</literal> можно использовать переменные. |
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> |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
577 error_page 404 /404.html; |
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
578 error_page 500 502 503 504 /50x.html; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
579 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
580 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
581 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
582 <para> |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
583 Кроме того, можно поменять код ответа на другой, |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
584 используя синтаксис вида “<literal>=</literal><value>ответ</value>”, например: |
76
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> |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
600 Также существует возможность использовать перенаправления для обработки |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
601 ошибок: |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
602 <example> |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
603 error_page 403 http://example.com/forbidden.html; |
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
604 error_page 404 =301 http://example.com/notfound.html; |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
605 </example> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
606 В этому случае клиенту возвращается код ответа 302. |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
607 Его можно изменить только на один из кодов статуса, относящихся к |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
608 перенаправлениям (301, 302, 303 и 307). |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
609 </para> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
610 |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
611 <para> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
612 Если при внутреннем перенаправлении не нужно менять URI, то можно передать |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
613 обработку ошибки в именованный location: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
614 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
615 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
616 error_page 404 = @fallback; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
617 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
618 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
619 location @fallback { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
620 proxy_pass http://backend; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
621 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
622 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
623 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
624 |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
625 <para> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
626 <note> |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
627 Если при обработке <literal>uri</literal> происходит ошибка, |
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
628 клиенту возвращается ответ с кодом статуса последней случившейся ошибки. |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
629 </note> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
630 </para> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
631 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
632 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
633 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
634 |
576
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
635 <directive name="etag"> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
636 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
637 <default>on</default> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
638 <context>http</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
639 <context>server</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
640 <context>location</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
641 <appeared-in>1.3.3</appeared-in> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
642 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
643 <para> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
644 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
645 заголовка ответа для статических ресурсов. |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
646 </para> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
647 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
648 </directive> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
649 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
650 |
651
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
651 <directive name="http"> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
652 <syntax block="yes"/> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
653 <default/> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
654 <context>main</context> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
655 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
656 <para> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
657 Предоставляет контекст конфигурационного файла, в котором указываются |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
658 директивы HTTP-сервера. |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
659 </para> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
660 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
661 </directive> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
662 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
663 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
664 <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
|
665 <syntax> |
364 | 666 <literal>off</literal> | |
667 <literal>exact</literal> | | |
668 <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
|
669 <default>exact</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
670 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
671 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
672 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
673 <appeared-in>0.7.24</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
674 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
675 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
676 Определяет, как сравнивать время модификации ответа с |
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 заголовка запроса: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
680 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
681 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
682 |
271 | 683 <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
|
684 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
685 не проверять поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
686 <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
|
687 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
688 |
271 | 689 <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
|
690 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
691 точное совпадение; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
692 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
693 |
271 | 694 <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
|
695 <tag-desc> |
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 <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
|
698 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
699 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
700 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
701 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
702 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
703 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
704 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
705 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
706 <directive name="ignore_invalid_headers"> |
271 | 707 <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
|
708 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
709 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
710 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
711 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
712 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
713 Если включено, nginx игнорирует поля заголовка с недопустимыми именами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
714 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
715 и возможно знаков подчёркивания (последнее контролируется директивой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
716 <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
|
717 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
718 |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
719 <para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
720 Директива может быть указана на уровне <link id="server"/> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
721 в сервере по умолчанию. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
722 В этом случае её значение распространяется на все виртуальные серверы, |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
723 слушающие на том же адресе и порту. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
724 </para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
725 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
726 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
727 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
728 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
729 <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
|
730 <syntax/> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
731 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
732 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
733 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
735 Указывает, что location может использоваться только для внутренних запросов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
736 Для внешних запросов клиенту будет возвращаться ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
737 <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
|
738 Внутренними запросами являются: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
739 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
740 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
741 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
742 <listitem> |
429
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
743 запросы, перенаправленные директивами |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
744 <link id="error_page"/>, |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
745 <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
|
746 <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
|
747 <link id="try_files"/>; |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
748 </listitem> |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
749 |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
750 <listitem> |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
751 запросы, перенаправленные с помощью поля |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
752 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
753 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
754 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
755 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
756 подзапросы, формируемые командой |
271 | 757 “<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
|
758 модуля |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
759 <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
|
760 и директивами модуля |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
761 <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
|
762 </listitem> |
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 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
765 запросы, изменённые директивой |
429
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
766 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
767 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
768 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
769 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
770 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
771 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
772 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
773 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
774 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
775 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
|
776 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
777 location /404.html { |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
778 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
779 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
780 </example> |
674
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
781 <note> |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
782 Для предотвращения зацикливания, которое может возникнуть при |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
783 использовании некорректных конфигураций, количество внутренних |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
784 перенаправлений ограничено десятью. |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
785 По достижении этого ограничения будет возвращена ошибка |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
786 <http-status code="500" text="Internal Server Error"/>. |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
787 В таком случае в лог-файле ошибок можно увидеть сообщение |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
788 “rewrite or internal redirection cycle”. |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
789 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
790 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
791 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
792 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
793 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
794 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
795 <directive name="keepalive_disable"> |
271 | 796 <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
|
797 <default>msie6</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
798 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
799 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
800 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
801 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
802 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
803 Запрещает keep-alive соединения с некорректно ведущими себя браузерами. |
271 | 804 Параметры <value>браузер</value> указывают, на какие браузеры это |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
805 распространяется. |
271 | 806 Значение <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
|
807 со старыми версиями MSIE после получения запроса POST. |
271 | 808 Значение <literal>safari</literal> запрещает keep-alive соединения |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
809 с Safari и подобными им браузерами на Mac OS X и подобных ей ОС. |
271 | 810 Значение <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
|
811 со всеми браузерами. |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
812 <note> |
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
813 До версии 1.1.18 под значение <literal>safari</literal> подпадали |
549 | 814 все Safari и подобные им браузеры на всех ОС, и keep-alive |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
815 соединения с ними были по умолчанию запрещены. |
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
816 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
817 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
818 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
819 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
820 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
821 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
822 <directive name="keepalive_requests"> |
271 | 823 <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
|
824 <default>100</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
825 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
826 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
827 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
828 <appeared-in>0.8.0</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
829 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
830 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
831 Задаёт максимальное число запросов, которые можно |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
832 сделать по одному keep-alive соединению. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
833 После того, как будет сделано максимальное число запросов, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
834 соединение закрывается. |
76
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="keepalive_timeout"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
841 <syntax> |
364 | 842 <value>таймаут</value> |
843 [<value>заголовок_таймаута</value>]</syntax> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
844 <default>75s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
845 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
846 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
847 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
848 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
849 <para> |
271 | 850 Первый параметр задаёт таймаут, в течение которого keep-alive |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
851 соединение с клиентом не будет закрыто со стороны сервера. |
835
e0263d44a59b
Http core: documented "keepalive_timeout 0".
Ruslan Ermilov <ru@nginx.com>
parents:
826
diff
changeset
|
852 Значение 0 запрещает keep-alive соединения с клиентами. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
853 Второй необязательный параметр задаёт значение в поле |
271 | 854 <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
|
855 заголовка ответа. |
271 | 856 Два параметра могут отличаться друг от друга. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
857 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
858 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
859 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
860 Поле |
271 | 861 <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
|
862 заголовка понимают Mozilla и Konqueror. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
863 MSIE сам закрывает keep-alive соединение примерно через 60 секунд. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
864 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
865 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
866 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
867 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
868 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
869 <directive name="large_client_header_buffers"> |
271 | 870 <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
|
871 <default>4 8k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
872 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
873 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
874 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
875 <para> |
271 | 876 Задаёт максимальное <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
|
877 буферов для чтения большого заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
878 Строка запроса не должна превышать размера одного буфера, иначе клиенту |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
879 возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
880 <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
|
881 Поле заголовка запроса также не должно превышать размера одного буфера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
882 иначе клиенту возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
883 <http-status code="400" text="Bad Request"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
884 Буферы выделяются только по мере необходимости. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
885 По умолчанию размер одного буфера равен 8K байт. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
886 Если по окончании обработки запроса соединение переходит в состояние |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
887 keep-alive, эти буферы освобождаются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
888 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
889 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
890 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
891 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
892 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
893 <directive name="limit_except"> |
271 | 894 <syntax block="yes"><value>метод</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
895 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
896 <context>location</context> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
899 Ограничивает HTTP-методы, доступные внутри location. |
271 | 900 Параметр <value>метод</value> может быть одним из |
901 <literal>GET</literal>, | |
902 <literal>HEAD</literal>, | |
903 <literal>POST</literal>, | |
904 <literal>PUT</literal>, | |
905 <literal>DELETE</literal>, | |
906 <literal>MKCOL</literal>, | |
907 <literal>COPY</literal>, | |
908 <literal>MOVE</literal>, | |
909 <literal>OPTIONS</literal>, | |
910 <literal>PROPFIND</literal>, | |
911 <literal>PROPPATCH</literal>, | |
912 <literal>LOCK</literal>, | |
913 <literal>UNLOCK</literal> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
914 или |
271 | 915 <literal>PATCH</literal>. |
916 Если разрешён метод <literal>GET</literal>, то метод | |
917 <literal>HEAD</literal> также будет разрешён. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
918 Доступ к остальным методам может быть ограничен при помощи директив модулей |
79
0a45870d0160
Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents:
76
diff
changeset
|
919 <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
|
920 и |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
921 <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
|
922 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
923 limit_except GET { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
924 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
|
925 deny all; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
926 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
927 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
928 Обратите внимание, что данное ограничение действует для всех методов, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
929 <emphasis>кроме</emphasis> GET и HEAD. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
930 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
931 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
932 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
933 |
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 <directive name="limit_rate"> |
271 | 936 <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
|
937 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
938 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
939 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
940 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
941 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
942 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
943 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
944 Ограничивает скорость передачи ответа клиенту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
945 Скорость задаётся в байтах в секунду. |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
946 Значение 0 отключает ограничение скорости. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
947 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
948 Чем меньше скорость, тем более аккуратным будет ограничение. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
949 --> |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
950 Ограничение устанавливается на запрос, поэтому если клиент одновременно |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
951 откроет два соединения, суммарная скорость будет вдвое выше |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
952 заданного ограничения. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
953 </para> |
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 <para> |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
956 Ограничение скорости можно также задать в переменной <var>$limit_rate</var>. |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
957 Это может быть полезно в случаях, когда скорость нужно ограничивать |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
958 в зависимости от какого-либо условия: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
959 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
960 server { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
961 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
962 if ($slow) { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
963 set $limit_rate 4k; |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
966 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
967 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
968 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
969 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
970 |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
971 <para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
972 Кроме того, ограничение скорости может быть задано в поле |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
973 <header>X-Accel-Limit-Rate</header> заголовка ответа проксированного сервера. |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
974 Эту возможность можно запретить с помощью директив |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
975 <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
|
976 и |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
977 <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
|
978 </para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
979 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
980 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
981 |
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 <directive name="limit_rate_after"> |
271 | 984 <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
|
985 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
986 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
987 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
988 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
989 <context>if в location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
990 <appeared-in>0.8.0</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
991 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
992 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
993 Задаёт начальный объём данных, после передачи которого начинает |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
994 ограничиваться скорость передачи ответа клиенту. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
995 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
996 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
997 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
998 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
999 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1000 location /flv/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1001 flv; |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1002 limit_rate_after 500k; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1003 limit_rate 50k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1004 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1005 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1006 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1007 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1008 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1009 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1010 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1011 <directive name="lingering_close"> |
271 | 1012 <syntax> |
364 | 1013 <literal>off</literal> | |
1014 <literal>on</literal> | | |
1015 <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
|
1016 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1017 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1018 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1019 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1020 <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
|
1021 <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
|
1022 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1023 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1024 Управляет закрытием соединений с клиентами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1025 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1026 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1027 <para> |
271 | 1028 Со значением по умолчанию “<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
|
1029 <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
|
1030 <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
|
1031 поступающие от клиента, перед полным закрытием соединения, но только |
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 </para> |
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 <para> |
271 | 1036 Со значением “<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
|
1037 ждать и обрабатывать дополнительные данные, поступающие от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1038 </para> |
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 <para> |
271 | 1041 Со значением “<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
|
1042 дополнительных данных и сразу же закроет соединение. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1043 Это нарушает протокол, поэтому не следует это использовать без нужды. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1044 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1045 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1046 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1049 <directive name="lingering_time"> |
271 | 1050 <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
|
1051 <default>30s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1052 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1053 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1054 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1055 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1056 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1057 Если действует <link id="lingering_close"/>, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1058 эта директива задаёт максимальное время, в течение которого nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1059 будет обрабатывать (читать и игнорировать) дополнительные данные, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1060 поступающие от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1061 По прошествии этого времени соединение будет закрыто, даже если |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1062 будут ещё данные. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1063 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1064 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1065 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1066 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1067 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1068 <directive name="lingering_timeout"> |
271 | 1069 <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
|
1070 <default>5s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1071 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1072 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1073 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1074 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1075 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1076 Если действует <link id="lingering_close"/>, эта директива задаёт |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1077 максимальное время ожидания поступления дополнительных данных от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1078 Если в течение этого времени данные не были получены, соединение закрывается. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1079 Иначе данные читаются и игнорируются, затем nginx снова ждёт поступления данных. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1080 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1081 директивой <link id="lingering_time"/>. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1082 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1083 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1084 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1085 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1086 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1087 <directive name="listen"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1088 <syntax> |
364 | 1089 <value>адрес</value>[:<value>порт</value>] |
1090 [<literal>default_server</literal>] | |
1091 [<literal>setfib</literal>=<value>число</value>] | |
1092 [<literal>backlog</literal>=<value>число</value>] | |
1093 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1094 [<literal>sndbuf</literal>=<value>размер</value>] | |
1095 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1096 [<literal>deferred</literal>] | |
1097 [<literal>bind</literal>] | |
1098 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] | |
1099 [<literal>ssl</literal>] | |
1100 [<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
|
1101 <syntax> |
364 | 1102 <value>порт</value> |
1103 [<literal>default_server</literal>] | |
1104 [<literal>setfib</literal>=<value>число</value>] | |
1105 [<literal>backlog</literal>=<value>число</value>] | |
1106 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1107 [<literal>sndbuf</literal>=<value>размер</value>] | |
1108 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1109 [<literal>deferred</literal>] | |
1110 [<literal>bind</literal>] | |
1111 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] | |
1112 [<literal>ssl</literal>] | |
1113 [<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
|
1114 <syntax> |
364 | 1115 <literal>unix:</literal><value>путь</value> |
1116 [<literal>default_server</literal>] | |
1117 [<literal>backlog</literal>=<value>число</value>] | |
1118 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1119 [<literal>sndbuf</literal>=<value>размер</value>] | |
1120 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1121 [<literal>deferred</literal>] | |
1122 [<literal>bind</literal>] | |
1123 [<literal>ssl</literal>] | |
1124 [<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
|
1125 <default>*:80 | *:8000</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1126 <context>server</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1127 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1128 <para> |
271 | 1129 Задаёт <value>адрес</value> и <value>порт</value> для IP |
1130 или <value>путь</value> для UNIX-сокета, | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1131 на которых сервер будет принимать запросы. |
271 | 1132 Можно указать только <value>адрес</value> |
1133 или только <value>порт</value>. | |
1134 Кроме того, <value>адрес</value> может быть именем хоста, например: | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1135 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1136 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
|
1137 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
|
1138 listen 8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1139 listen *:8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1140 listen localhost:8000; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1141 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1142 IPv6-адреса (0.7.36) задаются в квадратных скобках: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1143 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1144 listen [::]:8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1145 listen [fe80::1]; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1146 </example> |
271 | 1147 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
|
1148 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1149 listen unix:/var/run/nginx.sock; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1150 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1151 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1152 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1153 <para> |
271 | 1154 Если указан только <value>адрес</value>, то используется порт 80. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1155 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1156 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1157 <para> |
271 | 1158 Если директива не указана, то используется либо <literal>*:80</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1159 (если nginx работает с привилегиями суперпользователя), |
271 | 1160 либо <literal>*:8000</literal>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1161 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1162 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1163 <para> |
271 | 1164 Если у директивы есть параметр <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
|
1165 в котором описана эта директива, будет сервером по умолчанию для указанной пары |
271 | 1166 <value>адрес</value>:<value>порт</value>. |
1167 Если же директив с параметром <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
|
1168 сервером по умолчанию будет первый сервер, в котором описана пара |
271 | 1169 <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
|
1170 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1171 До версии 0.8.21 этот параметр назывался просто |
271 | 1172 <literal>default</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1173 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1174 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1175 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1176 <para> |
271 | 1177 В директиве <literal>listen</literal> можно также указать несколько |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1178 дополнительных параметров, специфичных для связанных с сокетами |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1179 системных вызовов. |
271 | 1180 Эти параметры можно задать в любой директиве <literal>listen</literal>, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1181 но только один раз для указанной пары |
271 | 1182 <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
|
1183 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1184 До версии 0.8.21 их можно было указывать лишь в директиве |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1185 <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
|
1186 </note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1187 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1188 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1189 <tag-name> |
271 | 1190 <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
|
1191 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1192 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1193 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1194 (параметр <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
|
1195 В настоящий момент это работает только на FreeBSD. |
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>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
|
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> |
271 | 1202 задаёт параметр <literal>backlog</literal> в вызове |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1203 <c-func>listen</c-func>, который ограничивает |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1204 максимальный размер очереди ожидающих приёма соединений. |
741
082a725038db
Fixed default backlog value description for Mac OS X
Sergey Budnevitch <sb@waeme.net>
parents:
738
diff
changeset
|
1205 По умолчанию <literal>backlog</literal> устанавливается равным -1 для |
082a725038db
Fixed default backlog value description for Mac OS X
Sergey Budnevitch <sb@waeme.net>
parents:
738
diff
changeset
|
1206 FreeBSD и Mac OS X, и 511 для других платформ. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1207 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1208 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1209 <tag-name> |
271 | 1210 <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
|
1211 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1212 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1213 задаёт размер буфера приёма |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1214 (параметр <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
|
1215 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1216 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1217 <tag-name> |
271 | 1218 <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
|
1219 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1220 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1221 задаёт размер буфера передачи |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1222 (параметр <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
|
1223 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1224 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1225 <tag-name> |
271 | 1226 <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
|
1227 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1228 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1229 задаёт название accept-фильтра |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1230 (параметр <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
|
1231 который включается для фильтрации входящих соединений |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1232 перед передачей их в <c-func>accept</c-func>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1233 Работает только на FreeBSD и NetBSD 5.0+. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1234 Можно использовать два фильтра — |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1235 <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
|
1236 и |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1237 <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
|
1238 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1239 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1240 <tag-name> |
271 | 1241 <literal>deferred</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1242 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1243 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1244 указывает использовать отложенный <c-func>accept</c-func> |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1245 (параметр <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
|
1246 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1247 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1248 <tag-name> |
271 | 1249 <literal>bind</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1250 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1251 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1252 указывает, что для данной пары |
271 | 1253 <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
|
1254 <c-func>bind</c-func> отдельно. |
271 | 1255 Дело в том, что если описаны несколько директив <literal>listen</literal> |
629 | 1256 с одинаковым портом, но разными адресами, и одна из директив |
271 | 1257 <literal>listen</literal> слушает на всех адресах для данного порта |
629 | 1258 (<literal>*:</literal><value>порт</value>), то nginx сделает |
271 | 1259 <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
|
1260 Необходимо заметить, что в этом случае для определения адреса, на которой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1261 пришло соединение, делается системный вызов <c-func>getsockname</c-func>. |
271 | 1262 Если же используются параметры <literal>backlog</literal>, |
1263 <literal>rcvbuf</literal>, <literal>sndbuf</literal>, | |
1264 <literal>accept_filter</literal>, <literal>deferred</literal> | |
1265 или <literal>so_keepalive</literal>, то для данной пары | |
1266 <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
|
1267 отдельный вызов <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
|
1268 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1269 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1270 <tag-name> |
271 | 1271 <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
|
1272 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1273 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1274 этот параметр (0.7.42) определяет |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1275 (через параметр сокета <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
|
1276 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1277 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения. |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1278 По умолчанию параметр включён. |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1279 Установить его можно только один раз на старте. |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1280 <note> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1281 До версии 1.3.4, |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1282 если этот параметр не был задан явно, то для сокета действовали |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1283 настройки операционной системы. |
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1284 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1285 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1286 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1287 <tag-name> |
271 | 1288 <literal>ssl</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1289 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1290 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1291 этот параметр (0.7.14) не имеет отношения к связанным с сокетами системным |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1292 вызовам, а позволяет указать, что все соединения, принимаемые на этом порту, |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1293 должны работать в режиме SSL. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1294 Это позволяет задать компактную <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
|
1295 id="single_http_https_server">конфигурацию</link> для сервера, |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1296 работающего сразу в двух режимах — HTTP и HTTPS. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1297 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1298 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1299 <tag-name> |
271 | 1300 <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
|
1301 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1302 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1303 этот параметр (1.1.11) конфигурирует для слушающего сокета |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1304 поведение “TCP keepalive”. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1305 Если этот параметр опущен, то для сокета будут действовать |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1306 настройки операционной системы. |
271 | 1307 Если он установлен в значение “<literal>on</literal>”, то для сокета |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1308 включается параметр <c-def>SO_KEEPALIVE</c-def>. |
271 | 1309 Если он установлен в значение “<literal>off</literal>”, то для сокета |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1310 параметр <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
|
1311 Некоторые операционные системы поддерживают настройку параметров |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1312 “TCP keepalive” на уровне сокета посредством параметров |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1313 <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
|
1314 <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
|
1315 На таких системах (в настоящий момент это 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
|
1316 FreeBSD 9.0-STABLE) |
271 | 1317 их можно сконфигурировать с помощью параметров <value>keepidle</value>, |
1318 <value>keepintvl</value> и <value>keepcnt</value>. | |
1319 Один или два параметра могут быть опущены, в таком случае для | |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1320 соответствующего параметра сокета будут действовать стандартные |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1321 системные настройки. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1322 Например, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1323 <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
|
1324 установит таймаут бездействия (<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
|
1325 для интервала проб (<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
|
1326 стандартная системная настройка, а счётчик проб (<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
|
1327 будет равен 10. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1328 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1329 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1330 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1331 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1332 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1333 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1334 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1335 <example> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1336 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
|
1337 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1338 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1339 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1340 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1341 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1342 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1343 <directive name="location"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1344 <syntax block="yes">[ |
364 | 1345 <literal>=</literal> | |
1346 <literal>~</literal> | | |
1347 <literal>~*</literal> | | |
1348 <literal>^~</literal> | |
1349 ] <value>uri</value></syntax> | |
271 | 1350 <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
|
1351 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1352 <context>server</context> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1353 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1354 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1355 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1356 Устанавливает конфигурацию в зависимости от URI запроса. |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1357 </para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1358 |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1359 <para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1360 Для сопоставления используется URI запроса в нормализованном виде, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1361 после декодирования текста, заданного в виде “<literal>%XX</literal>”, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1362 преобразования относительных элементов пути “<literal>.</literal>” и |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1363 “<literal>..</literal>” в реальные, и возможной |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1364 <link id="merge_slashes">замены</link> двух и более подряд идущих |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1365 слэшей на один. |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1366 </para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1367 |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1368 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1369 location можно задать префиксной строкой или регулярным выражением. |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1370 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1371 (для поиска совпадения без учёта регистра символов), |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1372 либо с модификатором “<literal>~</literal>” (с учётом регистра). |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1373 Чтобы найти location, соответствующий запросу, вначале проверяются |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1374 location’ы, заданные префиксными строками (префиксные location’ы). |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1375 Среди них ищется максимальное совпадение. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1376 Затем проверяются регулярные выражения, в порядке их следования |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1377 в конфигурационном файле. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1378 Проверка регулярных выражений прекращается после первого же совпадения, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1379 и используется соответствующая конфигурация. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1380 Если совпадение с регулярным выражением не найдено, то используется |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1381 конфигурация максимально совпавшего префиксного location’а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1382 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1383 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1384 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1385 location’ы могут быть вложенными, с некоторыми исключениями, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1386 о которых говорится ниже. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1387 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1388 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1389 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1390 Для операционных систем, нечувствительных к регистру символов, таких |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1391 как Mac OS X и Cygwin, сравнение с префиксными строками производится |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1392 без учёта регистра (0.7.7). |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1393 Однако, сравнение ограничено только однобайтными locale’ями. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1394 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1395 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1396 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1397 Регулярные выражения могут содержать выделения (0.7.40), которые могут |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1398 затем использоваться в других директивах. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1399 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1400 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1401 <para> |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1402 Если у максимального совпавшего префиксного location’а указан модификатор |
271 | 1403 “<literal>^~</literal>”, то регулярные выражения не проверяются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1404 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1405 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1406 <para> |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1407 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1408 совпадение URI и location. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1409 При точном совпадении поиск сразу же прекращается. |
271 | 1410 Например, если запрос “<literal>/</literal>” случается часто, то |
1411 указав “<literal>location = /</literal>”, можно ускорить обработку | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1412 этих запросов, так как поиск прекратится после первого же сравнения. |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1413 Очевидно, что такой location не может иметь вложенные location’ы. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1414 </para> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1417 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1418 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1419 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
|
1420 то поиск тоже сразу же прекращается и регулярные выражения также |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1421 не проверяются. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1422 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1423 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1424 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1425 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1426 Проиллюстрируем вышесказанное примером: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1427 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1428 location = / { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1429 [ конфигурация А ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1430 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1431 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1432 location / { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1433 [ конфигурация Б ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1434 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1435 |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1436 location /documents/ { |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1437 [ конфигурация В ] |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1438 } |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1439 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1440 location ^~ /images/ { |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1441 [ конфигурация Г ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1442 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1443 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1444 location ~* \.(gif|jpg|jpeg)$ { |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1445 [ конфигурация Д ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1446 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1447 </example> |
271 | 1448 Для запроса “<literal>/</literal>” будет выбрана конфигурация А, |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1449 для запроса “<literal>/index.html</literal>” — конфигурация Б, |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1450 для запроса “<literal>/documents/document.html</literal>” — конфигурация В, |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1451 для запроса “<literal>/images/1.gif</literal>” — конфигурация Г, |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1452 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Д. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1453 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1454 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1455 <para> |
271 | 1456 Префикс “<literal>@</literal>” задаёт именованный location. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1457 Такой location не используется при обычной обработке запросов, а |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1458 предназначен только для перенаправления в него запросов. |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1459 Такие location’ы не могут быть вложенными и не могут содержать |
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1460 вложенные location’ы. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1461 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1462 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1463 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1464 <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
|
1465 --> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1466 |
76
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1470 <directive name="log_not_found"> |
271 | 1471 <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
|
1472 <default>on</default> |
253
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> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1476 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1477 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1478 Разрешает или запрещает записывать в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1479 <link doc="../ngx_core_module.xml" id="error_log"/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1480 ошибки о том, что файл не найден. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1481 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1482 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1483 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1484 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1485 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1486 <directive name="log_subrequest"> |
271 | 1487 <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
|
1488 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1489 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1490 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1491 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1492 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1493 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1494 Разрешает или запрещает записывать в |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
1495 <link doc="ngx_http_log_module.xml" id="access_log"/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1496 подзапросы. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1497 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1498 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1499 </directive> |
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 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1502 <directive name="max_ranges"> |
271 | 1503 <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
|
1504 <default/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1505 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1506 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1507 <context>location</context> |
499
76a8eca844d0
Documented that "max_ranges" appeared in 1.1.2.
Ruslan Ermilov <ru@nginx.com>
parents:
477
diff
changeset
|
1508 <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
|
1509 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1510 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1511 Ограничивает максимальное допустимое число диапазонов в запросах с |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1512 указанием диапазона запрашиваемых байт (byte-range requests). |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1513 Запросы, превышающие указанное ограничение, обрабатываются как |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1514 если бы они не содержали указания диапазонов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1515 По умолчанию ограничения нет. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1516 Значение 0 полностью запрещает поддержку диапазонов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1517 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1518 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1519 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1520 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1521 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1522 <directive name="merge_slashes"> |
271 | 1523 <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
|
1524 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1525 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1526 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1527 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1528 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1529 Разрешает или запрещает преобразование URI путём замены двух и более подряд |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1530 идущих слэшей (“<literal>/</literal>”) на один. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1531 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1532 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1533 <para> |
280 | 1534 Необходимо иметь в виду, что это преобразование необходимо для корректной |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1535 проверки префиксных строк и регулярных выражений. |
364 | 1536 Если его не делать, то запрос “<literal>//scripts/one.php</literal>” |
1537 не попадёт в | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1538 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1539 location /scripts/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1540 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1541 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1542 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1543 и может быть обслужен как статический файл. |
271 | 1544 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1545 </para> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1548 Запрет преобразования может понадобиться, если в URI используются имена, |
271 | 1549 закодированные методом base64, в котором задействован символ |
1550 “<literal>/</literal>”. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1551 Однако по соображениям безопасности лучше избегать отключения преобразования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1552 </para> |
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> |
442
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1555 Директива может быть указана на уровне <link id="server"/> |
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1556 в сервере по умолчанию. |
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1557 В этом случае её значение распространяется на все виртуальные серверы, |
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1558 слушающие на том же адресе и порту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1559 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1562 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1563 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1564 <directive name="msie_padding"> |
271 | 1565 <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
|
1566 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1567 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1568 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1569 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1570 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1571 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1572 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1573 комментарий для увеличения размера ответа до 512 байт. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1574 </para> |
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 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1579 <directive name="msie_refresh"> |
271 | 1580 <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
|
1581 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1582 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1583 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1584 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1585 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1586 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1587 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо |
253
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 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1590 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1591 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1594 <directive name="open_file_cache"> |
271 | 1595 <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
|
1596 <syntax> |
271 | 1597 <literal>max</literal>=<value>N</value> |
1598 [<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
|
1599 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1600 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1601 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1602 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1603 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1604 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1605 Задаёт кэш, в котором могут храниться: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1606 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1607 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1608 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1609 дескрипторы открытых файлов, информация об их размерах и времени модификации; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1610 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1611 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1612 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1613 информация о существовании каталогов; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1614 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1615 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1616 <listitem> |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1617 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1618 и тому подобное. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1619 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1620 Кэширование ошибок нужно разрешить отдельно директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1621 <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
|
1622 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1623 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1624 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1625 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1626 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1627 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1628 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1629 У директивы есть следующие параметры: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1630 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1631 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1632 <tag-name> |
271 | 1633 <literal>max</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1634 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1635 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1636 задаёт максимальное число элементов в кэше; |
507 | 1637 при переполнении кэша удаляются наименее востребованные элементы (LRU); |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1638 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1639 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1640 <tag-name> |
271 | 1641 <literal>inactive</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1642 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1643 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1644 задаёт время, после которого элемент кэша удаляется, если к нему |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1645 не было обращений в течение этого времени; по умолчанию 60 секунд; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1646 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1647 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1648 <tag-name> |
271 | 1649 <literal>off</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1650 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1651 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1652 запрещает кэш. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1653 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1654 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1655 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1656 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1657 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1658 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1659 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1660 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1661 open_file_cache max=1000 inactive=20s; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1662 open_file_cache_valid 30s; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1663 open_file_cache_min_uses 2; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1664 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
|
1665 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1666 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
|
1667 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1668 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1669 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1670 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1671 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1672 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1673 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1674 <directive name="open_file_cache_errors"> |
271 | 1675 <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
|
1676 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1677 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1678 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1679 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1680 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1681 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1682 Разрешает или запрещает кэширование ошибок поиска файлов в |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1683 <link id="open_file_cache"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1684 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1685 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1686 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1687 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1688 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1689 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1690 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1691 <directive name="open_file_cache_events"> |
271 | 1692 <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
|
1693 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1694 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1695 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1696 <context>location</context> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1699 Разрешает использование событий ядра для проверки актуальности элементов |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1700 <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
|
1701 Эта директива работает только совместно с методом |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1702 <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
|
1703 Заметьте, что только 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
|
1704 поддерживают события для файловых систем произвольного типа. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1705 Другие операционные системы поддерживают события только для |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1706 основных файловых систем, таких как UFS или FFS. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1707 </para> |
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 </directive> |
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 |
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 <directive name="open_file_cache_min_uses"> |
271 | 1715 <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
|
1716 <default>1</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1717 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1718 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1719 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1720 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1721 <para> |
271 | 1722 Задаёт минимальное <value>число</value> обращений к файлу |
1723 в течение времени, заданного параметром <literal>inactive</literal> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1724 директивы <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
|
1725 файла будет оставаться открытым в кэше. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1726 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1727 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1728 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1729 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1730 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1731 <directive name="open_file_cache_valid"> |
271 | 1732 <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
|
1733 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1734 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1735 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1736 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1737 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1738 <para> |
253
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 об элементе в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1741 <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
|
1742 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1743 При включенном |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1744 <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
|
1745 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1746 по факту их изменения. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1747 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1748 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1749 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1750 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1751 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1752 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1753 <directive name="optimize_server_names"> |
271 | 1754 <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
|
1755 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1756 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1757 <context>server</context> |
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> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1760 Директива устарела, вместо неё следует использовать директиву |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1761 <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
|
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 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1765 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1766 Разрешает или запрещает оптимизировать проверку имени хоста в name-based |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1767 виртуальных серверах. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1768 Проверка в частности влияет на имя хоста, используемого в перенаправлениях. |
381 | 1769 Если оптимизация разрешена и все name-based серверы, слушающие на одной |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1770 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1771 имена не проверяются и в перенаправлениях используется первое имя сервера. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1772 Если в перенаправлении нужно использовать имя хоста, переданное клиентом, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1773 то оптимизацию нужно выключить. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1774 </para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1775 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1776 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1777 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1778 |
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 name="port_in_redirect"> |
271 | 1781 <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
|
1782 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1783 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1784 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1785 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1786 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1787 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1788 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx’ом. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1789 </para> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1790 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1791 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
1792 Использование в перенаправлениях основного имени сервера управляется |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
1793 директивой <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
|
1794 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1795 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1796 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1797 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1798 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1799 <directive name="postpone_output"> |
271 | 1800 <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
|
1801 <default>1460</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1802 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1803 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1804 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1805 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1806 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1807 Если это возможно, то отправка данных клиенту будет отложена пока nginx не |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1808 накопит по крайней мере указанное количество байт для отправки. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1809 Значение 0 запрещает отложенную отправку данных. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1810 </para> |
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> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1813 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1814 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1815 <directive name="read_ahead"> |
271 | 1816 <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
|
1817 <default>0</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1818 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1819 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1820 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1821 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1822 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1823 Задаёт ядру размер предчтения при работе с файлами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1824 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1825 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1826 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1827 На Linux используется системный вызов |
271 | 1828 <literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>, |
1829 поэтому параметр <value>размер</value> там игнорируется. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1830 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1831 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1832 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1833 На FreeBSD используется системный вызов |
271 | 1834 <literal>fcntl(O_READAHEAD, |
1835 </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
|
1836 появившийся во FreeBSD 9.0-CURRENT. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1837 Для FreeBSD 7 необходимо установить |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1838 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1839 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1840 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1841 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1844 <directive name="recursive_error_pages"> |
271 | 1845 <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
|
1846 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1847 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1848 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1849 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1850 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1851 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1852 Разрешает или запрещает делать несколько перенаправлений через директиву |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1853 <link id="error_page"/>. |
709
a4648185190a
Fixed the link internal to the module.
Ruslan Ermilov <ru@nginx.com>
parents:
679
diff
changeset
|
1854 Число таких перенаправлений <link id="internal">ограничено</link>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1855 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1856 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1857 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1860 <directive name="request_pool_size"> |
271 | 1861 <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
|
1862 <default>4k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1863 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1864 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1865 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1866 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1867 Позволяет производить точную настройку выделений памяти |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1868 под конкретные запросы. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1869 Эта директива не оказывает существенного влияния на |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1870 производительность и её не следует использовать. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1871 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1872 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1873 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1874 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1875 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1876 <directive name="reset_timedout_connection"> |
364 | 1877 <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
|
1878 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1879 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1880 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1881 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1882 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1883 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1884 Разрешает или запрещает сброс соединений по таймауту. |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1885 Сброс делается следующим образом — перед закрытием сокета для него |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1886 ставится параметр |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1887 <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
|
1888 с таймаутом 0. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1889 После чего при закрытии сокета клиенту отсылается TCP RST, а вся память, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1890 связанная с этим сокетом, освобождается. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1891 Это позволяет избежать длительного нахождения уже закрытого сокета в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1892 состоянии FIN_WAIT1 с заполненными буферами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1893 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1894 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1895 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1896 Необходимо отметить, что keep-alive соединения по истечении таймаута |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1897 закрываются обычным образом. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1898 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1899 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1900 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1901 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1902 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1903 <directive name="resolver"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1904 <syntax> |
271 | 1905 <value>адрес</value> ... |
1906 [<literal>valid</literal>=<value>время</value>]</syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
1907 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1908 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1909 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1910 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1911 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1912 <para> |
318
4a0fe9283dc7
Word polishing in the description of the "server" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
280
diff
changeset
|
1913 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1914 в адреса, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1915 <example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1916 resolver 127.0.0.1 [::1]:5353; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1917 </example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1918 Адрес может быть указан в виде доменного имени или IP-адреса, |
566 | 1919 и необязательного порта (1.3.1, 1.2.2). |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1920 Если порт не указан, используется порт 53. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1921 Серверы DNS опрашиваются циклически. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1922 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1923 До версии 1.1.7 можно было задать лишь один DNS-сервер. |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1924 Задание DNS-серверов с помощью IPv6-адресов поддерживается |
566 | 1925 начиная с версий 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
|
1926 </note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1927 По умолчанию nginx кэширует ответы, используя значение TTL из ответа. |
271 | 1928 Необязательный параметр <literal>valid</literal> позволяет это |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1929 переопределить: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1930 <example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
1931 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
|
1932 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1933 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1934 До версии 1.1.9 настройка времени кэширования была невозможна |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1935 и nginx всегда кэшировал ответы на срок в 5 минут. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1936 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1937 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1938 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1939 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1940 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1941 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1942 <directive name="resolver_timeout"> |
271 | 1943 <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
|
1944 <default>30s</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1945 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1946 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1947 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1948 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1949 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1950 Задаёт таймаут для преобразования имени в адрес, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1951 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1952 resolver_timeout 5s; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1953 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1954 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1955 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1956 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1959 <directive name="root"> |
271 | 1960 <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
|
1961 <default>html</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1962 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1963 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1964 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1965 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1966 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1967 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1968 Задаёт корневой каталог для запросов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1969 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1970 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1971 location /i/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1972 root /data/w3; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1973 } |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1974 </example> |
271 | 1975 в ответ на запрос “<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
|
1976 <path>/data/w3/i/top.gif</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1977 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1978 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1979 <para> |
271 | 1980 В значении параметра <value>путь</value> можно использовать переменные, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1981 кроме <var>$document_root</var> и <var>$realpath_root</var>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1982 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1983 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1984 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1985 Путь к файлу формируется путём простого добавления URI к значению директивы |
271 | 1986 <literal>root</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1987 Если же URI необходимо поменять, следует воспользоваться директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1988 <link id="alias"/>. |
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"> |
271 | 1995 <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
|
1996 <default>all</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> |
271 | 2002 Разрешает доступ, если оба (<literal>all</literal>) |
2003 или хотя бы один (<literal>any</literal>) из модулей | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2004 <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
|
2005 и <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
|
2006 разрешают доступ. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2007 </para> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2010 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2011 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2012 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2013 satisfy any; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2014 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2015 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
|
2016 deny all; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2017 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2018 auth_basic "closed site"; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2019 auth_basic_user_file conf/htpasswd; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2020 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2021 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2022 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2023 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2024 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2025 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2026 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2027 <directive name="satisfy_any"> |
271 | 2028 <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
|
2029 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2030 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2031 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2032 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2033 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2034 <para> |
406
98dac2bd7598
Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents:
400
diff
changeset
|
2035 Эта директива была заменена параметром <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
|
2036 директивы <link id="satisfy"/>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2037 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2038 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2039 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2040 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2041 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2042 <directive name="send_lowat"> |
271 | 2043 <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
|
2044 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2045 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2046 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2047 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2048 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2049 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2050 При установке в ненулевое значение nginx будет пытаться минимизировать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2051 число операций отправки на клиентских сокетах либо при помощи флага |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2052 <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
|
2053 <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
|
2054 либо при помощи параметра сокета <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
|
2055 с указанным размером. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2056 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2057 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2058 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2059 Эта директива игнорируется на Linux, Solaris и Windows. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2060 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2061 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2062 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2063 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2064 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2065 <directive name="send_timeout"> |
271 | 2066 <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
|
2067 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2068 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2069 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2070 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2071 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2072 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2073 Задаёт таймаут при передаче ответа клиенту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2074 Таймаут устанавливается не на всю передачу ответа, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2075 а только между двумя операциями записями. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2076 Если по истечении этого времени клиент ничего не примет, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2077 соединение будет закрыто. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2078 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2079 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2080 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2083 <directive name="sendfile"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2084 |
271 | 2085 <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
|
2086 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2087 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2088 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2089 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2090 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2091 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2092 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2093 Разрешает или запрещает использовать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2094 <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
|
2095 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2096 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2097 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2098 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2099 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2100 <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
|
2101 |
271 | 2102 <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
|
2103 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2104 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2105 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2106 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2107 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2108 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2109 При установке в ненулевое значение ограничивает объём данных, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2110 который может передан за один вызов <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
|
2111 Без этого ограничения одно быстрое соединение может целиком |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2112 захватить рабочий процесс. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2113 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2116 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2117 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2118 <directive name="server"> |
108
72524ae53106
Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
2119 <syntax block="yes"/> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2120 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2121 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2122 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2123 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2124 Задаёт конфигурацию для виртуального сервера. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2125 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса) |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2126 и 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
|
2127 Вместо этого директивами <link id="listen"/> описываются все |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2128 адреса и порты, на которых нужно принимать соединения для этого сервера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2129 а в директиве <link id="server_name"/> указываются все имена серверов. |
522
ef11546f75ee
Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
2130 Примеры конфигураций описаны в документе |
ef11546f75ee
Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
2131 “<link doc="request_processing.xml"/>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2132 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2133 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2134 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2135 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2136 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2137 <directive name="server_name"> |
271 | 2138 <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
|
2139 <default>""</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2140 <context>server</context> |
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 Задаёт имена виртуального сервера, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2144 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2145 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2146 server_name example.com www.example.com; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2147 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2148 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2149 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2150 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2151 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2152 Первое имя становится основным именем сервера. |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2153 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2154 |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2155 <para> |
271 | 2156 В именах серверов можно использовать звёздочку (“<literal>*</literal>”) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2157 для замены первой или последней части имени: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2158 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2159 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2160 server_name example.com *.example.com www.example.*; |
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 </example> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2163 Такие имена называются именами с маской. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2164 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2165 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2166 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2167 Два первых вышеприведённых имени можно объединить в одно: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2168 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2169 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2170 server_name .example.com; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2171 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2172 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2173 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2174 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2175 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2176 В качестве имени сервера можно также использовать регулярное выражение, |
271 | 2177 указав перед ним тильду (“<literal>~</literal>”): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2178 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2179 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2180 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
|
2181 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2182 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2183 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2184 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2185 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2186 Регулярное выражение может содержать выделения (0.7.40), |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2187 которые могут затем использоваться в других директивах: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2188 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2189 server { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2190 server_name ~^(www\.)?(.+)$; |
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 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2193 root /sites/$2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2194 } |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2197 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2198 server_name _; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2199 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2200 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2201 root /sites/default; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2202 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2203 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2204 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2205 </para> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2208 Именованные выделения в регулярном выражении создают переменные (0.8.25), |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2209 которые могут затем использоваться в других директивах: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2210 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2211 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2212 server_name ~^(www\.)?(?<domain>.+)$; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2213 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2214 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2215 root /sites/$domain; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2216 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2217 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2218 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2219 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2220 server_name _; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2221 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2222 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2223 root /sites/default; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2224 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2225 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2226 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2227 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2228 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2229 <para> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2230 Если параметр равен “<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
|
2231 подставляется имя хоста (hostname) машины. |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2232 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2233 |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2234 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2235 Возможно также указать пустое имя сервера (0.7.11): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2236 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2237 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2238 server_name www.example.com ""; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2239 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2240 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2241 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2242 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2243 Это настройка по умолчанию. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2244 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2245 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2246 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2247 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2248 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2249 <para> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2250 При поиске виртуального сервера по имени, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2251 если имени соответствует несколько из указанных вариантов, |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2252 например, одновременно подходят и имя с маской, и регулярное выражение, |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2253 будет выбран первый подходящий вариант в следующем порядке приоритета: |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2254 <list type="enum"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2255 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2256 <listitem> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2257 точное имя |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2258 </listitem> |
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 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2261 самое длинное имя с маской в начале, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2262 например “<literal>*.example.com</literal>” |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2263 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2264 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2265 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2266 самое длинное имя с маской в конце, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2267 например “<literal>mail.*</literal>” |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2268 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2269 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2270 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2271 первое подходящее регулярное выражение |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2272 (в порядке следования в конфигурационном файле) |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2273 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2274 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2275 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2276 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2277 |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2278 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2279 Подробнее имена серверов обсуждаются в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2280 <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
|
2281 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2282 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2283 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2284 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2285 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2286 <directive name="server_name_in_redirect"> |
271 | 2287 <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
|
2288 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2289 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2290 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2291 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2292 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2293 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2294 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2295 основное имя сервера, задаваемое директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2296 <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
|
2297 Если запрещено, то используется имя, указанное в поле <header>Host</header> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2298 заголовка запроса. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2299 Если же этого поля нет, то используется IP-адрес сервера. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2300 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2301 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2302 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2303 Использование в перенаправлениях порта управляется |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2304 директивой <link id="port_in_redirect"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2305 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2306 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2307 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2308 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2309 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2310 <directive name="server_names_hash_bucket_size"> |
271 | 2311 <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
|
2312 <default>32|64|128</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2313 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2314 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2315 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2316 Задаёт размер корзины в хэш-таблицах имён серверов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2317 Значение по умолчанию зависит от размера строки кэша процессора. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2318 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2319 <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
|
2320 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2321 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2322 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2323 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2324 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2325 <directive name="server_names_hash_max_size"> |
271 | 2326 <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
|
2327 <default>512</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2328 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2329 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2330 <para> |
271 | 2331 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2332 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2333 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2334 </para> |
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> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2337 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2338 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2339 <directive name="server_tokens"> |
271 | 2340 <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
|
2341 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2342 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2343 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2344 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2345 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2346 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2347 Разрешает или запрещает выдавать версию nginx’а в сообщениях об ошибках и |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2348 в поле <header>Server</header> заголовка ответа. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2349 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2352 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2353 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2354 <directive name="tcp_nodelay"> |
271 | 2355 <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
|
2356 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2357 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2358 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2359 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2360 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2361 <para> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2362 Разрешает или запрещает использование параметра <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
|
2363 Параметр включаются только при переходе соединения в состояние keep-alive. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2364 </para> |
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> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2367 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2368 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2369 <directive name="tcp_nopush"> |
271 | 2370 <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
|
2371 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2372 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2373 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2374 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2375 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2376 <para> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2377 Разрешает или запрещает использование параметра сокета |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2378 <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
|
2379 <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
|
2380 Параметр включаются только при использовании <link id="sendfile"/>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2381 Включение параметра позволяет |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2382 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2383 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2384 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2385 передавать заголовок ответа и начало файла в одном пакете |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2386 в Linux и во FreeBSD 4.*; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2387 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2388 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2389 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2390 передавать файл полными пакетами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2391 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2392 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2393 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2394 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2395 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2396 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2397 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2398 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2399 <directive name="try_files"> |
364 | 2400 <syntax><value>файл</value> ... <value>uri</value></syntax> |
2401 <syntax><value>файл</value> ... =<value>код</value></syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2402 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2403 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2404 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2405 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2406 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2407 Проверяет существование файлов в заданном порядке и использует |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2408 для обработки запроса первый найденный файл, причём обработка |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2409 делается в контексте этого же location’а. |
271 | 2410 Путь к файлу строится из параметра <value>файл</value> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2411 в соответствии с директивами |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2412 <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
|
2413 С помощью слэша в конце имени можно проверить существование каталога, |
271 | 2414 например, “<literal>$uri/</literal>”. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2415 В случае, если ни один файл не найден, то делается внутреннее |
271 | 2416 перенаправление на <value>uri</value>, заданный последним параметром. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2417 Например: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2418 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2419 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2420 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
|
2421 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2422 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2423 location = /images/default.gif { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2424 expires 30s; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2425 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2426 </example> |
271 | 2427 Последний параметр может также указывать на именованный location, |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2428 как в примерах ниже. |
271 | 2429 С версии 0.7.51 последний параметр может также быть кодом: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2430 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2431 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2432 try_files $uri $uri/index.html $uri.html =404; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2433 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2434 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2435 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2438 Пример использования при проксировании Mongrel: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2439 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2440 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2441 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
|
2442 $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
|
2443 @mongrel; |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2446 location @mongrel { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2447 proxy_pass http://mongrel; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2448 } |
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 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2451 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2452 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2453 Пример использования вместе с Drupal/FastCGI: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2454 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2455 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2456 try_files $uri $uri/ @drupal; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2457 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2458 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2459 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2460 try_files $uri @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2461 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2462 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2463 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2464 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
|
2465 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
|
2466 fastcgi_param QUERY_STRING $args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2467 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2468 ... прочие fastcgi_param |
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 location @drupal { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2472 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2473 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2474 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
|
2475 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
|
2476 fastcgi_param QUERY_STRING q=$uri&$args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2477 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2478 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2479 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2480 </example> |
271 | 2481 В следующем примере директива <literal>try_files</literal> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2482 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2483 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2484 try_files $uri $uri/ @drupal; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2485 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2486 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2487 аналогична директивам |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2488 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2489 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2490 error_page 404 = @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2491 log_not_found off; |
76
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2494 А здесь |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2495 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2496 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2497 try_files $uri @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2498 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2499 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2500 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2501 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2502 |
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 </example> |
271 | 2506 <literal>try_files</literal> проверяет существование PHP-файла, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2507 прежде чем передать запрос FastCGI-серверу. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2508 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2509 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2510 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2511 Пример использования вместе с Wordpress и Joomla: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2512 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2513 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2514 try_files $uri $uri/ @wordpress; |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2517 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2518 try_files $uri @wordpress; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2519 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2520 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2521 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2522 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2523 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2524 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2525 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2526 location @wordpress { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2527 fastcgi_pass ...; |
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 fastcgi_param SCRIPT_FILENAME /path/to/index.php; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2530 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2531 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2532 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2533 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2534 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2535 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2536 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2537 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2538 <directive name="types"> |
108
72524ae53106
Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
2539 <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
|
2540 <default> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2541 text/html html; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2542 image/gif gif; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2543 image/jpeg jpg; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2544 </default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2545 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2546 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2547 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2548 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2549 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2550 Задаёт соответствие расширений имён файлов и MIME-типов ответов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2551 Расширения нечувствительны к регистру символов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2552 Одному MIME-типу может соответствовать несколько расширений, например: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2553 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2554 types { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2555 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
|
2556 application/octet-stream deb; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2557 application/octet-stream dmg; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2558 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2559 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2560 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2561 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2562 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2563 Достаточно полная таблица соответствий входит в дистрибутив nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2564 и находится в файле <path>conf/mime.types</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2565 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2566 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2567 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2568 Для того, чтобы для определённого location’а для всех ответов |
271 | 2569 выдавался 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
|
2570 можно использовать следующее: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2571 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2572 location /download/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2573 types { } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2574 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
|
2575 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2576 </example> |
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 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2579 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2580 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2581 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2582 <directive name="types_hash_bucket_size"> |
271 | 2583 <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
|
2584 <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
|
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> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2587 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2588 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2589 <para> |
253
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 Значение по умолчанию зависит от размера строки кэша процессора. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2592 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2593 <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
|
2594 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2595 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2596 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2597 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2598 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2599 <directive name="types_hash_max_size"> |
271 | 2600 <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
|
2601 <default>1024</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2602 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2603 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2604 <context>location</context> |
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 <para> |
271 | 2607 Задаёт максимальный <value>размер</value> хэш-таблиц типов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2608 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2609 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2610 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2611 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2612 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2613 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2614 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2615 <directive name="underscores_in_headers"> |
271 | 2616 <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
|
2617 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2618 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2619 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2620 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2621 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2622 Разрешает или запрещает использование символов подчёркивания в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2623 полях заголовка запроса клиента. |
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 помечаются как недопустимые и подпадают под действие директивы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2626 <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
|
2627 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2628 |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2629 <para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2630 Директива может быть указана на уровне <link id="server"/> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2631 в сервере по умолчанию. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2632 В этом случае её значение распространяется на все виртуальные серверы, |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2633 слушающие на том же адресе и порту. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2634 </para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2635 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2636 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2637 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2638 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2639 <directive name="variables_hash_bucket_size"> |
271 | 2640 <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
|
2641 <default>64</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2642 <context>http</context> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2645 Задаёт размер корзины в хэш-таблице переменных. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2646 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2647 <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
|
2648 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2649 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2650 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2653 <directive name="variables_hash_max_size"> |
271 | 2654 <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
|
2655 <default>512</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2656 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2657 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2658 <para> |
271 | 2659 Задаёт максимальный <value>размер</value> хэш-таблицы переменных. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2660 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2661 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2662 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2663 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2664 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2665 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2666 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2667 |
364 | 2668 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2669 <section id="variables" name="Встроенные переменные"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2670 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2671 <para> |
364 | 2672 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные |
2673 переменные, имена которых совпадают с именами переменных веб-сервера Apache. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2674 Прежде всего, это переменные, представляющие из себя поля заголовка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2675 запроса клиента, такие как <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
|
2676 и тому подобное. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2677 Кроме того, есть и другие переменные: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2678 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2679 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2680 <tag-name id="var_arg_"><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
|
2681 <tag-desc> |
271 | 2682 аргумент <value>имя</value> в строке запроса |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2683 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2684 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2685 <tag-name id="var_args"><var>$args</var></tag-name> |
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-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2689 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2690 <tag-name id="var_binary_remote_addr"><var>$binary_remote_addr</var></tag-name> |
253
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 адрес клиента в бинарном виде, длина значения всегда 4 байта |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2693 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2694 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2695 <tag-name id="var_body_bytes_sent"><var>$body_bytes_sent</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2696 <tag-desc> |
769
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2697 число байт, переданное клиенту, без учёта заголовка ответа; |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2698 переменная совместима с параметром “<literal>%B</literal>” модуля Apache |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2699 <literal>mod_log_config</literal> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2700 </tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2701 |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2702 <tag-name id="var_bytes_sent"><var>$bytes_sent</var></tag-name> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2703 <tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2704 число байт, переданное клиенту (1.3.8, 1.2.5) |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2705 </tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2706 |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2707 <tag-name id="var_connection"><var>$connection</var></tag-name> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2708 <tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2709 порядковый номер соединения (1.3.8, 1.2.5) |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2710 </tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2711 |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2712 <tag-name id="var_connection_requests"><var>$connection_requests</var></tag-name> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2713 <tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2714 текущее число запросов в соединении (1.3.8, 1.2.5) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2715 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2716 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2717 <tag-name id="var_content_length"><var>$content_length</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2718 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2719 поле <header>Content-Length</header> заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2720 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2721 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2722 <tag-name id="var_content_type"><var>$content_type</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2723 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2724 поле <header>Content-Type</header> заголовка запроса |
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 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2727 <tag-name id="var_cookie_"><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
|
2728 <tag-desc> |
271 | 2729 cookie <value>имя</value> |
253
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 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2732 <tag-name id="var_document_root"><var>$document_root</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2733 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2734 значение директивы <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
|
2735 для текущего запроса |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2736 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2737 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2738 <tag-name id="var_document_uri"><var>$document_uri</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2739 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2740 то же, что и <var>$uri</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2741 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2742 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2743 <tag-name id="var_host"><var>$host</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2744 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2745 поле <header>Host</header> заголовка запроса, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2746 или имя сервера, соответствующего запросу, если этого поля нет |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2747 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2748 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2749 <tag-name id="var_hostname"><var>$hostname</var></tag-name> |
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-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2753 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2754 <tag-name id="var_http_"><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
|
2755 <tag-desc> |
448
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2756 произвольное поле заголовка запроса; |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2757 последняя часть имени переменной соответствует имени поля, приведённому |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2758 к нижнему регистру, с заменой символов тире на символы подчёркивания |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2759 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2760 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2761 <tag-name id="var_https"><var>$https</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2762 <tag-desc> |
271 | 2763 “<literal>on</literal>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2764 если соединение работает в режиме SSL, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2765 либо пустая строка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2766 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2767 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2768 <tag-name id="var_is_args"><var>$is_args</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2769 <tag-desc> |
271 | 2770 “<literal>?</literal>”, если в строке запроса есть аргументы, |
253
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-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2773 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2774 <tag-name id="var_limit_rate"><var>$limit_rate</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2775 <tag-desc> |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
2776 установка этой переменной позволяет ограничивать скорость |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
2777 передачи ответа, см. <link id="limit_rate"/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2778 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2779 |
771
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2780 <tag-name id="var_msec"><var>$msec</var></tag-name> |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2781 <tag-desc> |
779
32b8498cfb40
$msec and $request_time have become generic variables in 1.2.6.
Ruslan Ermilov <ru@nginx.com>
parents:
771
diff
changeset
|
2782 текущее время в секундах с точностью до миллисекунд (1.3.9, 1.2.6) |
771
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2783 </tag-desc> |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2784 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2785 <tag-name id="var_nginx_version"><var>$nginx_version</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2786 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2787 версия nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2788 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2789 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2790 <tag-name id="var_pid"><var>$pid</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2791 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2792 номер (PID) рабочего процесса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2793 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2794 |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2795 <tag-name id="var_pipe"><var>$pipe</var></tag-name> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2796 <tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2797 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>” |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
2798 (1.3.12, 1.2.7) |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2799 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2800 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2801 <tag-name id="var_query_string"><var>$query_string</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2802 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2803 то же, что и <var>$args</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2804 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2805 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2806 <tag-name id="var_realpath_root"><var>$realpath_root</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2807 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2808 абсолютный путь, соответствующий |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2809 значению директивы <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
|
2810 для текущего запроса, |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
2811 в котором все символические ссылки преобразованы в реальные пути |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2812 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2813 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2814 <tag-name id="var_remote_addr"><var>$remote_addr</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2815 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2816 адрес клиента |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2817 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2818 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2819 <tag-name id="var_remote_port"><var>$remote_port</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2820 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2821 порт клиента |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2822 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2823 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2824 <tag-name id="var_remote_user"><var>$remote_user</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2825 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2826 имя пользователя, использованное в Basic аутентификации |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2827 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2828 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2829 <tag-name id="var_request"><var>$request</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2830 <tag-desc> |
431
0412333658fe
Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents:
429
diff
changeset
|
2831 первоначальная строка запроса целиком |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2832 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2833 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2834 <tag-name id="var_request_body"><var>$request_body</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2835 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2836 тело запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2837 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2838 Значение переменной появляется в location’ах, обрабатываемых |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2839 директивами |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
2840 <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
|
2841 и |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2842 <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
|
2843 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2844 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2845 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2846 <tag-name id="var_request_body_file"><var>$request_body_file</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2847 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2848 имя временного файла, в котором хранится тело запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2849 <para> |
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 Для того, чтобы тело запроса всегда записывалось в файл, |
406
98dac2bd7598
Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents:
400
diff
changeset
|
2852 следует включить <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
|
2853 При передаче имени временного файла в проксированном запросе |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2854 или в запросе к FastCGI-серверу следует запретить передачу самого |
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 <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
|
2857 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
|
2858 или |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2859 <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
|
2860 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
|
2861 соответственно. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2862 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2863 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2864 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2865 <tag-name id="var_request_completion"><var>$request_completion</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2866 <tag-desc> |
271 | 2867 “<literal>OK</literal>” если запрос завершился, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2868 либо пустая строка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2869 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2870 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2871 <tag-name id="var_request_filename"><var>$request_filename</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2872 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2873 путь к файлу для текущего запроса, формируемый из директив |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2874 <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
|
2875 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2876 |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2877 <tag-name id="var_request_length"><var>$request_length</var></tag-name> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2878 <tag-desc> |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
2879 длина запроса (включая строку запроса, заголовок и тело запроса) |
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
2880 (1.3.12, 1.2.7) |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2881 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2882 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2883 <tag-name id="var_request_method"><var>$request_method</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2884 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2885 метод запроса, обычно |
271 | 2886 “<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
|
2887 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2888 |
771
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2889 <tag-name id="var_request_time"><var>$request_time</var></tag-name> |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2890 <tag-desc> |
779
32b8498cfb40
$msec and $request_time have become generic variables in 1.2.6.
Ruslan Ermilov <ru@nginx.com>
parents:
771
diff
changeset
|
2891 время обработки запроса в секундах с точностью до миллисекунд |
32b8498cfb40
$msec and $request_time have become generic variables in 1.2.6.
Ruslan Ermilov <ru@nginx.com>
parents:
771
diff
changeset
|
2892 (1.3.9, 1.2.6); |
771
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2893 время, прошедшее с момента чтения первых байт от клиента |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2894 </tag-desc> |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
2895 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2896 <tag-name id="var_request_uri"><var>$request_uri</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2897 <tag-desc> |
431
0412333658fe
Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents:
429
diff
changeset
|
2898 первоначальный URI запроса целиком (с аргументами) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2899 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2900 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2901 <tag-name id="var_scheme"><var>$scheme</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2902 <tag-desc> |
271 | 2903 схема запроса, “<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
|
2904 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2905 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2906 <tag-name id="var_sent_http_"><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
|
2907 <tag-desc> |
448
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2908 произвольное поле заголовка ответа; |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2909 последняя часть имени переменной соответствует имени поля, приведённому |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
2910 к нижнему регистру, с заменой символов тире на символы подчёркивания |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2911 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2912 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2913 <tag-name id="var_server_addr"><var>$server_addr</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2914 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2915 адрес сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2916 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2917 Получение значения этой переменной обычно требует одного системного вызова. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2918 Чтобы избежать системного вызова, в директивах <link id="listen"/> |
271 | 2919 следует указывать адреса и использовать параметр <literal>bind</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2920 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2921 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2922 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2923 <tag-name id="var_server_name"><var>$server_name</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2924 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2925 имя сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2926 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2927 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2928 <tag-name id="var_server_port"><var>$server_port</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2929 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2930 порт сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2931 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2932 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2933 <tag-name id="var_server_protocol"><var>$server_protocol</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2934 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2935 протокол сервера, обычно |
271 | 2936 “<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
|
2937 или |
271 | 2938 “<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
|
2939 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2940 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2941 <tag-name id="var_status"><var>$status</var></tag-name> |
541
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2942 <tag-desc> |
769
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
2943 статус ответа (1.3.2, 1.2.2) |
541
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2944 </tag-desc> |
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
2945 |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2946 <tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2947 <tag-desc> |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
2948 локальное время в формате по стандарту ISO 8601 (1.3.12, 1.2.7) |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2949 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2950 |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2951 <tag-name id="var_time_local"><var>$time_local</var></tag-name> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2952 <tag-desc> |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
2953 локальное время в Common Log Format (1.3.12, 1.2.7) |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2954 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
2955 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2956 <tag-name id="var_tcpinfo_"> |
453
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2957 <var>$tcpinfo_rtt</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2958 <var>$tcpinfo_rttvar</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2959 <var>$tcpinfo_snd_cwnd</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2960 <var>$tcpinfo_rcv_space</var> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2961 </tag-name> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2962 <tag-desc> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2963 информация о клиентском TCP-соединении; доступна на системах, |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2964 поддерживающих параметр сокета <c-def>TCP_INFO</c-def> |
453
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2965 </tag-desc> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
2966 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
2967 <tag-name id="var_uri"><var>$uri</var></tag-name> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2968 <tag-desc> |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2969 текущий 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
|
2970 <para> |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2971 Значение <var>$uri</var> может изменяться в процессе обработки запроса, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2972 например, при внутренних перенаправлениях |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
2973 или при использовании индексных файлов. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2974 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2975 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2976 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2977 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2978 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2979 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2980 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2981 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2982 </module> |