Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_core_module.xml @ 2764:bc9c5d11b67c
Updated OpenSSL version used for win32 builds.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 31 Aug 2021 17:11:05 +0100 |
parents | 00afc7c4d4df |
children | 4934cbc1db19 |
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" |
2724
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2707
diff
changeset
|
13 rev="97"> |
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 |
1879
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
17 <directive name="absolute_redirect"> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
18 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
19 <default>on</default> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
20 <context>http</context> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
21 <context>server</context> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
22 <context>location</context> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
23 <appeared-in>1.11.8</appeared-in> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
24 |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
25 <para> |
1881
ce0190c094ba
Fixed grammar and sigle quote in absolute_redirect.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1879
diff
changeset
|
26 Если запрещено, то перенаправления, выдаваемые nginx’ом, будут относительными. |
1879
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
27 </para> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
28 |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
29 <para> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
30 См. также директивы <link id="server_name_in_redirect"/> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
31 и <link id="port_in_redirect"/>. |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
32 </para> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
33 |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
34 </directive> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
35 |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
36 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
37 <directive name="aio"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
38 <syntax> |
364 | 39 <literal>on</literal> | |
1436 | 40 <literal>off</literal> | |
41 <literal>threads</literal>[<literal>=</literal><value>pool</value>]</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
42 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
43 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
44 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
45 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
46 <appeared-in>0.8.11</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
47 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
48 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
49 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO) |
1432
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
50 во FreeBSD и Linux: |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
51 <example> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
52 location /video/ { |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
53 aio on; |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
54 output_buffers 1 64k; |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
55 } |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
56 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
57 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
58 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
59 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
60 Во FreeBSD AIO можно использовать, начиная с FreeBSD 4.3. |
1859
5cd4964fbc5f
Updated AIO description for FreeBSD 11.0 and upwards.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1827
diff
changeset
|
61 До FreeBSD 11.0 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
62 AIO можно либо собрать в ядре статически: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
63 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
64 options VFS_AIO |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
65 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
66 либо загрузить динамически через загружаемый модуль ядра: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
67 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
68 kldload aio |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
71 |
1430
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
72 <!-- |
76
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 В версиях FreeBSD 5 и 6 включение AIO статически или динамически |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
75 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
76 будет использовать блокировку Giant, что может негативно сказаться на |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
77 производительности системы в целом. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
78 Это ограничение устранено во 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
|
79 и во FreeBSD 7. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
80 Однако, начиная с FreeBSD 5.3 есть возможность включать AIO, |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
81 не связывая сетевую подсистему блокировкой Giant — для этого модуль |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
82 AIO нужно подгружать уже после загрузки ядра. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
83 В этом случае в <path>/var/log/messages</path> появится следующее сообщение: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
84 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
85 WARNING: Network stack Giant-free, but aio requires Giant. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
86 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
87 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
88 которое можно смело проигнорировать. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
89 <note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
90 Требование использовать блокировку Giant в AIO связано с тем, что |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
91 FreeBSD поддерживает асинхронные вызовы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
92 <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
|
93 и |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
94 <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
|
95 для работы с сокетами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
96 Но поскольку nginx использует AIO только для работы с диском, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
97 то проблем не возникает. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
98 </note> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
99 </para> |
1430
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
100 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
101 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
102 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
103 В Linux AIO можно использовать только начиная с версии ядра 2.6.22. |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
104 Кроме того, необходимо также дополнительно включить |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
105 <link id="directio"/>, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
106 иначе чтение будет блокирующимся: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
107 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
108 location /video/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
109 aio on; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
110 directio 512; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
111 output_buffers 1 128k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
112 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
113 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
114 </para> |
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 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
117 В Linux |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
118 <link id="directio"/> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
119 можно использовать только для чтения блоков, выравненных |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
120 на границу 512 байт (или 4К для XFS). |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
121 Невыравненный конец файла будет читаться блокированно. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
122 То же относится к запросам с указанием диапазона запрашиваемых байт |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
123 (byte-range requests) и к запросам FLV не с начала файла: чтение |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
124 невыравненных начала и конца ответа будет блокирующимся. |
1430
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
125 </para> |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
126 |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
127 <para> |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
128 При одновременном включении AIO и <link id="sendfile"/> в Linux |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
129 для файлов, размер которых больше либо равен указанному |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
130 в директиве <link id="directio"/>, будет использоваться AIO, |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
131 а для файлов меньшего размера |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
132 или при выключенном <link id="directio"/> — <link id="sendfile"/>: |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
133 <example> |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
134 location /video/ { |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
135 sendfile on; |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
136 aio on; |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
137 directio 8m; |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
138 } |
0eb8e261f349
AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents:
1279
diff
changeset
|
139 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
140 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
141 |
1432
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
142 <para> |
1436 | 143 Кроме того, читать и <link id="sendfile">отправлять</link> |
144 файлы можно в многопоточном режиме (1.7.11), | |
145 не блокируя при этом рабочий процесс: | |
146 <example> | |
147 location /video/ { | |
148 sendfile on; | |
149 aio threads; | |
150 } | |
151 </example> | |
152 Операции чтения или отправки файлов будут обрабатываться потоками из указанного | |
153 <link doc="../ngx_core_module.xml" id="thread_pool">пула</link>. | |
154 Если пул потоков не задан явно, | |
155 используется пул с именем “<literal>default</literal>”. | |
156 Имя пула может быть задано при помощи переменных: | |
157 <example> | |
158 aio threads=pool$disk; | |
159 </example> | |
160 По умолчанию поддержка многопоточности выключена, её сборку следует | |
161 разрешить с помощью конфигурационного параметра | |
162 <literal>--with-threads</literal>. | |
163 В настоящий момент многопоточность совместима только с методами | |
164 <link doc="../events.xml" id="epoll"/>, | |
165 <link doc="../events.xml" id="kqueue"/> | |
166 и | |
167 <link doc="../events.xml" id="eventport"/>. | |
168 Отправка файлов в многопоточном режиме поддерживается только на Linux. | |
169 </para> | |
170 | |
171 <para> | |
1432
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
172 См. также директиву <link id="sendfile"/>. |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
173 </para> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
174 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
175 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
176 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
177 |
1664
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
178 <directive name="aio_write"> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
179 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
180 <default>off</default> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
181 <context>http</context> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
182 <context>server</context> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
183 <context>location</context> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
184 <appeared-in>1.9.13</appeared-in> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
185 |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
186 <para> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
187 При включённом <link id="aio"/> разрешает его использование для записи файлов. |
1665
57b53a0818df
Slightly paraphrased aio_write description for better perception.
Ruslan Ermilov <ru@nginx.com>
parents:
1664
diff
changeset
|
188 В настоящий момент это работает только при использовании |
1664
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
189 <literal>aio threads</literal> |
1665
57b53a0818df
Slightly paraphrased aio_write description for better perception.
Ruslan Ermilov <ru@nginx.com>
parents:
1664
diff
changeset
|
190 и ограничено записью временных файлов с данными, |
1664
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
191 полученными от проксируемых серверов. |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
192 </para> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
193 |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
194 </directive> |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
195 |
1a05fd32dca8
Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1636
diff
changeset
|
196 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
197 <directive name="alias"> |
271 | 198 <syntax><value>путь</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
199 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
200 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
201 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
202 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
203 Задаёт замену для указанного location’а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
204 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
205 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
206 location /i/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
207 alias /data/w3/images/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
208 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
209 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
210 на запрос |
271 | 211 “<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
|
212 <path>/data/w3/images/top.gif</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
213 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
214 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
215 <para> |
271 | 216 В значении параметра <value>путь</value> можно использовать переменные, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
217 кроме <var>$document_root</var> и <var>$realpath_root</var>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
218 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
219 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
220 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
221 Если <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
|
222 регулярным выражением, то регулярное выражение должно содержать |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
223 выделения, а сам <literal>alias</literal> — ссылки на эти выделения |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
224 (0.7.40), например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
225 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
226 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
|
227 alias /data/w3/images/$1; |
76
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
230 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
231 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
232 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
233 Если location и последняя часть значения директивы совпадают: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
234 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
235 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
236 alias /data/w3/images/; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
237 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
238 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
239 то лучше воспользоваться директивой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
240 <link id="root"/>: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
241 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
242 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
243 root /data/w3; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
244 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
245 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
246 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
247 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
248 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
249 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
250 |
2523
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
251 <directive name="auth_delay"> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
252 <syntax><value>время</value></syntax> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
253 <default>0s</default> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
254 <context>http</context> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
255 <context>server</context> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
256 <context>location</context> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
257 <appeared-in>1.17.10</appeared-in> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
258 |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
259 <para> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
260 Задерживает обработку неавторизованных запросов с кодом ответа 401 |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
261 для предотвращения атак по времени в случае ограничения доступа по |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
262 <link doc="ngx_http_auth_basic_module.xml">паролю</link>, по |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
263 <link doc="ngx_http_auth_request_module.xml">результату подзапроса</link> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
264 или по <link doc="ngx_http_auth_jwt_module.xml">JWT</link>. |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
265 </para> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
266 |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
267 </directive> |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
268 |
2bb06b3fbcc5
Documented the "auth_delay" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2458
diff
changeset
|
269 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
270 <directive name="chunked_transfer_encoding"> |
271 | 271 <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
|
272 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
273 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
274 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
275 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
276 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
277 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
278 Позволяет запретить формат передачи данных частями (chunked transfer |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
279 encoding) в HTTP/1.1. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
280 Это может понадобиться при использовании программ, не поддерживающих |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
281 chunked encoding, несмотря на требования стандарта. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
282 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
283 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
284 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
285 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
286 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
287 <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
|
288 |
271 | 289 <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
|
290 <default>8k|16k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
291 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
292 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
293 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
294 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
295 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
296 Задаёт размер буфера для чтения тела запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
297 Если тело запроса больше заданного буфера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
298 то всё тело запроса или только его часть записывается во |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
299 <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
|
300 По умолчанию размер одного буфера равен двум размерам страницы. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
301 На 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
|
302 На других 64-битных платформах это обычно 16K. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
303 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
304 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
305 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
308 <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
|
309 <syntax> |
364 | 310 <literal>on</literal> | |
311 <literal>clean</literal> | | |
312 <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
|
313 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
314 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
315 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
316 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
317 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
318 <para> |
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 Директиву можно использовать для отладки и при использовании переменной |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
321 <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
|
322 или метода |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
323 <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
|
324 модуля |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
325 <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
|
326 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
327 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
328 <para> |
271 | 329 При установке значения <literal>on</literal> временные файлы |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
330 по окончании обработки запроса не удаляются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
331 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
332 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
333 <para> |
271 | 334 Значение <literal>clean</literal> разрешает удалять временные файлы, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
335 оставшиеся по окончании обработки запроса. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
336 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
337 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
338 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
339 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
340 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
341 <directive name="client_body_in_single_buffer"> |
271 | 342 <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
|
343 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
344 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
345 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
346 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
347 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
348 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
349 Определяет, сохранять ли всё тело запроса клиента в одном буфере. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
350 Директива рекомендуется при использовании переменной |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
351 <var>$request_body</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
352 для уменьшения требуемого числа операций копирования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
353 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
354 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
355 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
356 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
357 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
358 <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
|
359 <syntax> |
364 | 360 <value>путь</value> |
361 [<value>уровень1</value> | |
362 [<value>уровень2</value> | |
363 [<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
|
364 <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
|
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 Задаёт каталог для хранения временных файлов с телами запросов клиентов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
371 В каталоге может использоваться иерархия подкаталогов до трёх уровней. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
372 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
373 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
374 client_body_temp_path /spool/nginx/client_temp 1 2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
375 </example> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
376 путь к временному файлу будет следующего вида: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
377 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
378 /spool/nginx/client_temp/7/45/00000123457 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
379 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
380 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
381 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
382 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
383 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
384 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
385 <directive name="client_body_timeout"> |
271 | 386 <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
|
387 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
388 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
389 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
390 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
391 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
392 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
393 Задаёт таймаут при чтении тела запроса клиента. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
394 Таймаут устанавливается не на всю передачу тела запроса, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
395 а только между двумя последовательными операциями чтения. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
396 Если по истечении этого времени клиент ничего не передаст, |
2220
896562a1ccde
Fixed description of client_header_timeout and client_body_timeout.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2206
diff
changeset
|
397 обработка запроса прекращается с ошибкой |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
398 <http-status code="408" text="Request Time-out"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
399 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
402 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
403 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
404 <directive name="client_header_buffer_size"> |
271 | 405 <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
|
406 <default>1k</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
407 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
408 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
409 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
410 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
411 Задаёт размер буфера для чтения заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
412 Для большинства запросов достаточно буфера размером в 1K байт. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
413 Однако если в запросе есть длинные cookies, или же запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
414 пришёл от WAP-клиента, то он может не поместиться в 1K. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
415 Поэтому, если строка запроса или поле заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
416 не помещаются полностью в этот буфер, то выделяются буферы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
417 большего размера, задаваемые директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
418 <link id="large_client_header_buffers"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
419 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
420 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
421 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
422 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
423 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
424 <directive name="client_header_timeout"> |
271 | 425 <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
|
426 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
427 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
428 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
429 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
430 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
431 Задаёт таймаут при чтении заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
432 Если по истечении этого времени клиент не передаст полностью заголовок, |
2220
896562a1ccde
Fixed description of client_header_timeout and client_body_timeout.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2206
diff
changeset
|
433 обработка запроса прекращается с ошибкой |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
434 <http-status code="408" text="Request Time-out"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
435 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
436 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
437 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
438 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
439 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
440 <directive name="client_max_body_size"> |
271 | 441 <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
|
442 <default>1m</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
443 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
444 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
445 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
446 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
447 <para> |
2657
679fb7712ab4
Updated client_max_body_size for chunked encoding and HTTP/2.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2593
diff
changeset
|
448 Задаёт максимально допустимый размер тела запроса клиента. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
449 Если размер больше заданного, то клиенту возвращается ошибка |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
450 <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
|
451 Следует иметь в виду, что |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
452 <!--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
|
453 эту ошибку<!--/link-->. |
271 | 454 Установка параметра <value>размер</value> в 0 отключает |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
455 проверку размера тела запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
456 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
457 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
458 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
459 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
460 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
461 <directive name="connection_pool_size"> |
271 | 462 <syntax><value>размер</value></syntax> |
1619
88ad8fcea975
Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1597
diff
changeset
|
463 <default>256|512</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
464 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
465 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
466 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
467 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
468 Позволяет производить точную настройку выделения памяти |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
469 под конкретные соединения. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
470 Эта директива не оказывает существенного влияния на |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
471 производительность, и её не следует использовать. |
1619
88ad8fcea975
Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1597
diff
changeset
|
472 По умолчанию размер равен |
88ad8fcea975
Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1597
diff
changeset
|
473 256 байт на 32-битных платформах и 512 байт на 64-битных платформах. |
88ad8fcea975
Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1597
diff
changeset
|
474 <note> |
88ad8fcea975
Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1597
diff
changeset
|
475 До версии 1.9.8 по умолчанию использовалось значение 256 на всех платформах. |
88ad8fcea975
Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1597
diff
changeset
|
476 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
477 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
478 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
479 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
480 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
481 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
482 <directive name="default_type"> |
271 | 483 <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
|
484 <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
|
485 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
486 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
487 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
488 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
489 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
490 Задаёт MIME-тип ответов по умолчанию. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
491 Соответствие расширений имён файлов MIME-типу ответов задаётся |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
492 с помощью директивы <link id="types"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
493 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
494 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
495 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
496 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
497 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
498 <directive name="directio"> |
271 | 499 <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
|
500 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
501 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
502 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
503 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
504 <appeared-in>0.7.7</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
505 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
506 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
507 Разрешает использовать флаги |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
508 <c-def>O_DIRECT</c-def> (FreeBSD, Linux), |
1911
f024ac0ec5c7
Apple rebranded Mac OS X to macOS.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1904
diff
changeset
|
509 <c-def>F_NOCACHE</c-def> (macOS) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
510 или функцию <c-func>directio</c-func> (Solaris) |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
511 при чтении файлов, размер которых больше либо равен указанному. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
512 Директива автоматически запрещает (0.7.15) использование |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
513 <link id="sendfile"/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
514 для данного запроса. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
515 Рекомендуется использовать для больших файлов: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
516 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
517 directio 4m; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
518 </example> |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
519 или при использовании <link id="aio"/> в Linux. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
520 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
521 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
522 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
523 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
524 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
525 <directive name="directio_alignment"> |
271 | 526 <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
|
527 <default>512</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
528 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
529 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
530 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
531 <appeared-in>0.8.11</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
532 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
533 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
534 Устанавливает выравнивание для |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
535 <link id="directio"/>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
536 В большинстве случаев достаточно 512-байтового выравнивания, однако |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
537 при использовании XFS под Linux его нужно увеличить до 4K. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
538 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
539 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
540 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
541 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
542 |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
543 <directive name="disable_symlinks"> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
544 <syntax><literal>off</literal></syntax> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
545 <syntax> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
546 <literal>on</literal> | |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
547 <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
|
548 [<literal>from</literal>=<value>часть</value>]</syntax> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
549 <default>off</default> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
550 <context>http</context> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
551 <context>server</context> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
552 <context>location</context> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
553 <appeared-in>1.1.15</appeared-in> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
554 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
555 <para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
556 Определяет, как следует поступать с символическими ссылками |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
557 при открытии файлов: |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
558 <list type="tag"> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
559 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
560 <tag-name><literal>off</literal></tag-name> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
561 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
562 Символические ссылки в пути допускаются и не проверяются. |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
563 Это стандартное поведение. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
564 </tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
565 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
566 <tag-name><literal>on</literal></tag-name> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
567 <tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
568 Если любой компонент пути является символической ссылкой, |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
569 доступ к файлу запрещается. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
570 </tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
571 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
572 <tag-name><literal>if_not_owner</literal></tag-name> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
573 <tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
574 Доступ к файлу запрещается, если любой компонент пути |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
575 является символической ссылкой, а ссылка и объект, на |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
576 который она ссылается, имеют разных владельцев. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
577 </tag-desc> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
578 |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
579 <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
|
580 <tag-desc> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
581 При проверке символических ссылок |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
582 (параметры <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
|
583 обычно проверяются все компоненты пути. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
584 Можно не проверять символические ссылки в начальной части пути, |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
585 указав дополнительно параметр |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
586 <literal>from</literal>=<value>часть</value>. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
587 В этом случае символические ссылки проверяются лишь начиная |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
588 с компонента пути, который следует за заданной начальной частью. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
589 Если значение не является начальной частью проверяемого пути, |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
590 путь проверяется целиком, как если бы этот параметр не был указан вовсе. |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
591 Если значение целиком совпадает с именем файла, |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
592 символические ссылки не проверяются. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
593 В значении параметра можно использовать переменные. |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
594 </tag-desc> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
595 |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
596 </list> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
597 </para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
598 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
599 <para> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
600 Пример: |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
601 <example> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
602 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
|
603 </example> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
604 </para> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
605 |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
606 <para> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
607 Эта директива доступна только на системах, в которых есть |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
608 интерфейсы <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
|
609 К таким системам относятся современные версии FreeBSD, Linux и Solaris. |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
610 </para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
611 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
612 <para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
613 Параметры <literal>on</literal> и <literal>if_not_owner</literal> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
614 требуют дополнительных затрат на обработку. |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
615 <note> |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
616 На системах, не поддерживающих операцию открытия каталогов только для поиска, |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
617 для использования этих параметров требуется, чтобы рабочие процессы |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
618 имели право читать все проверяемые каталоги. |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
619 </note> |
438
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
620 </para> |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
621 |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
622 <para> |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
623 <note> |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
624 Модули |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
625 <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
|
626 <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
|
627 и <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
|
628 в настоящий момент игнорируют эту директиву. |
b27974b92a58
- corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
436
diff
changeset
|
629 </note> |
418
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
630 </para> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
631 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
632 </directive> |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
633 |
2638f67205ee
Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents:
406
diff
changeset
|
634 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
635 <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
|
636 <syntax> |
364 | 637 <value>код</value> ... |
638 [<literal>=</literal>[<value>ответ</value>]] | |
639 <value>uri</value></syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
640 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
641 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
642 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
643 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
644 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
645 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
646 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
647 Задаёт URI, который будет показываться для указанных ошибок. |
1826
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
648 В значении <value>uri</value> можно использовать переменные. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
649 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
650 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
651 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
652 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
653 <example> |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
654 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
|
655 error_page 500 502 503 504 /50x.html; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
656 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
657 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
658 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
659 <para> |
1827
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
660 При этом делается внутреннее перенаправление на указанный <value>uri</value>, |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
661 а метод запроса клиента меняется на “<literal>GET</literal>” |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
662 (для всех методов, отличных от |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
663 “<literal>GET</literal>” и “<literal>HEAD</literal>”). |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
664 </para> |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
665 |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
666 <para> |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
667 Кроме того, можно поменять код ответа на другой, |
711
1f383a8bccdb
Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
709
diff
changeset
|
668 используя синтаксис вида “<literal>=</literal><value>ответ</value>”, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
669 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
670 error_page 404 =200 /empty.gif; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
671 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
672 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
673 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
674 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
675 Если ошибочный ответ обрабатывается проксированным сервером или |
2134
4cafd82e5007
Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2125
diff
changeset
|
676 FastCGI/uwsgi/SCGI/gRPC-сервером, |
4cafd82e5007
Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2125
diff
changeset
|
677 и этот сервер может вернуть разные коды ответов, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
678 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
679 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
680 error_page 404 = /404.php; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
681 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
682 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
683 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
684 <para> |
1827
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
685 Если при внутреннем перенаправлении не нужно менять URI и метод, |
64e2b8c5200d
Documented request method change by error_page in /uri redirection.
Ruslan Ermilov <ru@nginx.com>
parents:
1826
diff
changeset
|
686 то можно передать обработку ошибки в именованный location: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
687 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
688 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
689 error_page 404 = @fallback; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
690 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
691 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
692 location @fallback { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
693 proxy_pass http://backend; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
694 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
695 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
696 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
697 |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
698 <para> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
699 <note> |
1826
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
700 Если при обработке <value>uri</value> происходит ошибка, |
948 | 701 клиенту возвращается ответ с кодом последней случившейся ошибки. |
679
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
702 </note> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
703 </para> |
9888364847b7
Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents:
674
diff
changeset
|
704 |
1826
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
705 <para> |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
706 Также существует возможность использовать перенаправления URL для обработки |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
707 ошибок: |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
708 <example> |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
709 error_page 403 http://example.com/forbidden.html; |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
710 error_page 404 =301 http://example.com/notfound.html; |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
711 </example> |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
712 В этом случае по умолчанию клиенту возвращается код ответа 302. |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
713 Его можно изменить только на один из кодов ответа, относящихся к |
1964
2a3c58dcb3e8
Documented support for the 308 Permanent Redirect.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1953
diff
changeset
|
714 перенаправлениям (301, 302, 303, 307 и 308). |
2039
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
715 <note> |
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
716 До версий 1.1.16 и 1.0.13 код 307 не обрабатывался как перенаправление. |
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
717 </note> |
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
718 |
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
719 <note> |
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
720 До версии 1.13.0 код 308 не обрабатывался как перенаправление. |
d2969b2f69ae
Added history notes about codes 201, 307, and 308.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2036
diff
changeset
|
721 </note> |
1826
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
722 </para> |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
723 |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
724 <para> |
2593
eeed494bba51
Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents:
2567
diff
changeset
|
725 Директивы наследуются с предыдущего уровня конфигурации при условии, что |
eeed494bba51
Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents:
2567
diff
changeset
|
726 на данном уровне не описаны свои директивы <literal>error_page</literal>. |
1826
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
727 </para> |
da6a3e401b26
Slightly reformatted the error_page description.
Ruslan Ermilov <ru@nginx.com>
parents:
1770
diff
changeset
|
728 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
729 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
730 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
731 |
576
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
732 <directive name="etag"> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
733 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
734 <default>on</default> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
735 <context>http</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
736 <context>server</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
737 <context>location</context> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
738 <appeared-in>1.3.3</appeared-in> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
739 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
740 <para> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
741 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
742 заголовка ответа для статических ресурсов. |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
743 </para> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
744 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
745 </directive> |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
746 |
cac22cc79afd
Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
566
diff
changeset
|
747 |
651
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
748 <directive name="http"> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
749 <syntax block="yes"/> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
750 <default/> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
751 <context>main</context> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
752 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
753 <para> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
754 Предоставляет контекст конфигурационного файла, в котором указываются |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
755 директивы HTTP-сервера. |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
756 </para> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
757 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
758 </directive> |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
759 |
eba81bfb6aaf
Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents:
646
diff
changeset
|
760 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
761 <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
|
762 <syntax> |
364 | 763 <literal>off</literal> | |
764 <literal>exact</literal> | | |
765 <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
|
766 <default>exact</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
767 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
768 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
769 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
770 <appeared-in>0.7.24</appeared-in> |
76
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 Определяет, как сравнивать время модификации ответа с |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
774 временем в поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
775 <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
|
776 заголовка запроса: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
777 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
778 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
779 |
271 | 780 <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
|
781 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
782 не проверять поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
783 <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
|
784 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
785 |
271 | 786 <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
|
787 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
788 точное совпадение; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
789 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
790 |
271 | 791 <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
|
792 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
793 время модификации ответа меньше или равно времени, заданному в поле |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
794 <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
|
795 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
796 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
797 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
798 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
799 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
800 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
801 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
802 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
803 <directive name="ignore_invalid_headers"> |
271 | 804 <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
|
805 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
806 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
807 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
808 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
809 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
810 Если включено, nginx игнорирует поля заголовка с недопустимыми именами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
811 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
812 и возможно знаков подчёркивания (последнее контролируется директивой |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
813 <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
|
814 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
815 |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
816 <para> |
1023
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
817 Если директива указана на уровне <link id="server"/>, |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
818 её значение используется только в том случае, |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
819 если сервер является сервером по умолчанию. |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
820 Указанное значение распространяется на все виртуальные серверы, |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
821 слушающие на том же адресе и порту. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
822 </para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
823 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
824 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
825 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
826 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
827 <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
|
828 <syntax/> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
829 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
830 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
831 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
832 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
833 Указывает, что location может использоваться только для внутренних запросов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
834 Для внешних запросов клиенту будет возвращаться ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
835 <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
|
836 Внутренними запросами являются: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
837 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
838 <list type="bullet"> |
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 <listitem> |
429
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
841 запросы, перенаправленные директивами |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
842 <link id="error_page"/>, |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
843 <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
|
844 <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
|
845 <link id="try_files"/>; |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
846 </listitem> |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
847 |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
848 <listitem> |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
849 запросы, перенаправленные с помощью поля |
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
850 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
851 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
852 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
853 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
854 подзапросы, формируемые командой |
271 | 855 “<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
|
856 модуля |
2036
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
857 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>, |
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
858 директивами модуля |
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
859 <link doc="ngx_http_addition_module.xml">ngx_http_addition_module</link>, |
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
860 а также директивами |
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
861 <link doc="ngx_http_auth_request_module.xml" id="auth_request"/> и |
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
862 <link doc="ngx_http_mirror_module.xml" id="mirror"/>; |
ee0aeddbe8a2
Updated types of subrequests allowed in the internal location.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2003
diff
changeset
|
863 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
864 </listitem> |
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 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
867 запросы, изменённые директивой |
429
2b9507b2cdf3
List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents:
426
diff
changeset
|
868 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
869 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
870 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
871 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
872 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
873 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
874 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
875 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
876 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
877 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
|
878 |
2206
5cacd6fffade
Eliminated some examples of unsafe prefix locations.
Ruslan Ermilov <ru@nginx.com>
parents:
2199
diff
changeset
|
879 location = /404.html { |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
880 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
881 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
882 </example> |
674
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
883 <note> |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
884 Для предотвращения зацикливания, которое может возникнуть при |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
885 использовании некорректных конфигураций, количество внутренних |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
886 перенаправлений ограничено десятью. |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
887 По достижении этого ограничения будет возвращена ошибка |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
888 <http-status code="500" text="Internal Server Error"/>. |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
889 В таком случае в лог-файле ошибок можно увидеть сообщение |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
890 “rewrite or internal redirection cycle”. |
c48c0936b4df
Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents:
659
diff
changeset
|
891 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
892 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
893 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
894 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
895 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
896 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
897 <directive name="keepalive_disable"> |
271 | 898 <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
|
899 <default>msie6</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
900 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
901 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
902 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
903 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
904 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
905 Запрещает keep-alive соединения с некорректно ведущими себя браузерами. |
271 | 906 Параметры <value>браузер</value> указывают, на какие браузеры это |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
907 распространяется. |
271 | 908 Значение <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
|
909 со старыми версиями MSIE после получения запроса POST. |
271 | 910 Значение <literal>safari</literal> запрещает keep-alive соединения |
1911
f024ac0ec5c7
Apple rebranded Mac OS X to macOS.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1904
diff
changeset
|
911 с Safari и подобными им браузерами на macOS и подобных ей ОС. |
271 | 912 Значение <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
|
913 со всеми браузерами. |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
914 <note> |
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
915 До версии 1.1.18 под значение <literal>safari</literal> подпадали |
549 | 916 все Safari и подобные им браузеры на всех ОС, и keep-alive |
467
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
917 соединения с ними были по умолчанию запрещены. |
c505c92c8658
Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
454
diff
changeset
|
918 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
919 </para> |
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 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
922 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
923 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
924 <directive name="keepalive_requests"> |
271 | 925 <syntax><value>число</value></syntax> |
2706
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
926 <default>1000</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
927 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
928 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
929 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
930 <appeared-in>0.8.0</appeared-in> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
933 Задаёт максимальное число запросов, которые можно |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
934 сделать по одному keep-alive соединению. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
935 После того, как сделано максимальное число запросов, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
936 соединение закрывается. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
937 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
938 |
2450
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
939 <para> |
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
940 Периодическое закрытие соединений необходимо для освобождения |
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
941 памяти, выделенной под конкретные соединения. |
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
942 Поэтому использование слишком большого максимального числа запросов |
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
943 может приводить к чрезмерному потреблению памяти и не рекомендуется. |
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
944 </para> |
a26a42699207
Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2424
diff
changeset
|
945 |
2706
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
946 <para> |
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
947 <note> |
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
948 До версии 1.19.10 по умолчанию использовалось значение 100. |
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
949 </note> |
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
950 </para> |
4f44386a16b1
Changed default value of keepalive_requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2705
diff
changeset
|
951 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
952 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
953 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
954 |
2705
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
955 <directive name="keepalive_time"> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
956 <syntax><value>время</value></syntax> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
957 <default>1h</default> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
958 <context>http</context> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
959 <context>server</context> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
960 <context>location</context> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
961 <appeared-in>1.19.10</appeared-in> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
962 |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
963 <para> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
964 Ограничивает максимальное время, в течение которого |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
965 могут обрабатываться запросы в рамках keep-alive соединения. |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
966 По достижении заданного времени соединение закрывается |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
967 после обработки очередного запроса. |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
968 </para> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
969 |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
970 </directive> |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
971 |
06805824d0f0
Documented the keepalive_time directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2657
diff
changeset
|
972 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
973 <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
|
974 <syntax> |
364 | 975 <value>таймаут</value> |
976 [<value>заголовок_таймаута</value>]</syntax> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
977 <default>75s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
978 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
979 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
980 <context>location</context> |
76
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 <para> |
271 | 983 Первый параметр задаёт таймаут, в течение которого keep-alive |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
984 соединение с клиентом не будет закрыто со стороны сервера. |
835
e0263d44a59b
Http core: documented "keepalive_timeout 0".
Ruslan Ermilov <ru@nginx.com>
parents:
826
diff
changeset
|
985 Значение 0 запрещает keep-alive соединения с клиентами. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
986 Второй необязательный параметр задаёт значение в поле |
271 | 987 <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
|
988 заголовка ответа. |
271 | 989 Два параметра могут отличаться друг от друга. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
990 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
991 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
992 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
993 Поле |
271 | 994 <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
|
995 заголовка понимают Mozilla и Konqueror. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
996 MSIE сам закрывает keep-alive соединение примерно через 60 секунд. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
997 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
998 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
999 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1000 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1001 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1002 <directive name="large_client_header_buffers"> |
271 | 1003 <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
|
1004 <default>4 8k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1005 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1006 <context>server</context> |
76
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 <para> |
271 | 1009 Задаёт максимальное <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
|
1010 буферов для чтения большого заголовка запроса клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1011 Строка запроса не должна превышать размера одного буфера, иначе клиенту |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1012 возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1013 <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
|
1014 Поле заголовка запроса также не должно превышать размера одного буфера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1015 иначе клиенту возвращается ошибка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1016 <http-status code="400" text="Bad Request"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1017 Буферы выделяются только по мере необходимости. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1018 По умолчанию размер одного буфера равен 8K байт. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1019 Если по окончании обработки запроса соединение переходит в состояние |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1020 keep-alive, эти буферы освобождаются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1021 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1022 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1023 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1024 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1025 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1026 <directive name="limit_except"> |
271 | 1027 <syntax block="yes"><value>метод</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
1028 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1029 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1030 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1031 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1032 Ограничивает HTTP-методы, доступные внутри location. |
271 | 1033 Параметр <value>метод</value> может быть одним из |
1034 <literal>GET</literal>, | |
1035 <literal>HEAD</literal>, | |
1036 <literal>POST</literal>, | |
1037 <literal>PUT</literal>, | |
1038 <literal>DELETE</literal>, | |
1039 <literal>MKCOL</literal>, | |
1040 <literal>COPY</literal>, | |
1041 <literal>MOVE</literal>, | |
1042 <literal>OPTIONS</literal>, | |
1043 <literal>PROPFIND</literal>, | |
1044 <literal>PROPPATCH</literal>, | |
1045 <literal>LOCK</literal>, | |
1046 <literal>UNLOCK</literal> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1047 или |
271 | 1048 <literal>PATCH</literal>. |
1049 Если разрешён метод <literal>GET</literal>, то метод | |
1050 <literal>HEAD</literal> также будет разрешён. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1051 Доступ к остальным методам может быть ограничен при помощи директив модулей |
2139
f6e578b1b02d
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2134
diff
changeset
|
1052 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, |
f6e578b1b02d
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2134
diff
changeset
|
1053 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1054 и |
2139
f6e578b1b02d
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2134
diff
changeset
|
1055 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link> |
f6e578b1b02d
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2134
diff
changeset
|
1056 (1.13.10): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1057 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1058 limit_except GET { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1059 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
|
1060 deny all; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1061 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1062 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1063 Обратите внимание, что данное ограничение действует для всех методов, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1064 <emphasis>кроме</emphasis> GET и HEAD. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1065 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1066 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1067 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1068 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1069 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1070 <directive name="limit_rate"> |
271 | 1071 <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
|
1072 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1073 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1074 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1075 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1076 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1077 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1078 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1079 Ограничивает скорость передачи ответа клиенту. |
1519
89ac38f2225b
Added missing tags to the "limit_rate" directive in Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1513
diff
changeset
|
1080 <value>Скорость</value> задаётся в байтах в секунду. |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
1081 Значение 0 отключает ограничение скорости. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1082 <!-- |
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 --> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1085 Ограничение устанавливается на запрос, поэтому, если клиент одновременно |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
1086 откроет два соединения, суммарная скорость будет вдвое выше |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
1087 заданного ограничения. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1088 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1089 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1090 <para> |
2384
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1091 В значении параметра можно использовать переменные (1.17.0). |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
1092 Это может быть полезно в случаях, когда скорость нужно ограничивать |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
1093 в зависимости от какого-либо условия: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1094 <example> |
2384
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1095 map $slow $rate { |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1096 1 4k; |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1097 2 8k; |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1098 } |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1099 |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1100 limit_rate $rate; |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1101 </example> |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1102 </para> |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1103 |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1104 <para> |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1105 Ограничение скорости можно также задать в переменной |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1106 <link id="var_limit_rate"><var>$limit_rate</var></link>, |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1107 однако начиная с 1.17.0 использовать данный метод не рекомендуется: |
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1108 <example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1109 server { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1110 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1111 if ($slow) { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1112 set $limit_rate 4k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1113 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1114 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1115 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1116 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1117 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1118 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1119 |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
1120 <para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
1121 Кроме того, ограничение скорости может быть задано в поле |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
1122 <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
|
1123 Эту возможность можно запретить с помощью директив |
1181 | 1124 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>, |
1194 | 1125 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>, |
1126 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_ignore_headers"/> | |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
1127 и |
1181 | 1128 <link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>. |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
1129 </para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
503
diff
changeset
|
1130 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1131 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1132 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1133 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1134 <directive name="limit_rate_after"> |
271 | 1135 <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
|
1136 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1137 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1138 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1139 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1140 <context>if в location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1141 <appeared-in>0.8.0</appeared-in> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1142 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1143 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1144 Задаёт начальный объём данных, после передачи которого начинает |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1145 ограничиваться скорость передачи ответа клиенту. |
2384
144c8e3d6c09
Documented variables support in limit_rate and limit_rate_after.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2357
diff
changeset
|
1146 В значении параметра можно использовать переменные (1.17.0). |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1147 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1148 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1149 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1150 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1151 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1152 location /flv/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1153 flv; |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1154 limit_rate_after 500k; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1155 limit_rate 50k; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1156 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1157 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1158 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1159 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1160 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1161 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1162 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1163 <directive name="lingering_close"> |
271 | 1164 <syntax> |
364 | 1165 <literal>off</literal> | |
1166 <literal>on</literal> | | |
1167 <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
|
1168 <default>on</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1169 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1170 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1171 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1172 <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
|
1173 <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
|
1174 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1175 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1176 Управляет закрытием соединений с клиентами. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1177 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1178 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1179 <para> |
271 | 1180 Со значением по умолчанию “<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
|
1181 <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
|
1182 <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
|
1183 поступающие от клиента, перед полным закрытием соединения, но только |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1184 если эвристика указывает на то, что клиент может ещё послать данные. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1185 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1186 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1187 <para> |
271 | 1188 Со значением “<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
|
1189 ждать и обрабатывать дополнительные данные, поступающие от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1190 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1191 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1192 <para> |
271 | 1193 Со значением “<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
|
1194 дополнительных данных и сразу же закроет соединение. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1195 Это поведение нарушает протокол и поэтому не должно использоваться без |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1196 необходимости. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1197 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1198 |
2567
4f3494d80949
Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2523
diff
changeset
|
1199 <para> |
4f3494d80949
Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2523
diff
changeset
|
1200 Для управления закрытием |
4f3494d80949
Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2523
diff
changeset
|
1201 <link doc="ngx_http_v2_module.xml">HTTP/2</link>-соединений |
4f3494d80949
Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2523
diff
changeset
|
1202 директива должна быть задана на уровне <link id="server"/> (1.19.1). |
4f3494d80949
Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2523
diff
changeset
|
1203 </para> |
4f3494d80949
Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2523
diff
changeset
|
1204 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1205 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1206 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1207 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1208 <directive name="lingering_time"> |
271 | 1209 <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
|
1210 <default>30s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1211 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1212 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1213 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1214 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1215 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1216 Если действует <link id="lingering_close"/>, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1217 эта директива задаёт максимальное время, в течение которого nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1218 будет обрабатывать (читать и игнорировать) дополнительные данные, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1219 поступающие от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1220 По прошествии этого времени соединение будет закрыто, даже если |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1221 будут ещё данные. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1222 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1223 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1224 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1225 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1226 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1227 <directive name="lingering_timeout"> |
271 | 1228 <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
|
1229 <default>5s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1230 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1231 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1232 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1233 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1234 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1235 Если действует <link id="lingering_close"/>, эта директива задаёт |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1236 максимальное время ожидания поступления дополнительных данных от клиента. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1237 Если в течение этого времени данные не были получены, соединение закрывается. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1238 В противном случае данные читаются и игнорируются, и nginx снова |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1239 ждёт поступления данных. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1240 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1241 директивой <link id="lingering_time"/>. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1242 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1243 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1244 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1245 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1246 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1247 <directive name="listen"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1248 <syntax> |
364 | 1249 <value>адрес</value>[:<value>порт</value>] |
1250 [<literal>default_server</literal>] | |
869 | 1251 [<literal>ssl</literal>] |
1567
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1252 [<literal>http2</literal> | <literal>spdy</literal>] |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1253 [<literal>proxy_protocol</literal>] |
364 | 1254 [<literal>setfib</literal>=<value>число</value>] |
1036
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1255 [<literal>fastopen</literal>=<value>число</value>] |
364 | 1256 [<literal>backlog</literal>=<value>число</value>] |
1257 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1258 [<literal>sndbuf</literal>=<value>размер</value>] | |
1259 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1260 [<literal>deferred</literal>] | |
1261 [<literal>bind</literal>] | |
1262 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] | |
1493
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1263 [<literal>reuseport</literal>] |
364 | 1264 [<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
|
1265 <syntax> |
364 | 1266 <value>порт</value> |
1267 [<literal>default_server</literal>] | |
869 | 1268 [<literal>ssl</literal>] |
1567
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1269 [<literal>http2</literal> | <literal>spdy</literal>] |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1270 [<literal>proxy_protocol</literal>] |
364 | 1271 [<literal>setfib</literal>=<value>число</value>] |
1036
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1272 [<literal>fastopen</literal>=<value>число</value>] |
364 | 1273 [<literal>backlog</literal>=<value>число</value>] |
1274 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1275 [<literal>sndbuf</literal>=<value>размер</value>] | |
1276 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1277 [<literal>deferred</literal>] | |
1278 [<literal>bind</literal>] | |
1279 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] | |
1493
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1280 [<literal>reuseport</literal>] |
364 | 1281 [<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
|
1282 <syntax> |
364 | 1283 <literal>unix:</literal><value>путь</value> |
1284 [<literal>default_server</literal>] | |
869 | 1285 [<literal>ssl</literal>] |
1567
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1286 [<literal>http2</literal> | <literal>spdy</literal>] |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1287 [<literal>proxy_protocol</literal>] |
364 | 1288 [<literal>backlog</literal>=<value>число</value>] |
1289 [<literal>rcvbuf</literal>=<value>размер</value>] | |
1290 [<literal>sndbuf</literal>=<value>размер</value>] | |
1291 [<literal>accept_filter</literal>=<value>фильтр</value>] | |
1292 [<literal>deferred</literal>] | |
1293 [<literal>bind</literal>] | |
1294 [<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
|
1295 <default>*:80 | *:8000</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1296 <context>server</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1297 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1298 <para> |
271 | 1299 Задаёт <value>адрес</value> и <value>порт</value> для IP |
1300 или <value>путь</value> для UNIX-сокета, | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1301 на которых сервер будет принимать запросы. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1302 Можно указать <value>адрес</value> и <value>порт</value>, |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1303 либо только <value>адрес</value> или только <value>порт</value>. |
271 | 1304 Кроме того, <value>адрес</value> может быть именем хоста, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1305 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1306 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
|
1307 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
|
1308 listen 8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1309 listen *:8000; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1310 listen localhost:8000; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1311 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1312 IPv6-адреса (0.7.36) задаются в квадратных скобках: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1313 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1314 listen [::]:8000; |
941
7d1d53d4d293
Removed link-scoped IPv6 addresses from examples.
Ruslan Ermilov <ru@nginx.com>
parents:
940
diff
changeset
|
1315 listen [::1]; |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1316 </example> |
271 | 1317 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
|
1318 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1319 listen unix:/var/run/nginx.sock; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1320 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1321 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1322 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1323 <para> |
271 | 1324 Если указан только <value>адрес</value>, то используется порт 80. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1325 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1326 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1327 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1328 Если директива не указана, то используется либо <literal>*:80</literal>, |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1329 если nginx работает с привилегиями суперпользователя, |
271 | 1330 либо <literal>*:8000</literal>. |
76
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> |
271 | 1334 Если у директивы есть параметр <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
|
1335 в котором описана эта директива, будет сервером по умолчанию для указанной пары |
271 | 1336 <value>адрес</value>:<value>порт</value>. |
1337 Если же директив с параметром <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
|
1338 сервером по умолчанию будет первый сервер, в котором описана пара |
271 | 1339 <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
|
1340 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1341 До версии 0.8.21 этот параметр назывался просто |
271 | 1342 <literal>default</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1343 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1344 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1345 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1346 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1347 Параметр <literal>ssl</literal> (0.7.14) указывает на то, что все соединения, |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1348 принимаемые на данном порту, должны работать в режиме SSL. |
869 | 1349 Это позволяет задать компактную <link doc="configuring_https_servers.xml" |
1350 id="single_http_https_server">конфигурацию</link> для сервера, | |
1351 работающего сразу в двух режимах — HTTP и HTTPS. | |
1352 </para> | |
1353 | |
1354 <para> | |
1567
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1355 Параметр <literal>http2</literal> (1.9.5) позволяет принимать на этом порту |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1356 <link doc="ngx_http_v2_module.xml">HTTP/2</link>-соединения. |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1357 Обычно, чтобы это работало, следует также указать параметр |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1358 <literal>ssl</literal>, однако nginx можно также настроить и на приём |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1359 HTTP/2-соединений без SSL. |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1360 </para> |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1361 |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1362 <para> |
695999bdd4a5
Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1545
diff
changeset
|
1363 Параметр <literal>spdy</literal> (1.3.15-1.9.4) позволяет принимать на этом порту |
869 | 1364 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения. |
1365 Обычно, чтобы это работало, следует также указать параметр | |
1366 <literal>ssl</literal>, однако nginx можно также настроить и на приём | |
1367 SPDY-соединений без SSL. | |
1368 </para> | |
1369 | |
1370 <para> | |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1371 Параметр <literal>proxy_protocol</literal> (1.5.12) |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1372 указывает на то, что все соединения, принимаемые на данном порту, |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1373 должны использовать |
1513
88d1a1d36c0c
Corrected link to the PROXY protocol specification.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1507
diff
changeset
|
1374 <link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">протокол |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1375 PROXY</link>. |
2125
b19d5d47c16c
Documented ver.2 of the PROXY protocol.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2121
diff
changeset
|
1376 <note> |
b19d5d47c16c
Documented ver.2 of the PROXY protocol.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2121
diff
changeset
|
1377 Протокол PROXY версии 2 поддерживается начиная с версии 1.13.11. |
b19d5d47c16c
Documented ver.2 of the PROXY protocol.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2121
diff
changeset
|
1378 </note> |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1379 </para> |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1380 |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
1381 <para> |
271 | 1382 В директиве <literal>listen</literal> можно также указать несколько |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1383 дополнительных параметров, специфичных для связанных с сокетами |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1384 системных вызовов. |
271 | 1385 Эти параметры можно задать в любой директиве <literal>listen</literal>, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1386 но только один раз для указанной пары |
271 | 1387 <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
|
1388 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1389 До версии 0.8.21 их можно было указывать лишь в директиве |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1390 <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
|
1391 </note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1392 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1393 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1394 <tag-name> |
271 | 1395 <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
|
1396 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1397 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1398 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1399 (параметр <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
|
1400 В настоящий момент это работает только на FreeBSD. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1401 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1402 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1403 <tag-name> |
1036
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1404 <literal>fastopen</literal>=<value>число</value> |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1405 </tag-name> |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1406 <tag-desc> |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1407 включает |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1408 “<link url="http://en.wikipedia.org/wiki/TCP_Fast_Open">TCP Fast Open</link>” |
1037 | 1409 для слушающего сокета (1.5.8) и |
1923
66a30a380fba
Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents:
1911
diff
changeset
|
1410 <link url="https://tools.ietf.org/html/rfc7413#section-5.1">ограничивает</link> |
1036
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1411 максимальную длину очереди соединений, которые ещё не завершили процесс |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1412 three-way handshake. |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1413 <note> |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1414 Не включайте “TCP Fast Open”, не убедившись, что сервер может адекватно |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1415 обрабатывать многократное получение |
1923
66a30a380fba
Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents:
1911
diff
changeset
|
1416 <link url="https://tools.ietf.org/html/rfc7413#section-6.1"> |
1036
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1417 одного и того же SYN-пакета с данными</link>. |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1418 </note> |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1419 </tag-desc> |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1420 |
5894aa46ffef
Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents:
1035
diff
changeset
|
1421 <tag-name> |
271 | 1422 <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
|
1423 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1424 <tag-desc> |
271 | 1425 задаёт параметр <literal>backlog</literal> в вызове |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1426 <c-func>listen</c-func>, который ограничивает |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1427 максимальный размер очереди ожидающих приёма соединений. |
741
082a725038db
Fixed default backlog value description for Mac OS X
Sergey Budnevitch <sb@waeme.net>
parents:
738
diff
changeset
|
1428 По умолчанию <literal>backlog</literal> устанавливается равным -1 для |
1911
f024ac0ec5c7
Apple rebranded Mac OS X to macOS.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1904
diff
changeset
|
1429 FreeBSD, DragonFly BSD и macOS, и 511 для других платформ. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1430 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1431 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1432 <tag-name> |
271 | 1433 <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
|
1434 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1435 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1436 задаёт размер буфера приёма |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1437 (параметр <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
|
1438 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1439 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1440 <tag-name> |
271 | 1441 <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
|
1442 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1443 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1444 задаёт размер буфера передачи |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1445 (параметр <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
|
1446 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1447 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1448 <tag-name> |
271 | 1449 <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
|
1450 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1451 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1452 задаёт название accept-фильтра |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1453 (параметр <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
|
1454 который включается для фильтрации входящих соединений |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1455 перед передачей их в <c-func>accept</c-func>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1456 Работает только на FreeBSD и NetBSD 5.0+. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1457 Можно использовать два фильтра: |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1458 <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
|
1459 и |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1460 <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
|
1461 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1462 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1463 <tag-name> |
271 | 1464 <literal>deferred</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1465 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1466 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1467 указывает использовать отложенный <c-func>accept</c-func> |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1468 (параметр <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
|
1469 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1470 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1471 <tag-name> |
271 | 1472 <literal>bind</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1473 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1474 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1475 указывает, что для данной пары |
271 | 1476 <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
|
1477 <c-func>bind</c-func> отдельно. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1478 Это нужно потому, что если описаны несколько директив <literal>listen</literal> |
629 | 1479 с одинаковым портом, но разными адресами, и одна из директив |
271 | 1480 <literal>listen</literal> слушает на всех адресах для данного порта |
629 | 1481 (<literal>*:</literal><value>порт</value>), то nginx сделает |
271 | 1482 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>. |
1478 | 1483 Необходимо заметить, что в этом случае для определения адреса, на который |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1484 пришло соединение, делается системный вызов <c-func>getsockname</c-func>. |
1035
e9c485d6cc0c
Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
1031
diff
changeset
|
1485 Если же используются параметры <literal>setfib</literal>, |
2724
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2707
diff
changeset
|
1486 <literal>fastopen</literal>, |
1035
e9c485d6cc0c
Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
1031
diff
changeset
|
1487 <literal>backlog</literal>, <literal>rcvbuf</literal>, |
e9c485d6cc0c
Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
1031
diff
changeset
|
1488 <literal>sndbuf</literal>, <literal>accept_filter</literal>, |
2724
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2707
diff
changeset
|
1489 <literal>deferred</literal>, <literal>ipv6only</literal>, |
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2707
diff
changeset
|
1490 <literal>reuseport</literal> |
1279
7261e621dd4a
Documented that "listen ipv6only=" implies "bind".
Maxim Dounin <mdounin@mdounin.ru>
parents:
1257
diff
changeset
|
1491 или <literal>so_keepalive</literal>, |
1035
e9c485d6cc0c
Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
1031
diff
changeset
|
1492 то для данной пары |
271 | 1493 <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
|
1494 отдельный вызов <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
|
1495 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1496 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1497 <tag-name> |
271 | 1498 <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
|
1499 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1500 <tag-desc> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1501 этот параметр (0.7.42) определяет |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1502 (через параметр сокета <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
|
1503 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1504 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения. |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1505 По умолчанию параметр включён. |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1506 Установить его можно только один раз на старте. |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1507 <note> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1508 До версии 1.3.4, |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1509 если этот параметр не был задан явно, то для сокета действовали |
615
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1510 настройки операционной системы. |
f3ef5b77d22a
Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
1511 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1512 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1513 |
1507
14180fa9a518
Added ids for reuseport, mentioned reuseport in news.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1501
diff
changeset
|
1514 <tag-name id="reuseport"> |
1493
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1515 <literal>reuseport</literal> |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1516 </tag-name> |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1517 <tag-desc> |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1518 этот параметр (1.9.1) указывает, что нужно создавать отдельный слушающий сокет |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1519 для каждого рабочего процесса |
2199
1d60e4b4ed64
Documented SO_REUSEPORT_LB for listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2139
diff
changeset
|
1520 (через параметр сокета |
1d60e4b4ed64
Documented SO_REUSEPORT_LB for listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2139
diff
changeset
|
1521 <c-def>SO_REUSEPORT</c-def> для Linux 3.9+ и DragonFly BSD |
1d60e4b4ed64
Documented SO_REUSEPORT_LB for listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2139
diff
changeset
|
1522 или <c-def>SO_REUSEPORT_LB</c-def> для FreeBSD 12+), позволяя ядру |
1496
99ce48c8cce3
Corrected the "reuseport" description of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1493
diff
changeset
|
1523 распределять входящие соединения между рабочими процессами. |
2199
1d60e4b4ed64
Documented SO_REUSEPORT_LB for listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2139
diff
changeset
|
1524 В настоящий момент это работает только на Linux 3.9+, DragonFly BSD |
1d60e4b4ed64
Documented SO_REUSEPORT_LB for listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2139
diff
changeset
|
1525 и FreeBSD 12+ (1.15.1). |
1493
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1526 <note> |
2357
344e2535f027
Corrected Russian translation of listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2220
diff
changeset
|
1527 Ненадлежащее использование параметра может быть |
344e2535f027
Corrected Russian translation of listen reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2220
diff
changeset
|
1528 <link url="http://man7.org/linux/man-pages/man7/socket.7.html">небезопасно</link>. |
1493
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1529 </note> |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1530 </tag-desc> |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1531 |
9faa78768252
Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1478
diff
changeset
|
1532 <tag-name> |
271 | 1533 <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
|
1534 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1535 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1536 этот параметр (1.1.11) конфигурирует для слушающего сокета |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1537 поведение “TCP keepalive”. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1538 Если этот параметр опущен, то для сокета будут действовать |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1539 настройки операционной системы. |
271 | 1540 Если он установлен в значение “<literal>on</literal>”, то для сокета |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1541 включается параметр <c-def>SO_KEEPALIVE</c-def>. |
271 | 1542 Если он установлен в значение “<literal>off</literal>”, то для сокета |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1543 параметр <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
|
1544 Некоторые операционные системы поддерживают настройку параметров |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1545 “TCP keepalive” на уровне сокета посредством параметров |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1546 <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
|
1547 <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
|
1548 На таких системах (в настоящий момент это 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
|
1549 FreeBSD 9.0-STABLE) |
271 | 1550 их можно сконфигурировать с помощью параметров <value>keepidle</value>, |
1551 <value>keepintvl</value> и <value>keepcnt</value>. | |
1552 Один или два параметра могут быть опущены, в таком случае для | |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1553 соответствующего параметра сокета будут действовать стандартные |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1554 системные настройки. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1555 Например, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1556 <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
|
1557 установит таймаут бездействия (<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
|
1558 для интервала проб (<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
|
1559 стандартная системная настройка, а счётчик проб (<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
|
1560 будет равен 10. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1561 </tag-desc> |
76
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 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1564 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1565 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1566 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1567 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1568 <example> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
1569 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
|
1570 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1571 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1572 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1573 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1574 |
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 name="location"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1577 <syntax block="yes">[ |
364 | 1578 <literal>=</literal> | |
1579 <literal>~</literal> | | |
1580 <literal>~*</literal> | | |
1581 <literal>^~</literal> | |
1582 ] <value>uri</value></syntax> | |
271 | 1583 <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
|
1584 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1585 <context>server</context> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1586 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1587 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1588 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1589 Устанавливает конфигурацию в зависимости от URI запроса. |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1590 </para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1591 |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1592 <para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1593 Для сопоставления используется URI запроса в нормализованном виде, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1594 после декодирования текста, заданного в виде “<literal>%XX</literal>”, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1595 преобразования относительных элементов пути “<literal>.</literal>” и |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1596 “<literal>..</literal>” в реальные и возможной |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1597 <link id="merge_slashes">замены</link> двух и более подряд идущих |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1598 слэшей на один. |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1599 </para> |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1600 |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1601 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1602 location можно задать префиксной строкой или регулярным выражением. |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1603 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1604 (для поиска совпадения без учёта регистра символов), |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1605 либо с модификатором “<literal>~</literal>” (с учётом регистра). |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1606 Чтобы найти location, соответствующий запросу, вначале проверяются |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1607 location’ы, заданные префиксными строками (префиксные location’ы). |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1608 Среди них ищется location с совпадающим префиксом |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1609 максимальной длины и запоминается. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1610 Затем проверяются регулярные выражения, в порядке их следования |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1611 в конфигурационном файле. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1612 Проверка регулярных выражений прекращается после первого же совпадения, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1613 и используется соответствующая конфигурация. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1614 Если совпадение с регулярным выражением не найдено, то используется |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1615 конфигурация запомненного ранее префиксного location’а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1616 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1617 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1618 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1619 Блоки <literal>location</literal> могут быть вложенными, |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1620 с некоторыми исключениями, о которых говорится ниже. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1621 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1622 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1623 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1624 Для операционных систем, нечувствительных к регистру символов, таких |
1911
f024ac0ec5c7
Apple rebranded Mac OS X to macOS.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1904
diff
changeset
|
1625 как macOS и Cygwin, сравнение с префиксными строками производится |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1626 без учёта регистра (0.7.7). |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1627 Однако сравнение ограничено только однобайтными locale’ями. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1628 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1629 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1630 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1631 Регулярные выражения могут содержать выделения (0.7.40), которые могут |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1632 затем использоваться в других директивах. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1633 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1634 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1635 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1636 Если у совпавшего префиксного location’а максимальной длины указан модификатор |
271 | 1637 “<literal>^~</literal>”, то регулярные выражения не проверяются. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1638 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1639 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1640 <para> |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1641 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1642 совпадение URI и location. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1643 При точном совпадении поиск сразу же прекращается. |
271 | 1644 Например, если запрос “<literal>/</literal>” случается часто, то |
1645 указав “<literal>location = /</literal>”, можно ускорить обработку | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1646 этих запросов, так как поиск прекратится после первого же сравнения. |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1647 Очевидно, что такой location не может иметь вложенные location’ы. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1648 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1649 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1650 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1651 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1652 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным |
810
7c72c3e67e77
The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents:
779
diff
changeset
|
1653 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
|
1654 то поиск тоже сразу же прекращается и регулярные выражения также |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1655 не проверяются. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1656 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1657 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1658 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1659 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1660 Проиллюстрируем вышесказанное примером: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1661 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1662 location = / { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1663 [ конфигурация А ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1664 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1665 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1666 location / { |
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 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1669 |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1670 location /documents/ { |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1671 [ конфигурация В ] |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1672 } |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1673 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1674 location ^~ /images/ { |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1675 [ конфигурация Г ] |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1676 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1677 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1678 location ~* \.(gif|jpg|jpeg)$ { |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1679 [ конфигурация Д ] |
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 </example> |
271 | 1682 Для запроса “<literal>/</literal>” будет выбрана конфигурация А, |
738
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1683 для запроса “<literal>/index.html</literal>” — конфигурация Б, |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1684 для запроса “<literal>/documents/document.html</literal>” — конфигурация В, |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1685 для запроса “<literal>/images/1.gif</literal>” — конфигурация Г, |
0914bbb59fd2
Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents:
711
diff
changeset
|
1686 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Д. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1687 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1688 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1689 <para> |
271 | 1690 Префикс “<literal>@</literal>” задаёт именованный location. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1691 Такой location не используется при обычной обработке запросов, а |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1692 предназначен только для перенаправления в него запросов. |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1693 Такие location’ы не могут быть вложенными и не могут содержать |
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1694 вложенные location’ы. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1695 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1696 |
914
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1697 <para> |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1698 Если location задан префиксной строкой со слэшом в конце |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1699 и запросы обрабатываются при помощи |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1700 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>, |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1701 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>, |
1194 | 1702 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>, |
2134
4cafd82e5007
Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2125
diff
changeset
|
1703 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>, |
4cafd82e5007
Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2125
diff
changeset
|
1704 <link doc="ngx_http_memcached_module.xml" id="memcached_pass"/> или |
4cafd82e5007
Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2125
diff
changeset
|
1705 <link doc="ngx_http_grpc_module.xml" id="grpc_pass"/>, |
1257
ac7a5ee98768
Split long sentence into two.
Ruslan Ermilov <ru@nginx.com>
parents:
1194
diff
changeset
|
1706 происходит специальная обработка. |
ac7a5ee98768
Split long sentence into two.
Ruslan Ermilov <ru@nginx.com>
parents:
1194
diff
changeset
|
1707 В ответ на запрос с URI равным этой строке, но без завершающего слэша, |
914
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1708 будет возвращено постоянное перенаправление с кодом 301 |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1709 на URI с добавленным в конец слэшом. |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1710 Если такое поведение нежелательно, можно задать точное совпадение |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1711 URI и location, например: |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1712 <example> |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1713 location /user/ { |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1714 proxy_pass http://user.example.com; |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1715 } |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1716 |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1717 location = /user { |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1718 proxy_pass http://login.example.com; |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1719 } |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1720 </example> |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1721 </para> |
474a21f26a2a
Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents:
871
diff
changeset
|
1722 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1723 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1724 <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
|
1725 --> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1726 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1727 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1728 |
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 <directive name="log_not_found"> |
271 | 1731 <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
|
1732 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1733 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1734 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1735 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1736 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1737 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1738 Разрешает или запрещает записывать в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1739 <link doc="../ngx_core_module.xml" id="error_log"/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1740 ошибки о том, что файл не найден. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1741 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1742 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1743 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1744 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1745 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1746 <directive name="log_subrequest"> |
271 | 1747 <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
|
1748 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1749 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1750 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1751 <context>location</context> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1754 Разрешает или запрещает записывать в |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
1755 <link doc="ngx_http_log_module.xml" id="access_log"/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1756 подзапросы. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1757 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1760 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1761 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1762 <directive name="max_ranges"> |
271 | 1763 <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
|
1764 <default/> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1765 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1766 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1767 <context>location</context> |
499
76a8eca844d0
Documented that "max_ranges" appeared in 1.1.2.
Ruslan Ermilov <ru@nginx.com>
parents:
477
diff
changeset
|
1768 <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
|
1769 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1770 <para> |
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 указанием диапазона запрашиваемых байт (byte-range requests). |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1773 Запросы, превышающие указанное ограничение, обрабатываются как |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1774 если бы они не содержали указания диапазонов. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1775 По умолчанию число диапазонов не ограничено. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1776 Значение 0 полностью запрещает поддержку диапазонов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1777 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1778 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1779 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1780 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1781 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1782 <directive name="merge_slashes"> |
271 | 1783 <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
|
1784 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1785 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1786 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1787 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1788 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1789 Разрешает или запрещает преобразование URI путём замены двух и более подряд |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
1790 идущих слэшей (“<literal>/</literal>”) на один. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1791 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1792 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1793 <para> |
280 | 1794 Необходимо иметь в виду, что это преобразование необходимо для корректной |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1795 проверки префиксных строк и регулярных выражений. |
364 | 1796 Если его не делать, то запрос “<literal>//scripts/one.php</literal>” |
1797 не попадёт в | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1798 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1799 location /scripts/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1800 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1801 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1802 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1803 и может быть обслужен как статический файл. |
271 | 1804 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1805 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1806 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1807 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1808 Запрет преобразования может понадобиться, если в URI используются имена, |
271 | 1809 закодированные методом base64, в котором задействован символ |
1810 “<literal>/</literal>”. | |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1811 Однако из соображений безопасности лучше избегать отключения преобразования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1812 </para> |
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 <para> |
1023
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
1815 Если директива указана на уровне <link id="server"/>, |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
1816 её значение используется только в том случае, |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
1817 если сервер является сервером по умолчанию. |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
1818 Указанное значение распространяется на все виртуальные серверы, |
442
b423d725a932
Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents:
438
diff
changeset
|
1819 слушающие на том же адресе и порту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1820 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1823 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1824 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1825 <directive name="msie_padding"> |
271 | 1826 <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
|
1827 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1828 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1829 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1830 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1831 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1832 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1833 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1834 комментарий для увеличения размера ответа до 512 байт. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1835 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1836 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1837 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1838 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1839 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1840 <directive name="msie_refresh"> |
271 | 1841 <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
|
1842 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1843 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1844 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1845 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1846 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1847 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
1848 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1849 перенаправлений. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1850 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1851 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1852 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1853 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1854 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1855 <directive name="open_file_cache"> |
271 | 1856 <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
|
1857 <syntax> |
271 | 1858 <literal>max</literal>=<value>N</value> |
1859 [<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
|
1860 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1861 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1862 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1863 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1864 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1865 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1866 Задаёт кэш, в котором могут храниться: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1867 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1868 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1869 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1870 дескрипторы открытых файлов, информация об их размерах и времени модификации; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1871 </listitem> |
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 <listitem> |
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 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1876 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1877 <listitem> |
367
f4033b9bc4ec
- Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1878 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1879 и тому подобное. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1880 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1881 Кэширование ошибок нужно разрешить отдельно директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1882 <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
|
1883 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1884 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1885 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1886 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1887 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1888 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1889 <para> |
253
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 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1892 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1893 <tag-name> |
271 | 1894 <literal>max</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1895 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1896 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1897 задаёт максимальное число элементов в кэше; |
507 | 1898 при переполнении кэша удаляются наименее востребованные элементы (LRU); |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1899 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1900 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1901 <tag-name> |
271 | 1902 <literal>inactive</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1903 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1904 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1905 задаёт время, после которого элемент кэша удаляется, если к нему |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1906 не было обращений в течение этого времени; по умолчанию 60 секунд; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1907 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1908 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1909 <tag-name> |
271 | 1910 <literal>off</literal> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1911 </tag-name> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1912 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1913 запрещает кэш. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1914 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1915 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1916 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1917 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1918 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1919 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1920 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1921 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1922 open_file_cache max=1000 inactive=20s; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1923 open_file_cache_valid 30s; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1924 open_file_cache_min_uses 2; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1925 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
|
1926 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1927 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
|
1928 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1929 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1930 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1931 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1932 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1933 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1934 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1935 <directive name="open_file_cache_errors"> |
271 | 1936 <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
|
1937 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1938 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1939 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1940 <context>location</context> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1943 Разрешает или запрещает кэширование ошибок поиска файлов в |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1944 <link id="open_file_cache"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1945 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1946 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1947 </directive> |
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 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1950 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1951 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1952 <directive name="open_file_cache_events"> |
271 | 1953 <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
|
1954 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1955 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1956 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1957 <context>location</context> |
76
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1960 Разрешает использование событий ядра для проверки актуальности элементов |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1961 <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
|
1962 Эта директива работает только совместно с методом |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1963 <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
|
1964 Заметьте, что только 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
|
1965 поддерживают события для файловых систем произвольного типа. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1966 Другие операционные системы поддерживают события только для |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1967 основных файловых систем, таких как UFS или FFS. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1968 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1969 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1970 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1971 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1972 --> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1973 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1974 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1975 <directive name="open_file_cache_min_uses"> |
271 | 1976 <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
|
1977 <default>1</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1978 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1979 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1980 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1981 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1982 <para> |
271 | 1983 Задаёт минимальное <value>число</value> обращений к файлу |
1984 в течение времени, заданного параметром <literal>inactive</literal> | |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1985 директивы <link id="open_file_cache"/>, необходимых для того, чтобы дескриптор |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
1986 файла оставался открытым в кэше. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1987 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1988 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1989 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1992 <directive name="open_file_cache_valid"> |
271 | 1993 <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
|
1994 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1995 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1996 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1997 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1998 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1999 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2000 Определяет время, через которое следует проверять актуальность информации |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2001 об элементе в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2002 <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
|
2003 <!-- |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2004 При включенном |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2005 <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
|
2006 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2007 по факту их изменения. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2008 --> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2009 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2010 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2011 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2012 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2013 |
1024
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2014 <directive name="output_buffers"> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2015 <syntax><value>number</value> <value>size</value></syntax> |
1576
7f97ab081d24
Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1567
diff
changeset
|
2016 <default>2 32k</default> |
1024
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2017 <context>http</context> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2018 <context>server</context> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2019 <context>location</context> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2020 |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2021 <para> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2022 Задаёт <value>число</value> и <value>размер</value> буферов, |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2023 используемых при чтении ответа с диска. |
1576
7f97ab081d24
Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1567
diff
changeset
|
2024 <note> |
7f97ab081d24
Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1567
diff
changeset
|
2025 До версии 1.9.5 по умолчанию использовалось значение 1 32k. |
7f97ab081d24
Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1567
diff
changeset
|
2026 </note> |
1024
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2027 </para> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2028 |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2029 </directive> |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2030 |
e47971bf6619
Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1023
diff
changeset
|
2031 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2032 <directive name="port_in_redirect"> |
271 | 2033 <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
|
2034 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2035 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2036 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2037 <context>location</context> |
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 <para> |
1879
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
2040 Разрешает или запрещает указывать порт в |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
2041 <link id="absolute_redirect">абсолютных</link> |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
2042 перенаправлениях, выдаваемых nginx’ом. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2043 </para> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2044 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2045 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2046 Использование в перенаправлениях основного имени сервера управляется |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2047 директивой <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
|
2048 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2049 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2050 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2053 <directive name="postpone_output"> |
271 | 2054 <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
|
2055 <default>1460</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2056 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2057 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2058 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2059 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2060 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2061 Если это возможно, то отправка данных клиенту будет отложена пока nginx не |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2062 накопит по крайней мере указанное количество байт для отправки. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2063 Значение 0 запрещает отложенную отправку данных. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2064 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2065 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2066 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2067 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2068 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2069 <directive name="read_ahead"> |
271 | 2070 <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
|
2071 <default>0</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2072 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2073 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2074 <context>location</context> |
76
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 <para> |
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 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2081 На Linux используется системный вызов |
271 | 2082 <literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>, |
2083 поэтому параметр <value>размер</value> там игнорируется. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2084 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2085 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2086 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2087 На FreeBSD используется системный вызов |
271 | 2088 <literal>fcntl(O_READAHEAD, |
2089 </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
|
2090 появившийся во FreeBSD 9.0-CURRENT. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2091 Для FreeBSD 7 необходимо установить |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2092 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2093 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2094 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2095 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2096 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2097 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2098 <directive name="recursive_error_pages"> |
271 | 2099 <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
|
2100 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2101 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2102 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2103 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2104 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2105 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2106 Разрешает или запрещает делать несколько перенаправлений через директиву |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2107 <link id="error_page"/>. |
709
a4648185190a
Fixed the link internal to the module.
Ruslan Ermilov <ru@nginx.com>
parents:
679
diff
changeset
|
2108 Число таких перенаправлений <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
|
2109 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2110 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2111 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2112 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2113 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2114 <directive name="request_pool_size"> |
271 | 2115 <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
|
2116 <default>4k</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2117 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2118 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2119 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2120 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2121 Позволяет производить точную настройку выделений памяти |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2122 под конкретные запросы. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2123 Эта директива не оказывает существенного влияния на |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2124 производительность, и её не следует использовать. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2125 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2126 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2127 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2128 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2129 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2130 <directive name="reset_timedout_connection"> |
364 | 2131 <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
|
2132 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2133 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2134 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2135 <context>location</context> |
76
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 <para> |
2390
655e7de7fd4b
Documented "return 444" when reset_timedout_connection is on.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2384
diff
changeset
|
2138 Разрешает или запрещает сброс соединений по таймауту, |
655e7de7fd4b
Documented "return 444" when reset_timedout_connection is on.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2384
diff
changeset
|
2139 а также при |
655e7de7fd4b
Documented "return 444" when reset_timedout_connection is on.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2384
diff
changeset
|
2140 <link doc="ngx_http_rewrite_module.xml" id="return">закрытии</link> |
655e7de7fd4b
Documented "return 444" when reset_timedout_connection is on.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2384
diff
changeset
|
2141 соединений с помощью нестандартного кода 444 (1.15.2). |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2142 Сброс делается следующим образом. |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2143 Перед закрытием сокета для него задаётся параметр |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2144 <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
|
2145 с таймаутом 0. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2146 После этого при закрытии сокета клиенту отсылается TCP RST, а вся память, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2147 связанная с этим сокетом, освобождается. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2148 Это позволяет избежать длительного нахождения уже закрытого сокета в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2149 состоянии FIN_WAIT1 с заполненными буферами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2150 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2151 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2152 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2153 Необходимо отметить, что keep-alive соединения по истечении таймаута |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2154 закрываются обычным образом. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2155 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2156 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2157 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2158 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2159 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2160 <directive name="resolver"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2161 <syntax> |
1031
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2162 <value>адрес</value> ... |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2163 [<literal>valid</literal>=<value>время</value>] |
2424
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2164 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>] |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2165 [<literal>status_zone</literal>=<value>зона</value>]</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2166 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2167 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2168 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2169 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2170 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2171 <para> |
318
4a0fe9283dc7
Word polishing in the description of the "server" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
280
diff
changeset
|
2172 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2173 в адреса, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2174 <example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
2175 resolver 127.0.0.1 [::1]:5353; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2176 </example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
2177 Адрес может быть указан в виде доменного имени или IP-адреса, |
566 | 2178 и необязательного порта (1.3.1, 1.2.2). |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
2179 Если порт не указан, используется порт 53. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2180 Серверы DNS опрашиваются циклически. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2181 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2182 До версии 1.1.7 можно было задать лишь один DNS-сервер. |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
2183 Задание DNS-серверов с помощью IPv6-адресов поддерживается |
566 | 2184 начиная с версий 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
|
2185 </note> |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2450
diff
changeset
|
2186 </para> |
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2450
diff
changeset
|
2187 |
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2450
diff
changeset
|
2188 <para id="resolver_ipv6"> |
1031
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2189 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2190 при преобразовании имён в адреса. |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2191 Если поиск IPv6-адресов нежелателен, |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2192 можно указать параметр <literal>ipv6=off</literal>. |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2193 <note> |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2194 Преобразование имён в IPv6-адреса поддерживается |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2195 начиная с версии 1.5.8. |
f7f23f5928ef
Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents:
1024
diff
changeset
|
2196 </note> |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2450
diff
changeset
|
2197 </para> |
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2450
diff
changeset
|
2198 |
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2450
diff
changeset
|
2199 <para id="resolver_valid"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2200 По умолчанию nginx кэширует ответы, используя значение TTL из ответа. |
271 | 2201 Необязательный параметр <literal>valid</literal> позволяет это |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2202 переопределить: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2203 <example> |
527
58d79f8c412d
Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents:
522
diff
changeset
|
2204 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
|
2205 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2206 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2207 До версии 1.1.9 настройка времени кэширования была невозможна |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2208 и nginx всегда кэшировал ответы на срок в 5 минут. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2209 </note> |
1770
ae46e57cecba
Added note to the "resover" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1769
diff
changeset
|
2210 <note> |
ae46e57cecba
Added note to the "resover" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1769
diff
changeset
|
2211 Для предотвращения DNS-спуфинга рекомендуется |
ae46e57cecba
Added note to the "resover" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1769
diff
changeset
|
2212 использовать DNS-серверы в защищённой доверенной локальной сети. |
ae46e57cecba
Added note to the "resover" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1769
diff
changeset
|
2213 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2214 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2215 |
2424
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2216 <para id="resolver_status_zone"> |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2217 Необязательный параметр <literal>status_zone</literal> (1.17.1) |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2218 включает |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2219 <link doc="ngx_http_api_module.xml" id="resolvers_">сбор информации</link> |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2220 о запросах и ответах сервера DNS |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2221 в указанной <value>зоне</value>. |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2222 Параметр доступен как часть |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2223 <commercial_version>коммерческой подписки</commercial_version>. |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2224 </para> |
dd3ac7eefeed
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
2391
diff
changeset
|
2225 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2226 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2227 |
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 <directive name="resolver_timeout"> |
271 | 2230 <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
|
2231 <default>30s</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2232 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2233 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2234 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2235 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2236 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2237 Задаёт таймаут для преобразования имени в адрес, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2238 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2239 resolver_timeout 5s; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2240 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2241 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2242 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2243 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2244 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2245 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2246 <directive name="root"> |
271 | 2247 <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
|
2248 <default>html</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2249 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2250 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2251 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2252 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2253 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2254 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2255 Задаёт корневой каталог для запросов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2256 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2257 <example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2258 location /i/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2259 root /data/w3; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2260 } |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2261 </example> |
271 | 2262 в ответ на запрос “<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
|
2263 <path>/data/w3/i/top.gif</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2264 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2265 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2266 <para> |
271 | 2267 В значении параметра <value>путь</value> можно использовать переменные, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2268 кроме <var>$document_root</var> и <var>$realpath_root</var>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2269 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2270 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2271 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2272 Путь к файлу формируется путём простого добавления URI к значению директивы |
271 | 2273 <literal>root</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2274 Если же URI необходимо поменять, следует воспользоваться директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2275 <link id="alias"/>. |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2278 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2279 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2280 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2281 <directive name="satisfy"> |
271 | 2282 <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
|
2283 <default>all</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2284 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2285 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2286 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2287 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2288 <para> |
971
6316a7579448
Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents:
966
diff
changeset
|
2289 Разрешает доступ, если все (<literal>all</literal>) |
271 | 2290 или хотя бы один (<literal>any</literal>) из модулей |
971
6316a7579448
Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents:
966
diff
changeset
|
2291 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, |
1763
a7974b8d2a23
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1732
diff
changeset
|
2292 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, |
971
6316a7579448
Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents:
966
diff
changeset
|
2293 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link> |
1763
a7974b8d2a23
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1732
diff
changeset
|
2294 или |
a7974b8d2a23
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1732
diff
changeset
|
2295 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2296 разрешают доступ. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2297 </para> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2300 Пример: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2301 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2302 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2303 satisfy any; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2304 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2305 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
|
2306 deny all; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2307 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2308 auth_basic "closed site"; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2309 auth_basic_user_file conf/htpasswd; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2310 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2311 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2312 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2313 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2314 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2315 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2316 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2317 <directive name="send_lowat"> |
271 | 2318 <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
|
2319 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2320 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2321 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2322 <context>location</context> |
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 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2325 При установке этой директивы в ненулевое значение nginx будет пытаться |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2326 минимизировать число операций отправки на клиентских сокетах либо при |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2327 помощи флага <c-def>NOTE_LOWAT</c-def> метода |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2328 <link doc="../events.xml" id="kqueue"/>, |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2329 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>. |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2330 В обоих случаях будет использован указанный <value>размер</value>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2331 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2332 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2333 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2334 Эта директива игнорируется на Linux, Solaris и Windows. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2335 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2336 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2337 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2338 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2339 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2340 <directive name="send_timeout"> |
271 | 2341 <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
|
2342 <default>60s</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2343 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2344 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2345 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2346 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2347 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2348 Задаёт таймаут при передаче ответа клиенту. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2349 Таймаут устанавливается не на всю передачу ответа, |
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 Если по истечении этого времени клиент ничего не примет, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2352 соединение будет закрыто. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2353 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2354 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2355 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2356 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2357 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2358 <directive name="sendfile"> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2359 |
271 | 2360 <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
|
2361 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2362 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2363 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2364 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2365 <context>if в location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2366 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2367 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2368 Разрешает или запрещает использовать |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2369 <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
|
2370 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2371 |
1432
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2372 <para> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2373 Начиная с nginx 0.8.12 и FreeBSD 5.2.1, |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2374 можно использовать <link id="aio"/> для подгрузки данных |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2375 для <c-func>sendfile</c-func>: |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2376 <example> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2377 location /video/ { |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2378 sendfile on; |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2379 tcp_nopush on; |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2380 aio on; |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2381 } |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2382 </example> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2383 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2384 <c-def>SF_NODISKIO</c-def>, в результате чего она не блокируется на диске, а |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2385 сообщает об отсутствии данных в памяти. |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2386 После этого nginx инициирует асинхронную подгрузку данных, читая один байт. |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2387 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2388 при последующих чтениях файл подгружается частями только по 16K. |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2389 Изменить это можно с помощью директивы |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2390 <link id="read_ahead"/>. |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2391 <note> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2392 До версии 1.7.11 подгрузка данных включалась с помощью |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2393 <literal>aio sendfile;</literal>. |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2394 </note> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2395 </para> |
9012d7935c9b
Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents:
1430
diff
changeset
|
2396 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2397 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2398 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2399 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2400 <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
|
2401 |
271 | 2402 <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
|
2403 <default>0</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2404 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2405 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2406 <context>location</context> |
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 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2409 При установке в ненулевое значение ограничивает объём данных, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2410 который может передан за один вызов <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
|
2411 Без этого ограничения одно быстрое соединение может целиком |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2412 захватить рабочий процесс. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2413 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2414 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2415 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2416 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2417 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2418 <directive name="server"> |
108
72524ae53106
Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
2419 <syntax block="yes"/> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2420 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2421 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2422 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2423 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2424 Задаёт конфигурацию для виртуального сервера. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2425 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса) |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2426 и 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
|
2427 Вместо этого директивами <link id="listen"/> описываются все |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2428 адреса и порты, на которых нужно принимать соединения для этого сервера, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2429 а в директиве <link id="server_name"/> указываются все имена серверов. |
522
ef11546f75ee
Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
2430 Примеры конфигураций описаны в документе |
ef11546f75ee
Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
2431 “<link doc="request_processing.xml"/>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2432 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2435 |
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 <directive name="server_name"> |
271 | 2438 <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
|
2439 <default>""</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2440 <context>server</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2441 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2442 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2443 Задаёт имена виртуального сервера, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2444 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2445 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2446 server_name example.com www.example.com; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2447 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2448 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2449 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2450 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2451 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2452 Первое имя становится основным именем сервера. |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2453 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2454 |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2455 <para> |
271 | 2456 В именах серверов можно использовать звёздочку (“<literal>*</literal>”) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2457 для замены первой или последней части имени: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2458 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2459 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2460 server_name example.com *.example.com www.example.*; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2461 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2462 </example> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2463 Такие имена называются именами с маской. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2464 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2465 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2466 <para> |
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 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2469 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2470 server_name .example.com; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2471 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2472 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2473 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2474 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2475 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2476 В качестве имени сервера можно также использовать регулярное выражение, |
271 | 2477 указав перед ним тильду (“<literal>~</literal>”): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2478 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2479 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2480 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
|
2481 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2482 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2483 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2484 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2485 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2486 Регулярное выражение может содержать выделения (0.7.40), |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2487 которые могут затем использоваться в других директивах: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2488 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2489 server { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2490 server_name ~^(www\.)?(.+)$; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2491 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2492 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2493 root /sites/$2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2494 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2495 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2496 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2497 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2498 server_name _; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2499 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2500 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2501 root /sites/default; |
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2505 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2506 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2507 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2508 Именованные выделения в регулярном выражении создают переменные (0.8.25), |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2509 которые могут затем использоваться в других директивах: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2510 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2511 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2512 server_name ~^(www\.)?(?<domain>.+)$; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2513 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2514 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2515 root /sites/$domain; |
76
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 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2518 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2519 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2520 server_name _; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2521 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2522 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2523 root /sites/default; |
76
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2527 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2528 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2529 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2530 Если параметр директивы установлен в “<var>$hostname</var>” (0.9.4), то |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2531 подставляется имя хоста (hostname) машины. |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2532 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2533 |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2534 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2535 Возможно также указать пустое имя сервера (0.7.11): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2536 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2537 server { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2538 server_name www.example.com ""; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2539 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2540 </example> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2541 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2542 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2543 Это настройка по умолчанию. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2544 <note> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2545 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2546 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2547 </para> |
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> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2550 При поиске виртуального сервера по имени, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2551 если имени соответствует несколько из указанных вариантов, |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2552 например, одновременно подходят и имя с маской, и регулярное выражение, |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2553 будет выбран первый подходящий вариант в следующем порядке приоритета: |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2554 <list type="enum"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2555 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2556 <listitem> |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2557 точное имя |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2558 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2559 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2560 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2561 самое длинное имя с маской в начале, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2562 например “<literal>*.example.com</literal>” |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2563 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2564 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2565 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2566 самое длинное имя с маской в конце, |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2567 например “<literal>mail.*</literal>” |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2568 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2569 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2570 <listitem> |
587
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2571 первое подходящее регулярное выражение |
5bb7716cae7e
Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents:
580
diff
changeset
|
2572 (в порядке следования в конфигурационном файле) |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2573 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2574 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2575 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2576 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2577 |
646
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2578 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2579 Подробнее имена серверов обсуждаются в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2580 <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
|
2581 </para> |
2577ab264d1e
Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents:
629
diff
changeset
|
2582 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2583 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2584 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2585 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2586 <directive name="server_name_in_redirect"> |
271 | 2587 <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
|
2588 <default>off</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2589 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2590 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2591 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2592 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2593 <para> |
1879
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
2594 Разрешает или запрещает использовать в |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
2595 <link id="absolute_redirect">абсолютных</link> перенаправлениях, |
3685d90e133e
Documented the "absolute_redirect" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1859
diff
changeset
|
2596 выдаваемых nginx’ом, основное имя сервера, задаваемое директивой |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2597 <link id="server_name"/>. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2598 Если использование основного имени сервера запрещено, то используется имя, |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2599 указанное в поле <header>Host</header> заголовка запроса. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2600 Если же этого поля нет, то используется IP-адрес сервера. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2601 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2602 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2603 <para> |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2604 Использование в перенаправлениях порта управляется |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2605 директивой <link id="port_in_redirect"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2606 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2607 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2608 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2609 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2610 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2611 <directive name="server_names_hash_bucket_size"> |
271 | 2612 <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
|
2613 <default>32|64|128</default> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2614 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2615 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2616 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2617 Задаёт размер корзины в хэш-таблицах имён серверов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2618 Значение по умолчанию зависит от размера строки кэша процессора. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2619 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2620 <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
|
2621 </para> |
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 </directive> |
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 <directive name="server_names_hash_max_size"> |
271 | 2627 <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
|
2628 <default>512</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2629 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2630 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2631 <para> |
271 | 2632 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2633 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2634 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2635 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2636 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2637 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2638 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2639 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2640 <directive name="server_tokens"> |
1680
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2641 <syntax> |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2642 <literal>on</literal> | |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2643 <literal>off</literal> | |
1904
d59199b0c022
Documented the "build" parameter of the "server_tokens" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1903
diff
changeset
|
2644 <literal>build</literal> | |
1680
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2645 <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
|
2646 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2647 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2648 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2649 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2650 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2651 <para> |
1903
da00a2526415
Replaced "error messages" with "error pages" in server_tokens.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1881
diff
changeset
|
2652 Разрешает или запрещает выдавать версию nginx’а на страницах ошибок и |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2653 в поле <header>Server</header> заголовка ответа. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2654 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2655 |
1904
d59199b0c022
Documented the "build" parameter of the "server_tokens" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1903
diff
changeset
|
2656 <para id="server_tokens_build"> |
1953
408eed0bf491
Clarified description of server_tokens build.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1923
diff
changeset
|
2657 Если указан параметр <literal>build</literal> (1.11.10), |
408eed0bf491
Clarified description of server_tokens build.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1923
diff
changeset
|
2658 то наряду с версией nginx’а будет также выдаваться |
408eed0bf491
Clarified description of server_tokens build.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1923
diff
changeset
|
2659 <link doc="../configure.xml" id="build">имя сборки</link>. |
1904
d59199b0c022
Documented the "build" parameter of the "server_tokens" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1903
diff
changeset
|
2660 </para> |
d59199b0c022
Documented the "build" parameter of the "server_tokens" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1903
diff
changeset
|
2661 |
1680
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2662 <para> |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2663 Дополнительно, как часть |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2664 <commercial_version>коммерческой подписки</commercial_version>, |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2665 начиная с версии 1.9.13 |
1903
da00a2526415
Replaced "error messages" with "error pages" in server_tokens.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1881
diff
changeset
|
2666 подписи на страницах ошибок и |
1680
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2667 значение поля <header>Server</header> заголовка ответа |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2668 можно задать явно с помощью строки с переменными. |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2669 Пустая строка запрещает выдачу поля <header>Server</header>. |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2670 </para> |
57c3f36b3b6a
Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents:
1665
diff
changeset
|
2671 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2672 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2673 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2674 |
2118
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2675 <directive name="subrequest_output_buffer_size"> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2676 <syntax><value>размер</value></syntax> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2677 <default>4k|8k</default> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2678 <context>http</context> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2679 <context>server</context> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2680 <context>location</context> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2681 <appeared-in>1.13.10</appeared-in> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2682 |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2683 <para> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2684 Задаёт <value>размер</value> буфера, используемого для |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2685 хранения тела ответа подзапроса. |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2686 По умолчанию размер одного буфера равен размеру страницы памяти. |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2687 В зависимости от платформы это или 4K, или 8K, |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2688 однако его можно сделать меньше. |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2689 </para> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2690 |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2691 <para> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2692 Директива применима только для подзапросов, |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2693 тело ответа которых сохраняется в памяти. |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2694 Например, подобные подзапросы создаются при помощи |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2695 <link doc="ngx_http_ssi_module.xml" id="ssi_include_set">SSI</link>. |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2696 </para> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2697 |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2698 </directive> |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2699 |
0b3103eabdf1
Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2039
diff
changeset
|
2700 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2701 <directive name="tcp_nodelay"> |
271 | 2702 <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
|
2703 <default>on</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2704 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2705 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2706 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2707 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2708 <para> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2709 Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>. |
2121
cf9e3d2893b6
Fixed description of the http tcp_nodelay directive.
Ruslan Ermilov <ru@nginx.com>
parents:
2118
diff
changeset
|
2710 Параметр включается при переходе соединения в состояние keep-alive. |
cf9e3d2893b6
Fixed description of the http tcp_nodelay directive.
Ruslan Ermilov <ru@nginx.com>
parents:
2118
diff
changeset
|
2711 Также, он включается на SSL-соединениях, |
cf9e3d2893b6
Fixed description of the http tcp_nodelay directive.
Ruslan Ermilov <ru@nginx.com>
parents:
2118
diff
changeset
|
2712 при небуферизованном проксировании |
cf9e3d2893b6
Fixed description of the http tcp_nodelay directive.
Ruslan Ermilov <ru@nginx.com>
parents:
2118
diff
changeset
|
2713 и при проксировании <link doc="websocket.xml">WebSocket</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2714 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2715 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2716 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2717 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2718 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2719 <directive name="tcp_nopush"> |
271 | 2720 <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
|
2721 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2722 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2723 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2724 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2725 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2726 <para> |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2727 Разрешает или запрещает использование параметра сокета |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2728 <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
|
2729 <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
|
2730 Параметр включаются только при использовании <link id="sendfile"/>. |
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
2731 Включение параметра позволяет |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2732 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2733 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2734 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2735 передавать заголовок ответа и начало файла в одном пакете |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2736 в Linux и во FreeBSD 4.*; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2737 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2738 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2739 <listitem> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2740 передавать файл полными пакетами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2741 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2742 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2743 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2744 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2745 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2746 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2747 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2748 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2749 <directive name="try_files"> |
364 | 2750 <syntax><value>файл</value> ... <value>uri</value></syntax> |
2751 <syntax><value>файл</value> ... =<value>код</value></syntax> | |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
79
diff
changeset
|
2752 <default/> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2753 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2754 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2755 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2756 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2757 Проверяет существование файлов в заданном порядке и использует |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2758 для обработки запроса первый найденный файл, причём обработка |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
2759 делается в контексте этого же location’а. |
271 | 2760 Путь к файлу строится из параметра <value>файл</value> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2761 в соответствии с директивами |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2762 <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
|
2763 С помощью слэша в конце имени можно проверить существование каталога, |
271 | 2764 например, “<literal>$uri/</literal>”. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2765 В случае, если ни один файл не найден, то делается внутреннее |
271 | 2766 перенаправление на <value>uri</value>, заданный последним параметром. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2767 Например: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2768 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2769 location /images/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2770 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
|
2771 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2772 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2773 location = /images/default.gif { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2774 expires 30s; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2775 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2776 </example> |
271 | 2777 Последний параметр может также указывать на именованный location, |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2778 как в примерах ниже. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2779 С версии 0.7.51 последний параметр может также быть <value>кодом</value>: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2780 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2781 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2782 try_files $uri $uri/index.html $uri.html =404; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2783 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2784 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2785 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2786 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2787 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2788 Пример использования при проксировании Mongrel: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2789 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2790 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2791 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
|
2792 $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
|
2793 @mongrel; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2794 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2795 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2796 location @mongrel { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2797 proxy_pass http://mongrel; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2798 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2799 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2800 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2801 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2802 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2803 Пример использования вместе с Drupal/FastCGI: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2804 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2805 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2806 try_files $uri $uri/ @drupal; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2807 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2808 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2809 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2810 try_files $uri @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2811 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2812 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2813 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2814 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
|
2815 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
|
2816 fastcgi_param QUERY_STRING $args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2817 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2818 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2819 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2820 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2821 location @drupal { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2822 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2823 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2824 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
|
2825 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
|
2826 fastcgi_param QUERY_STRING q=$uri&$args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2827 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2828 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2829 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2830 </example> |
271 | 2831 В следующем примере директива <literal>try_files</literal> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2832 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2833 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2834 try_files $uri $uri/ @drupal; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2835 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2836 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2837 аналогична директивам |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2838 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2839 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2840 error_page 404 = @drupal; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2841 log_not_found off; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2842 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2843 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2844 А здесь |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2845 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2846 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2847 try_files $uri @drupal; |
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 fastcgi_pass ...; |
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 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2852 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2853 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2854 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2855 </example> |
271 | 2856 <literal>try_files</literal> проверяет существование PHP-файла, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2857 прежде чем передать запрос FastCGI-серверу. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2858 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2859 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2860 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2861 Пример использования вместе с Wordpress и Joomla: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2862 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2863 location / { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2864 try_files $uri $uri/ @wordpress; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2865 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2866 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2867 location ~ \.php$ { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2868 try_files $uri @wordpress; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2869 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2870 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2871 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2872 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2873 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2874 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2875 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2876 location @wordpress { |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2877 fastcgi_pass ...; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2878 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2879 fastcgi_param SCRIPT_FILENAME /path/to/index.php; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2880 ... прочие fastcgi_param |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2881 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2882 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2883 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2884 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2885 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2886 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2887 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2888 <directive name="types"> |
108
72524ae53106
Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
2889 <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
|
2890 <default> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2891 text/html html; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2892 image/gif gif; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2893 image/jpeg jpg; |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
2894 </default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2895 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2896 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2897 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2898 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2899 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2900 Задаёт соответствие расширений имён файлов и MIME-типов ответов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2901 Расширения нечувствительны к регистру символов. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2902 Одному MIME-типу может соответствовать несколько расширений, например: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2903 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2904 types { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2905 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
|
2906 application/octet-stream deb; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2907 application/octet-stream dmg; |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2908 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2909 </example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2910 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2911 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2912 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2913 Достаточно полная таблица соответствий входит в дистрибутив nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2914 и находится в файле <path>conf/mime.types</path>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2915 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2916 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2917 <para> |
966 | 2918 Для того чтобы для определённого location’а для всех ответов |
271 | 2919 выдавался 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
|
2920 можно использовать следующее: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2921 <example> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2922 location /download/ { |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2923 types { } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2924 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
|
2925 } |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2926 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2927 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2928 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2929 </directive> |
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 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2932 <directive name="types_hash_bucket_size"> |
271 | 2933 <syntax><value>размер</value></syntax> |
1132
8bdb4eb27f48
Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents:
1108
diff
changeset
|
2934 <default>64</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2935 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2936 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2937 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2938 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2939 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2940 Задаёт размер корзины в хэш-таблицах типов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2941 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2942 <link doc="../hash.xml">документе</link>. |
1132
8bdb4eb27f48
Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents:
1108
diff
changeset
|
2943 <note> |
8bdb4eb27f48
Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents:
1108
diff
changeset
|
2944 До версии 1.5.13 |
8bdb4eb27f48
Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents:
1108
diff
changeset
|
2945 значение по умолчанию зависело от размера строки кэша процессора. |
8bdb4eb27f48
Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents:
1108
diff
changeset
|
2946 </note> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2947 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2948 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2949 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2950 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2951 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2952 <directive name="types_hash_max_size"> |
271 | 2953 <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
|
2954 <default>1024</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2955 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2956 <context>server</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2957 <context>location</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2958 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2959 <para> |
271 | 2960 Задаёт максимальный <value>размер</value> хэш-таблиц типов. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2961 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
2962 <link doc="../hash.xml">документе</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2963 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2964 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2965 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2966 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2967 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2968 <directive name="underscores_in_headers"> |
271 | 2969 <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
|
2970 <default>off</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2971 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2972 <context>server</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2973 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2974 <para> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2975 Разрешает или запрещает использование символов подчёркивания в |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2976 полях заголовка запроса клиента. |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2977 Если использование символов подчёркивания запрещено, поля заголовка запроса, в |
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
2978 именах которых есть подчёркивания, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2979 помечаются как недопустимые и подпадают под действие директивы |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2980 <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
|
2981 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2982 |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2983 <para> |
1023
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
2984 Если директива указана на уровне <link id="server"/>, |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
2985 её значение используется только в том случае, |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
2986 если сервер является сервером по умолчанию. |
375055da60fa
Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents:
971
diff
changeset
|
2987 Указанное значение распространяется на все виртуальные серверы, |
426
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2988 слушающие на том же адресе и порту. |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2989 </para> |
1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents:
419
diff
changeset
|
2990 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2991 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2992 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2993 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2994 <directive name="variables_hash_bucket_size"> |
271 | 2995 <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
|
2996 <default>64</default> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2997 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2998 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
2999 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3000 Задаёт размер корзины в хэш-таблице переменных. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
3001 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
3002 <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
|
3003 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3004 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3005 </directive> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3006 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3007 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3008 <directive name="variables_hash_max_size"> |
271 | 3009 <syntax><value>размер</value></syntax> |
1108
a0543e9213e7
New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents:
1097
diff
changeset
|
3010 <default>1024</default> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3011 <context>http</context> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3012 |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3013 <para> |
271 | 3014 Задаёт максимальный <value>размер</value> хэш-таблицы переменных. |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
3015 Подробнее настройка хэш-таблиц обсуждается в отдельном |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
651
diff
changeset
|
3016 <link doc="../hash.xml">документе</link>. |
1108
a0543e9213e7
New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents:
1097
diff
changeset
|
3017 <note> |
a0543e9213e7
New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents:
1097
diff
changeset
|
3018 До версии 1.5.13 по умолчанию использовалось значение 512. |
a0543e9213e7
New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents:
1097
diff
changeset
|
3019 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3020 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3021 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3022 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3023 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3024 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3025 |
364 | 3026 |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3027 <section id="variables" name="Встроенные переменные"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3028 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3029 <para> |
364 | 3030 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные |
3031 переменные, имена которых совпадают с именами переменных веб-сервера Apache. | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3032 Прежде всего, это переменные, представляющие из себя поля заголовка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3033 запроса клиента, такие как <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
|
3034 и тому подобное. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3035 Кроме того, есть и другие переменные: |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3036 <list type="tag"> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3037 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3038 <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
|
3039 <tag-desc> |
271 | 3040 аргумент <value>имя</value> в строке запроса |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3041 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3042 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3043 <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
|
3044 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3045 аргументы в строке запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3046 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3047 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3048 <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
|
3049 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3050 адрес клиента в бинарном виде, длина значения всегда 4 байта |
1699
6c96a644b0b3
Corrected description of $binary_remote_addr and saved state.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1692
diff
changeset
|
3051 для IPv4-адресов или 16 байт для IPv6-адресов |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3052 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3053 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3054 <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
|
3055 <tag-desc> |
769
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3056 число байт, переданное клиенту, без учёта заголовка ответа; |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3057 переменная совместима с параметром “<literal>%B</literal>” модуля Apache |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3058 <literal>mod_log_config</literal> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3059 </tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3060 |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3061 <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
|
3062 <tag-desc> |
1769
cc9d4e09a708
Corrected Russian language in $bytes_sent.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1763
diff
changeset
|
3063 число байт, переданных клиенту (1.3.8, 1.2.5) |
769
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3064 </tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3065 |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3066 <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
|
3067 <tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3068 порядковый номер соединения (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
|
3069 </tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3070 |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3071 <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
|
3072 <tag-desc> |
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3073 текущее число запросов в соединении (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
|
3074 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3075 |
2707
c1d62e514b3c
Documented the $connection_time variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2706
diff
changeset
|
3076 <tag-name id="var_connection_time"><var>$connection_time</var></tag-name> |
c1d62e514b3c
Documented the $connection_time variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2706
diff
changeset
|
3077 <tag-desc> |
c1d62e514b3c
Documented the $connection_time variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2706
diff
changeset
|
3078 время соединения в секундах с точностью до миллисекунд (1.19.10) |
c1d62e514b3c
Documented the $connection_time variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2706
diff
changeset
|
3079 </tag-desc> |
c1d62e514b3c
Documented the $connection_time variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2706
diff
changeset
|
3080 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3081 <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
|
3082 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3083 поле <header>Content-Length</header> заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3084 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3085 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3086 <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
|
3087 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3088 поле <header>Content-Type</header> заголовка запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3089 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3090 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3091 <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
|
3092 <tag-desc> |
271 | 3093 cookie <value>имя</value> |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3094 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3095 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3096 <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
|
3097 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
3098 значение директивы <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
|
3099 для текущего запроса |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3100 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3101 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3102 <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
|
3103 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3104 то же, что и <var>$uri</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3105 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3106 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3107 <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
|
3108 <tag-desc> |
940
ded8f4a5de28
Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents:
914
diff
changeset
|
3109 в порядке приоритета: |
ded8f4a5de28
Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents:
914
diff
changeset
|
3110 имя хоста из строки запроса, или |
ded8f4a5de28
Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents:
914
diff
changeset
|
3111 имя хоста из поля <header>Host</header> заголовка запроса, или |
ded8f4a5de28
Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents:
914
diff
changeset
|
3112 имя сервера, соответствующего запросу |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3113 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3114 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3115 <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
|
3116 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3117 имя хоста |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3118 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3119 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3120 <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
|
3121 <tag-desc> |
448
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
3122 произвольное поле заголовка запроса; |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
3123 последняя часть имени переменной соответствует имени поля, приведённому |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
3124 к нижнему регистру, с заменой символов тире на символы подчёркивания |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3125 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3126 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3127 <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
|
3128 <tag-desc> |
271 | 3129 “<literal>on</literal>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3130 если соединение работает в режиме SSL, |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3131 либо пустая строка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3132 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3133 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3134 <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
|
3135 <tag-desc> |
271 | 3136 “<literal>?</literal>”, если в строке запроса есть аргументы, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3137 и пустая строка, если их нет |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3138 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3139 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3140 <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
|
3141 <tag-desc> |
767
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
3142 установка этой переменной позволяет ограничивать скорость |
1bb8b733416a
Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents:
741
diff
changeset
|
3143 передачи ответа, см. <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
|
3144 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3145 |
771
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
3146 <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
|
3147 <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
|
3148 текущее время в секундах с точностью до миллисекунд (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
|
3149 </tag-desc> |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
3150 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3151 <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
|
3152 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3153 версия nginx |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3154 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3155 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3156 <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
|
3157 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3158 номер (PID) рабочего процесса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3159 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3160 |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3161 <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
|
3162 <tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3163 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>” |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
3164 (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
|
3165 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3166 |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3167 <tag-name id="var_proxy_protocol_addr"><var>$proxy_protocol_addr</var></tag-name> |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3168 <tag-desc> |
2457
3896055c397e
Fixed descriptions of $proxy_protocol_addr and $proxy_protocol_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
3169 адрес клиента, полученный из заголовка протокола PROXY (1.5.12) |
1097
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3170 <para> |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3171 Протокол PROXY должен быть предварительно включён при помощи установки |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3172 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>. |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3173 </para> |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3174 </tag-desc> |
eeb690d4212b
Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1037
diff
changeset
|
3175 |
1704
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3176 <tag-name id="var_proxy_protocol_port"><var>$proxy_protocol_port</var></tag-name> |
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3177 <tag-desc> |
2457
3896055c397e
Fixed descriptions of $proxy_protocol_addr and $proxy_protocol_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
3178 порт клиента, полученный из заголовка протокола PROXY (1.11.0) |
1704
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3179 <para> |
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3180 Протокол PROXY должен быть предварительно включён при помощи установки |
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3181 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>. |
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3182 </para> |
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3183 </tag-desc> |
792478434bb1
Documented the $proxy_protocol_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1699
diff
changeset
|
3184 |
2458
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3185 <tag-name id="var_proxy_protocol_server_addr"><var>$proxy_protocol_server_addr</var></tag-name> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3186 <tag-desc> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3187 адрес сервера, полученный из заголовка протокола PROXY (1.17.6) |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3188 <para> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3189 Протокол PROXY должен быть предварительно включён при помощи установки |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3190 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>. |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3191 </para> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3192 </tag-desc> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3193 |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3194 <tag-name id="var_proxy_protocol_server_port"><var>$proxy_protocol_server_port</var></tag-name> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3195 <tag-desc> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3196 порт сервера, полученный из заголовка протокола PROXY (1.17.6) |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3197 <para> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3198 Протокол PROXY должен быть предварительно включён при помощи установки |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3199 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>. |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3200 </para> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3201 </tag-desc> |
9cd5883ac546
Documented $proxy_protocol_server_addr, $proxy_protocol_server_port.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2457
diff
changeset
|
3202 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3203 <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
|
3204 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3205 то же, что и <var>$args</var> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3206 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3207 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3208 <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
|
3209 <tag-desc> |
436
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
3210 абсолютный путь, соответствующий |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
3211 значению директивы <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
|
3212 для текущего запроса, |
3a9f39341c7c
- Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents:
431
diff
changeset
|
3213 в котором все символические ссылки преобразованы в реальные пути |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3214 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3215 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3216 <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
|
3217 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3218 адрес клиента |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3219 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3220 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3221 <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
|
3222 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3223 порт клиента |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3224 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3225 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3226 <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
|
3227 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3228 имя пользователя, использованное в Basic аутентификации |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3229 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3230 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3231 <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
|
3232 <tag-desc> |
431
0412333658fe
Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents:
429
diff
changeset
|
3233 первоначальная строка запроса целиком |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3234 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3235 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3236 <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
|
3237 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3238 тело запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3239 <para> |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
617
diff
changeset
|
3240 Значение переменной появляется в location’ах, обрабатываемых |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3241 директивами |
1181 | 3242 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>, |
1194 | 3243 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>, |
3244 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3245 и |
1732
5eb54b170c74
Clarified cases when $request_body is not empty.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1721
diff
changeset
|
3246 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>, |
5eb54b170c74
Clarified cases when $request_body is not empty.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1721
diff
changeset
|
3247 когда тело было прочитано в |
5eb54b170c74
Clarified cases when $request_body is not empty.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1721
diff
changeset
|
3248 <link id="client_body_buffer_size">буфер в памяти</link>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3249 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3250 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3251 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3252 <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
|
3253 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3254 имя временного файла, в котором хранится тело запроса |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3255 <para> |
958
fd1f8e0a405e
Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
948
diff
changeset
|
3256 По завершении обработки файл необходимо удалить. |
966 | 3257 Для того чтобы тело запроса всегда записывалось в файл, |
406
98dac2bd7598
Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents:
400
diff
changeset
|
3258 следует включить <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
|
3259 При передаче имени временного файла в проксированном запросе |
1194 | 3260 или в запросе к FastCGI/uwsgi/SCGI-серверу следует запретить передачу самого |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3261 тела директивами |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3262 <link doc="ngx_http_proxy_module.xml" id="proxy_pass_request_body"> |
1181 | 3263 proxy_pass_request_body off</link>, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3264 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass_request_body"> |
1194 | 3265 fastcgi_pass_request_body off</link>, |
3266 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass_request_body"> | |
3267 uwsgi_pass_request_body off</link> | |
1181 | 3268 или |
3269 <link doc="ngx_http_scgi_module.xml" id="scgi_pass_request_body"> | |
3270 scgi_pass_request_body off</link> | |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3271 соответственно. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3272 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3273 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3274 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3275 <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
|
3276 <tag-desc> |
271 | 3277 “<literal>OK</literal>” если запрос завершился, |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3278 либо пустая строка |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3279 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3280 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3281 <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
|
3282 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3283 путь к файлу для текущего запроса, формируемый из директив |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3284 <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
|
3285 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3286 |
1692
4319f72f11f5
Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1680
diff
changeset
|
3287 <tag-name id="var_request_id"><var>$request_id</var></tag-name> |
4319f72f11f5
Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1680
diff
changeset
|
3288 <tag-desc> |
1721
737c86e8b316
Clarified meaning of the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1704
diff
changeset
|
3289 уникальный идентификатор запроса, |
737c86e8b316
Clarified meaning of the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1704
diff
changeset
|
3290 сформированный из 16 случайных байт, в шестнадцатеричном виде (1.11.0) |
1692
4319f72f11f5
Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1680
diff
changeset
|
3291 </tag-desc> |
4319f72f11f5
Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1680
diff
changeset
|
3292 |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3293 <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
|
3294 <tag-desc> |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
3295 длина запроса (включая строку запроса, заголовок и тело запроса) |
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
3296 (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
|
3297 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3298 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3299 <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
|
3300 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3301 метод запроса, обычно |
271 | 3302 “<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
|
3303 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3304 |
771
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
3305 <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
|
3306 <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
|
3307 время обработки запроса в секундах с точностью до миллисекунд |
32b8498cfb40
$msec and $request_time have become generic variables in 1.2.6.
Ruslan Ermilov <ru@nginx.com>
parents:
771
diff
changeset
|
3308 (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
|
3309 время, прошедшее с момента чтения первых байт от клиента |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
3310 </tag-desc> |
47ad88faaa3f
$msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents:
769
diff
changeset
|
3311 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3312 <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
|
3313 <tag-desc> |
431
0412333658fe
Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents:
429
diff
changeset
|
3314 первоначальный URI запроса целиком (с аргументами) |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3315 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3316 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3317 <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
|
3318 <tag-desc> |
271 | 3319 схема запроса, “<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
|
3320 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3321 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3322 <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
|
3323 <tag-desc> |
448
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
3324 произвольное поле заголовка ответа; |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
3325 последняя часть имени переменной соответствует имени поля, приведённому |
92672f6f0ee1
Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents:
442
diff
changeset
|
3326 к нижнему регистру, с заменой символов тире на символы подчёркивания |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3327 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3328 |
2003
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3329 <tag-name id="var_sent_trailer_"><var>$sent_trailer_</var><value>имя</value></tag-name> |
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3330 <tag-desc> |
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3331 произвольное поле, отправленное в конце ответа (1.13.2); |
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3332 последняя часть имени переменной соответствует имени поля, приведённому |
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3333 к нижнему регистру, с заменой символов тире на символы подчёркивания |
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3334 </tag-desc> |
be779702663e
Documented the "sent_trailer_" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1964
diff
changeset
|
3335 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3336 <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
|
3337 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3338 адрес сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3339 <para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3340 Получение значения этой переменной обычно требует одного системного вызова. |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3341 Чтобы избежать системного вызова, в директивах <link id="listen"/> |
271 | 3342 следует указывать адреса и использовать параметр <literal>bind</literal>. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3343 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3344 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3345 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3346 <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
|
3347 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3348 имя сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3349 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3350 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3351 <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
|
3352 <tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3353 порт сервера, принявшего запрос |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3354 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3355 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3356 <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
|
3357 <tag-desc> |
1597
8b97ba73129b
Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1576
diff
changeset
|
3358 протокол запроса, обычно |
8b97ba73129b
Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1576
diff
changeset
|
3359 “<literal>HTTP/1.0</literal>”, |
8b97ba73129b
Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1576
diff
changeset
|
3360 “<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
|
3361 или |
1597
8b97ba73129b
Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1576
diff
changeset
|
3362 “<link doc="ngx_http_v2_module.xml">HTTP/2.0</link>” |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3363 </tag-desc> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3364 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3365 <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
|
3366 <tag-desc> |
769
d71e56d56ada
Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents:
768
diff
changeset
|
3367 статус ответа (1.3.2, 1.2.2) |
541
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
3368 </tag-desc> |
a8971cf346be
Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents:
537
diff
changeset
|
3369 |
826
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3370 <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
|
3371 <tag-desc> |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
3372 локальное время в формате по стандарту 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
|
3373 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3374 |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3375 <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
|
3376 <tag-desc> |
840
9dab69f2b71d
Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents:
835
diff
changeset
|
3377 локальное время в 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
|
3378 </tag-desc> |
ddd22f571529
Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents:
810
diff
changeset
|
3379 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3380 <tag-name id="var_tcpinfo_"> |
453
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3381 <var>$tcpinfo_rtt</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3382 <var>$tcpinfo_rttvar</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3383 <var>$tcpinfo_snd_cwnd</var>, |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3384 <var>$tcpinfo_rcv_space</var> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3385 </tag-name> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3386 <tag-desc> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3387 информация о клиентском TCP-соединении; доступна на системах, |
617
368a449e85b8
Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents:
615
diff
changeset
|
3388 поддерживающих параметр сокета <c-def>TCP_INFO</c-def> |
453
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3389 </tag-desc> |
98ee97a382d3
Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents:
448
diff
changeset
|
3390 |
768
f63b7fa3bf17
Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents:
767
diff
changeset
|
3391 <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
|
3392 <tag-desc> |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
3393 текущий 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
|
3394 <para> |
503
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
3395 Значение <var>$uri</var> может изменяться в процессе обработки запроса, |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
3396 например, при внутренних перенаправлениях |
aed015c3dedd
Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents:
499
diff
changeset
|
3397 или при использовании индексных файлов. |
253
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3398 </para> |
ff1e139a8c98
Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
3399 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3400 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3401 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3402 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3403 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3404 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3405 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3406 </module> |