Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 1432:9012d7935c9b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented that "aio sendfile" is deprecated. This also made it possible to move the description of sendfile() pre-loading from "aio" to "sendfile".
author Ruslan Ermilov <ru@nginx.com>
date Tue, 17 Mar 2015 09:18:35 +0300
parents 0eb8e261f349
children 2333e08e277d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 108
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
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
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 587
diff changeset
12 lang="ru"
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
13 rev="38">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
15 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <directive name="aio">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
18 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
19 <literal>on</literal> |
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
20 <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
21 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
22 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
23 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
24 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
25 <appeared-in>0.8.11</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
28 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO)
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
29 во FreeBSD и Linux:
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
30 <example>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
31 location /video/ {
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
32 aio on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
33 output_buffers 1 64k;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
34 }
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
35 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
39 Во FreeBSD AIO можно использовать, начиная с FreeBSD&nbsp;4.3.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
40 AIO можно либо собрать в ядре статически:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 options VFS_AIO
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
44 либо загрузить динамически через загружаемый модуль ядра:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46 kldload aio
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49
1430
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
50 <!--
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
52 В версиях FreeBSD 5 и 6 включение AIO статически или динамически
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
53 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
54 будет использовать блокировку Giant, что может негативно сказаться на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
55 производительности системы в целом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
56 Это ограничение устранено во FreeBSD&nbsp;6.4-STABLE в 2009 году
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
57 и во FreeBSD&nbsp;7.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
58 Однако, начиная с FreeBSD&nbsp;5.3 есть возможность включать AIO,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
59 не связывая сетевую подсистему блокировкой Giant — для этого модуль
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
60 AIO нужно подгружать уже после загрузки ядра.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
61 В этом случае в <path>/var/log/messages</path> появится следующее сообщение:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
62 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67 <note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
68 Требование использовать блокировку Giant в AIO связано с тем, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
69 FreeBSD поддерживает асинхронные вызовы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
70 <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
71 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
72 <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
73 для работы с сокетами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
74 Но поскольку nginx использует AIO только для работы с диском,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
75 то проблем не возникает.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
76 </note>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77 </para>
1430
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
78 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
81 В Linux AIO можно использовать только начиная с версии ядра 2.6.22.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
82 Кроме того, необходимо также дополнительно включить
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
83 <link id="directio"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
84 иначе чтение будет блокирующимся:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
85 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
86 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
87 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
88 directio 512;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
89 output_buffers 1 128k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
94 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
95 В Linux
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
96 <link id="directio"/>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
97 можно использовать только для чтения блоков, выравненных
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
98 на границу 512 байт (или 4К для XFS).
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
99 Невыравненный конец файла будет читаться блокированно.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
100 То же относится к запросам с указанием диапазона запрашиваемых байт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
101 (byte-range requests) и к запросам FLV не с начала файла: чтение
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
102 невыравненных начала и конца ответа будет блокирующимся.
1430
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
103 </para>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
104
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
105 <para>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
106 При одновременном включении 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
107 для файлов, размер которых больше либо равен указанному
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
108 в директиве <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
109 а для файлов меньшего размера
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
110 или при выключенном <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
111 <example>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
112 location /video/ {
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
113 sendfile on;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
114 aio on;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
115 directio 8m;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
116 }
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
117 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
118 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
120 <para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
121 См. также директиву <link id="sendfile"/>.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
122 </para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
123
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
124 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
125
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
126
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
127 <directive name="alias">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
128 <syntax><value>путь</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
129 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
130 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
131
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
132 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
133 Задаёт замену для указанного location’а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
134 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
136 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
137 alias /data/w3/images/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
138 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
139 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
140 на запрос
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
141 “<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
142 <path>/data/w3/images/top.gif</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
145 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
146 В значении параметра <value>путь</value> можно использовать переменные,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
147 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
151 Если <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
152 регулярным выражением, то регулярное выражение должно содержать
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
153 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
154 (0.7.40), например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
156 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
157 alias /data/w3/images/$1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
159 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
162 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
163 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
165 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
166 alias /data/w3/images/;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
167 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
168 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
169 то лучше воспользоваться директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
170 <link id="root"/>:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
171 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
172 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
173 root /data/w3;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
176 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
177
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
178 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
179
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
180
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
181 <directive name="chunked_transfer_encoding">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
182 <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
183 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
184 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
185 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
186 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
187
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
188 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
189 Позволяет запретить формат передачи данных частями (chunked transfer
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
190 encoding) в HTTP/1.1.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
191 Это может понадобиться при использовании программ, не поддерживающих
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
192 chunked encoding, несмотря на требования стандарта.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
193 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
194
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
195 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
196
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
197
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
198 <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
199
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
200 <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
201 <default>8k|16k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
202 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
203 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
204 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
205
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
206 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
207 Задаёт размер буфера для чтения тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
208 Если тело запроса больше заданного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
209 то всё тело запроса или только его часть записывается во
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
210 <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
211 По умолчанию размер одного буфера равен двум размерам страницы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
212 На 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
213 На других 64-битных платформах это обычно 16K.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
214 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
215
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
216 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
219 <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
220 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
221 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
222 <literal>clean</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
223 <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
224 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
225 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
226 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
227 <context>location</context>
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
230 Определяет, сохранять ли всё тело запроса клиента в файл.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
231 Директиву можно использовать для отладки и при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
232 <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
233 или метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
234 <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
235 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
236 <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
237 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
238
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
239 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
240 При установке значения <literal>on</literal> временные файлы
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
241 по окончании обработки запроса не удаляются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
242 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
245 Значение <literal>clean</literal> разрешает удалять временные файлы,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
246 оставшиеся по окончании обработки запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
247 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
248
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
250
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
251
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
252 <directive name="client_body_in_single_buffer">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
253 <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
254 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
255 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
256 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
257 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
258
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
259 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
260 Определяет, сохранять ли всё тело запроса клиента в одном буфере.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
261 Директива рекомендуется при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
262 <var>$request_body</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
263 для уменьшения требуемого числа операций копирования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
264 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
265
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
266 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
267
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
268
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
269 <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
270 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
271 <value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
272 [<value>уровень1</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
273 [<value>уровень2</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
274 [<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
275 <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
276 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
277 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
278 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
279
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
280 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
281 Задаёт каталог для хранения временных файлов с телами запросов клиентов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
282 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
283 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
284 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
285 client_body_temp_path /spool/nginx/client_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
286 </example>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
287 путь к временному файлу будет следующего вида:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
288 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
289 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
290 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
291 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
292
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
293 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
294
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
295
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
296 <directive name="client_body_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
297 <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
298 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
299 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
300 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
301 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
302
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
303 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
304 Задаёт таймаут при чтении тела запроса клиента.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
305 Таймаут устанавливается не на всю передачу тела запроса,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
306 а только между двумя последовательными операциями чтения.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
307 Если по истечении этого времени клиент ничего не передаст,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
308 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
309 <http-status code="408" text="Request Time-out"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
310 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
311
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
314
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
315 <directive name="client_header_buffer_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
316 <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
317 <default>1k</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
318 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
319 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
320
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
321 <para>
253
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 Для большинства запросов достаточно буфера размером в 1K байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
324 Однако если в запросе есть длинные cookies, или же запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
325 пришёл от WAP-клиента, то он может не поместиться в 1K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
326 Поэтому, если строка запроса или поле заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
327 не помещаются полностью в этот буфер, то выделяются буферы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
328 большего размера, задаваемые директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
329 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
330 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
331
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
332 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
333
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
334
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335 <directive name="client_header_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
336 <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
337 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
338 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
339 <context>server</context>
76
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
342 Задаёт таймаут при чтении заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
343 Если по истечении этого времени клиент не передаст полностью заголовок,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
344 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
345 <http-status code="408" text="Request Time-out"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
346 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
349
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
350
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
351 <directive name="client_max_body_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
352 <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
353 <default>1m</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
354 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
355 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
356 <context>location</context>
76
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
359 Задаёт максимально допустимый размер тела запроса клиента,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
360 указываемый в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
361 <header>Content-Length</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
362 заголовка запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
363 Если размер больше заданного, то клиенту возвращается ошибка
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
364 <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
365 Следует иметь в виду, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
366 <!--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
367 эту ошибку<!--/link-->.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
368 Установка параметра <value>размер</value> в 0 отключает
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
369 проверку размера тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
370 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
371
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
372 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
373
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
374
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
375 <directive name="connection_pool_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
376 <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
377 <default>256</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
378 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
379 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
380
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
381 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
382 Позволяет производить точную настройку выделения памяти
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
383 под конкретные соединения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
384 Эта директива не оказывает существенного влияния на
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
385 производительность, и её не следует использовать.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
386 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
387
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
388 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
389
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
390
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
391 <directive name="default_type">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
392 <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
393 <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
394 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
395 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
396 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
397
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
398 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
399 Задаёт MIME-тип ответов по умолчанию.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
400 Соответствие расширений имён файлов MIME-типу ответов задаётся
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
401 с помощью директивы <link id="types"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
402 </para>
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
405
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
406
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
407 <directive name="directio">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
408 <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
409 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
410 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
411 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
412 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
413 <appeared-in>0.7.7</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
414
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
415 <para>
253
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 <c-def>O_DIRECT</c-def> (FreeBSD, Linux),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
418 <c-def>F_NOCACHE</c-def> (Mac OS X)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
419 или функцию <c-func>directio</c-func> (Solaris)
76
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 Директива автоматически запрещает (0.7.15) использование
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
422 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
423 для данного запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
424 Рекомендуется использовать для больших файлов:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
425 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
426 directio 4m;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
427 </example>
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
428 или при использовании <link id="aio"/> в Linux.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
429 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
430
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
431 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
432
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
433
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
434 <directive name="directio_alignment">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
435 <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
436 <default>512</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
437 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
438 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
439 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
440 <appeared-in>0.8.11</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
441
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
442 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
443 Устанавливает выравнивание для
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
444 <link id="directio"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
445 В большинстве случаев достаточно 512-байтового выравнивания, однако
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
446 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
447 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
448
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
449 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
450
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
451
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
452 <directive name="disable_symlinks">
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
453 <syntax><literal>off</literal></syntax>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
454 <syntax>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
455 <literal>on</literal> |
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
456 <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
457 [<literal>from</literal>=<value>часть</value>]</syntax>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
458 <default>off</default>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
459 <context>http</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
460 <context>server</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
461 <context>location</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
462 <appeared-in>1.1.15</appeared-in>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
463
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
464 <para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
465 Определяет, как следует поступать с символическими ссылками
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
466 при открытии файлов:
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
467 <list type="tag">
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
468
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
469 <tag-name><literal>off</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
470 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
471 Символические ссылки в пути допускаются и не проверяются.
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
472 Это стандартное поведение.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
473 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
474
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
475 <tag-name><literal>on</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
476 <tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
477 Если любой компонент пути является символической ссылкой,
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
478 доступ к файлу запрещается.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
479 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
480
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
481 <tag-name><literal>if_not_owner</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
482 <tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
483 Доступ к файлу запрещается, если любой компонент пути
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
484 является символической ссылкой, а ссылка и объект, на
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
485 который она ссылается, имеют разных владельцев.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
486 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
487
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
488 <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
489 <tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
490 При проверке символических ссылок
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
491 (параметры <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
492 обычно проверяются все компоненты пути.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
493 Можно не проверять символические ссылки в начальной части пути,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
494 указав дополнительно параметр
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
495 <literal>from</literal>=<value>часть</value>.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
496 В этом случае символические ссылки проверяются лишь начиная
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
497 с компонента пути, который следует за заданной начальной частью.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
498 Если значение не является начальной частью проверяемого пути,
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
499 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
500 Если значение целиком совпадает с именем файла,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
501 символические ссылки не проверяются.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
502 В значении параметра можно использовать переменные.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
503 </tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
504
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
505 </list>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
506 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
507
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
508 <para>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
509 Пример:
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
510 <example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
511 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
512 </example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
513 </para>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
514
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
515 <para>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
516 Эта директива доступна только на системах, в которых есть
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
517 интерфейсы <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
518 К таким системам относятся современные версии FreeBSD, Linux и Solaris.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
519 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
520
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
521 <para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
522 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
523 требуют дополнительных затрат на обработку.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
524 <note>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
525 На системах, не поддерживающих операцию открытия каталогов только для поиска,
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
526 для использования этих параметров требуется, чтобы рабочие процессы
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
527 имели право читать все проверяемые каталоги.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
528 </note>
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
529 </para>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
530
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
531 <para>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
532 <note>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
533 Модули
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
534 <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
535 <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
536 и <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
537 в настоящий момент игнорируют эту директиву.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
538 </note>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
539 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
540
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
541 </directive>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
542
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
543
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
544 <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
545 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
546 <value>код</value> ...
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
547 [<literal>=</literal>[<value>ответ</value>]]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
548 <value>uri</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
549 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
550 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
551 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
552 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
553 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
554
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
555 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
556 Задаёт URI, который будет показываться для указанных ошибок.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
557 Директивы <literal>error_page</literal> наследуются с предыдущего уровня
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
558 при условии, что на данном уровне не заданы свои директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
559 <literal>error_page</literal>.
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
560 В значении <literal>uri</literal> можно использовать переменные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
561 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
562
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
563 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
564 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
565 <example>
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
566 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
567 error_page 500 502 503 504 /50x.html;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
568 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
569 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
570
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
571 <para>
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
572 Кроме того, можно поменять код ответа на другой,
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
573 используя синтаксис вида “<literal>=</literal><value>ответ</value>”, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
574 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
575 error_page 404 =200 /empty.gif;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
576 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
577 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
578
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
579 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
580 Если ошибочный ответ обрабатывается проксированным сервером или
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
581 FastCGI/uwsgi/SCGI-сервером, и этот сервер может вернуть разные коды ответов,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
582 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
583 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
584 error_page 404 = /404.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
585 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
586 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
587
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
588 <para>
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
589 Также существует возможность использовать перенаправления для обработки
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
590 ошибок:
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
591 <example>
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
592 error_page 403 http://example.com/forbidden.html;
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
593 error_page 404 =301 http://example.com/notfound.html;
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
594 </example>
871
96839d165b8a Clarify the description of error_page example.
Sergey Kandaurov <pluknet@nginx.com>
parents: 869
diff changeset
595 В этом случае по умолчанию клиенту возвращается код ответа 302.
948
2b0731e3adc9 Slightly fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 941
diff changeset
596 Его можно изменить только на один из кодов ответа, относящихся к
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
597 перенаправлениям (301, 302, 303 и 307).
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
598 </para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
599
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
600 <para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
601 Если при внутреннем перенаправлении не нужно менять URI, то можно передать
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
602 обработку ошибки в именованный location:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
603 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
604 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
605 error_page 404 = @fallback;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
606 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
607
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
608 location @fallback {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
609 proxy_pass http://backend;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
610 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
611 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
612 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
613
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
614 <para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
615 <note>
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
616 Если при обработке <literal>uri</literal> происходит ошибка,
948
2b0731e3adc9 Slightly fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 941
diff changeset
617 клиенту возвращается ответ с кодом последней случившейся ошибки.
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
618 </note>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
619 </para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
620
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
621 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
622
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
623
576
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
624 <directive name="etag">
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
625 <syntax><literal>on</literal> | <literal>off</literal></syntax>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
626 <default>on</default>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
627 <context>http</context>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
628 <context>server</context>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
629 <context>location</context>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
630 <appeared-in>1.3.3</appeared-in>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
631
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
632 <para>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
633 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
634 заголовка ответа для статических ресурсов.
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
635 </para>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
636
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
637 </directive>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
638
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
639
651
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
640 <directive name="http">
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
641 <syntax block="yes"/>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
642 <default/>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
643 <context>main</context>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
644
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
645 <para>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
646 Предоставляет контекст конфигурационного файла, в котором указываются
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
647 директивы HTTP-сервера.
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
648 </para>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
649
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
650 </directive>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
651
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
652
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
653 <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
654 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
655 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
656 <literal>exact</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
657 <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
658 <default>exact</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
659 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
660 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
661 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
662 <appeared-in>0.7.24</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
663
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
664 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
665 Определяет, как сравнивать время модификации ответа с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
666 временем в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
667 <header>If-Modified-Since</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
668 заголовка запроса:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
669
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
670 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
671
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
672 <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
673 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
674 не проверять поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
675 <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
676 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
677
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
678 <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
679 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
680 точное совпадение;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
681 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
682
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
683 <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
684 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
685 время модификации ответа меньше или равно времени, заданному в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
686 <header>If-Modified-Since</header> заголовка запроса.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
687 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
688
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
689 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
690 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
693
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
694
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
695 <directive name="ignore_invalid_headers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
696 <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
697 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
698 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
699 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
700
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
701 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
702 Если включено, nginx игнорирует поля заголовка с недопустимыми именами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
703 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
704 и возможно знаков подчёркивания (последнее контролируется директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
705 <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
706 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
707
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
708 <para>
1023
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
709 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
710 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
711 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
712 Указанное значение распространяется на все виртуальные серверы,
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
713 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
714 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
715
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
716 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
717
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
718
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
719 <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
720 <syntax/>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
721 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
722 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
723
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
724 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
725 Указывает, что location может использоваться только для внутренних запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
726 Для внешних запросов клиенту будет возвращаться ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
727 <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
728 Внутренними запросами являются:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
729
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
730 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
731
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
732 <listitem>
429
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
733 запросы, перенаправленные директивами
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
734 <link id="error_page"/>,
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
735 <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
736 <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
737 <link id="try_files"/>;
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
738 </listitem>
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
739
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
740 <listitem>
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
741 запросы, перенаправленные с помощью поля
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
742 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
743 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
744
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
745 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
746 подзапросы, формируемые командой
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
747 “<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
748 модуля
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
749 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
750 и директивами модуля
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
751 <link doc="ngx_http_addition_module.xml">ngx_http_addition_module</link>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
752 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
753
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
754 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
755 запросы, изменённые директивой
429
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
756 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
757 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
758
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
759 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
760 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
761
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
762 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
763 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
764 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
765 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
766
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
767 location /404.html {
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
768 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
769 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
770 </example>
674
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
771 <note>
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
772 Для предотвращения зацикливания, которое может возникнуть при
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
773 использовании некорректных конфигураций, количество внутренних
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
774 перенаправлений ограничено десятью.
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
775 По достижении этого ограничения будет возвращена ошибка
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
776 <http-status code="500" text="Internal Server Error"/>.
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
777 В таком случае в лог-файле ошибок можно увидеть сообщение
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
778 “rewrite or internal redirection cycle”.
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
779 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
780 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
781
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
782 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
783
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
784
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
785 <directive name="keepalive_disable">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
786 <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
787 <default>msie6</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
788 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
789 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
790 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
791
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
792 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
793 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
794 Параметры <value>браузер</value> указывают, на какие браузеры это
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
795 распространяется.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
796 Значение <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
797 со старыми версиями MSIE после получения запроса POST.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
798 Значение <literal>safari</literal> запрещает keep-alive соединения
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
799 с Safari и подобными им браузерами на Mac OS X и подобных ей ОС.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
800 Значение <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
801 со всеми браузерами.
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
802 <note>
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
803 До версии 1.1.18 под значение <literal>safari</literal> подпадали
549
ab1449e0573b Typo fixed.
Andrey Belov <defan@nginx.com>
parents: 541
diff changeset
804 все Safari и подобные им браузеры на всех ОС, и keep-alive
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
805 соединения с ними были по умолчанию запрещены.
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
806 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
807 </para>
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 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
810
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
811
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
812 <directive name="keepalive_requests">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
813 <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
814 <default>100</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
815 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
816 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
817 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
818 <appeared-in>0.8.0</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
819
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
820 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
821 Задаёт максимальное число запросов, которые можно
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
822 сделать по одному keep-alive соединению.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
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 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
825 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
826
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
827 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
828
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
829
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
830 <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
831 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
832 <value>таймаут</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
833 [<value>заголовок_таймаута</value>]</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
834 <default>75s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
835 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
836 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
837 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
838
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
839 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
840 Первый параметр задаёт таймаут, в течение которого keep-alive
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
841 соединение с клиентом не будет закрыто со стороны сервера.
835
e0263d44a59b Http core: documented "keepalive_timeout 0".
Ruslan Ermilov <ru@nginx.com>
parents: 826
diff changeset
842 Значение 0 запрещает keep-alive соединения с клиентами.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
843 Второй необязательный параметр задаёт значение в поле
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
844 <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
845 заголовка ответа.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
846 Два параметра могут отличаться друг от друга.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
847 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
848
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
849 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
850 Поле
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
851 <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
852 заголовка понимают Mozilla и Konqueror.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
853 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
854 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
855
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
856 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
857
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
858
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
859 <directive name="large_client_header_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
860 <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
861 <default>4 8k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
862 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
863 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
864
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
865 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
866 Задаёт максимальное <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
867 буферов для чтения большого заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
868 Строка запроса не должна превышать размера одного буфера, иначе клиенту
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
869 возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
870 <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
871 Поле заголовка запроса также не должно превышать размера одного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
872 иначе клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
873 <http-status code="400" text="Bad Request"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
874 Буферы выделяются только по мере необходимости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
875 По умолчанию размер одного буфера равен 8K байт.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
876 Если по окончании обработки запроса соединение переходит в состояние
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
877 keep-alive, эти буферы освобождаются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
878 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
879
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
880 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
883 <directive name="limit_except">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
884 <syntax block="yes"><value>метод</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
885 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
886 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
887
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
888 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
889 Ограничивает HTTP-методы, доступные внутри location.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
890 Параметр <value>метод</value> может быть одним из
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
891 <literal>GET</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
892 <literal>HEAD</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
893 <literal>POST</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
894 <literal>PUT</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
895 <literal>DELETE</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
896 <literal>MKCOL</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
897 <literal>COPY</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
898 <literal>MOVE</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
899 <literal>OPTIONS</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
900 <literal>PROPFIND</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
901 <literal>PROPPATCH</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
902 <literal>LOCK</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
903 <literal>UNLOCK</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
904 или
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
905 <literal>PATCH</literal>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
906 Если разрешён метод <literal>GET</literal>, то метод
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
907 <literal>HEAD</literal> также будет разрешён.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
908 Доступ к остальным методам может быть ограничен при помощи директив модулей
79
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
909 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
910 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
911 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
912 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
913 limit_except GET {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
914 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
915 deny all;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
916 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
917 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
918 Обратите внимание, что данное ограничение действует для всех методов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
919 <emphasis>кроме</emphasis> GET и HEAD.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
920 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
921
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
922 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
923
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
924
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
925 <directive name="limit_rate">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
926 <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
927 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
928 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
929 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
930 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
931 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
932
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
933 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
934 Ограничивает скорость передачи ответа клиенту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
935 Скорость задаётся в байтах в секунду.
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
936 Значение 0 отключает ограничение скорости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
937 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
938 Чем меньше скорость, тем более аккуратным будет ограничение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
939 -->
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
940 Ограничение устанавливается на запрос, поэтому, если клиент одновременно
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
941 откроет два соединения, суммарная скорость будет вдвое выше
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
942 заданного ограничения.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
943 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
944
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
945 <para>
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
946 Ограничение скорости можно также задать в переменной <var>$limit_rate</var>.
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
947 Это может быть полезно в случаях, когда скорость нужно ограничивать
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
948 в зависимости от какого-либо условия:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
949 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
950 server {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
951
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
952 if ($slow) {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
953 set $limit_rate 4k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
954 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
955
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
956 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
957 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
958 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
959 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
960
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 503
diff changeset
961 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 503
diff changeset
962 Кроме того, ограничение скорости может быть задано в поле
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
963 <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
964 Эту возможность можно запретить с помощью директив
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
965 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>,
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
966 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
967 <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
968 и
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
969 <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
970 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 503
diff changeset
971
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
972 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
973
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
974
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
975 <directive name="limit_rate_after">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
976 <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
977 <default>0</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>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
981 <context>if в location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
982 <appeared-in>0.8.0</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
983
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
984 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
985 Задаёт начальный объём данных, после передачи которого начинает
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
986 ограничиваться скорость передачи ответа клиенту.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
987 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
988
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
989 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
990 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
991 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
992 location /flv/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
993 flv;
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
994 limit_rate_after 500k;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
995 limit_rate 50k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
996 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
997 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
998 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
999
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1000 </directive>
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
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1003 <directive name="lingering_close">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1004 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1005 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1006 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1007 <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
1008 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1009 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1010 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1011 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1012 <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
1013 <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
1014
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1015 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1016 Управляет закрытием соединений с клиентами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1017 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1018
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1019 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1020 Со значением по умолчанию “<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
1021 <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
1022 <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
1023 поступающие от клиента, перед полным закрытием соединения, но только
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1024 если эвристика указывает на то, что клиент может ещё послать данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1025 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1026
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1027 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1028 Со значением “<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
1029 ждать и обрабатывать дополнительные данные, поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1030 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1031
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1032 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1033 Со значением “<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
1034 дополнительных данных и сразу же закроет соединение.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1035 Это поведение нарушает протокол и поэтому не должно использоваться без
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1036 необходимости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1037 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1038
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1039 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1040
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1041
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1042 <directive name="lingering_time">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1043 <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
1044 <default>30s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1045 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1046 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1047 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1048
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1049 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1050 Если действует <link id="lingering_close"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1051 эта директива задаёт максимальное время, в течение которого nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1052 будет обрабатывать (читать и игнорировать) дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1053 поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1054 По прошествии этого времени соединение будет закрыто, даже если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1055 будут ещё данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1056 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1057
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1058 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1059
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1060
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1061 <directive name="lingering_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1062 <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
1063 <default>5s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1064 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1065 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1066 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1067
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1068 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1069 Если действует <link id="lingering_close"/>, эта директива задаёт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1070 максимальное время ожидания поступления дополнительных данных от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1071 Если в течение этого времени данные не были получены, соединение закрывается.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1072 В противном случае данные читаются и игнорируются, и nginx снова
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1073 ждёт поступления данных.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1074 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1075 директивой <link id="lingering_time"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1076 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1077
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1078 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1079
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1080
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1081 <directive name="listen">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1082 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1083 <value>адрес</value>[:<value>порт</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1084 [<literal>default_server</literal>]
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1085 [<literal>ssl</literal>]
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1086 [<literal>spdy</literal>]
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1087 [<literal>proxy_protocol</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1088 [<literal>setfib</literal>=<value>число</value>]
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1089 [<literal>fastopen</literal>=<value>число</value>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1090 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1091 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1092 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1093 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1094 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1095 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1096 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1097 [<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
1098 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1099 <value>порт</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1100 [<literal>default_server</literal>]
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1101 [<literal>ssl</literal>]
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1102 [<literal>spdy</literal>]
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1103 [<literal>proxy_protocol</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1104 [<literal>setfib</literal>=<value>число</value>]
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1105 [<literal>fastopen</literal>=<value>число</value>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1106 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1107 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1108 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1109 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1110 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1111 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1112 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1113 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1114 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1115 <literal>unix:</literal><value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1116 [<literal>default_server</literal>]
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1117 [<literal>ssl</literal>]
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1118 [<literal>spdy</literal>]
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1119 [<literal>proxy_protocol</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1120 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1121 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1122 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1123 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1124 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1125 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1126 [<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
1127 <default>*:80 | *:8000</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1128 <context>server</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1129
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1130 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1131 Задаёт <value>адрес</value> и <value>порт</value> для IP
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1132 или <value>путь</value> для UNIX-сокета,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1133 на которых сервер будет принимать запросы.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1134 Можно указать <value>адрес</value> и <value>порт</value>,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1135 либо только <value>адрес</value> или только <value>порт</value>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1136 Кроме того, <value>адрес</value> может быть именем хоста, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1137 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1138 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
1139 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
1140 listen 8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1141 listen *:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1142 listen localhost:8000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1143 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1144 IPv6-адреса (0.7.36) задаются в квадратных скобках:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1145 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1146 listen [::]:8000;
941
7d1d53d4d293 Removed link-scoped IPv6 addresses from examples.
Ruslan Ermilov <ru@nginx.com>
parents: 940
diff changeset
1147 listen [::1];
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1148 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1149 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
1150 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1151 listen unix:/var/run/nginx.sock;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1152 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1153 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1154
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1155 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1156 Если указан только <value>адрес</value>, то используется порт 80.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1157 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1158
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1159 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1160 Если директива не указана, то используется либо <literal>*:80</literal>,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1161 если nginx работает с привилегиями суперпользователя,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1162 либо <literal>*:8000</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1163 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1164
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1165 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1166 Если у директивы есть параметр <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
1167 в котором описана эта директива, будет сервером по умолчанию для указанной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1168 <value>адрес</value>:<value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1169 Если же директив с параметром <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
1170 сервером по умолчанию будет первый сервер, в котором описана пара
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1171 <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
1172 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1173 До версии 0.8.21 этот параметр назывался просто
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1174 <literal>default</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1175 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1176 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1177
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1178 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1179 Параметр <literal>ssl</literal> (0.7.14) указывает на то, что все соединения,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1180 принимаемые на данном порту, должны работать в режиме SSL.
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1181 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1182 id="single_http_https_server">конфигурацию</link> для сервера,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1183 работающего сразу в двух режимах — HTTP и HTTPS.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1184 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1185
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1186 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1187 Параметр <literal>spdy</literal> (1.3.15) позволяет принимать на этом порту
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1188 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1189 Обычно, чтобы это работало, следует также указать параметр
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1190 <literal>ssl</literal>, однако nginx можно также настроить и на приём
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1191 SPDY-соединений без SSL.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1192 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1193
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1194 <para>
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1195 Параметр <literal>proxy_protocol</literal> (1.5.12)
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1196 указывает на то, что все соединения, принимаемые на данном порту,
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1197 должны использовать
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1198 <link url="http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt">протокол
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1199 PROXY</link>.
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1200 </para>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1201
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1202 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1203 В директиве <literal>listen</literal> можно также указать несколько
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1204 дополнительных параметров, специфичных для связанных с сокетами
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1205 системных вызовов.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1206 Эти параметры можно задать в любой директиве <literal>listen</literal>,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1207 но только один раз для указанной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1208 <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
1209 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1210 До версии 0.8.21 их можно было указывать лишь в директиве
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1211 <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
1212 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1213 <list type="tag">
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 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1216 <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
1217 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1218 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1219 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1220 (параметр <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
1221 В настоящий момент это работает только на FreeBSD.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1222 </tag-desc>
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 <tag-name>
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1225 <literal>fastopen</literal>=<value>число</value>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1226 </tag-name>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1227 <tag-desc>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1228 включает
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1229 “<link url="http://en.wikipedia.org/wiki/TCP_Fast_Open">TCP Fast Open</link>”
1037
3fde5aa256ac Fixed markup.
Vladimir Homutov <vl@nginx.com>
parents: 1036
diff changeset
1230 для слушающего сокета (1.5.8) и
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1231 <link url="http://tools.ietf.org/html/draft-ietf-tcpm-fastopen#section-5.1">ограничивает</link>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1232 максимальную длину очереди соединений, которые ещё не завершили процесс
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1233 three-way handshake.
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1234 <note>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1235 Не включайте “TCP Fast Open”, не убедившись, что сервер может адекватно
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1236 обрабатывать многократное получение
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1237 <link url="http://tools.ietf.org/html/draft-ietf-tcpm-fastopen#section-6.1">
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1238 одного и того же SYN-пакета с данными</link>.
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1239 </note>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1240 </tag-desc>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1241
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1242 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1243 <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
1244 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1245 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1246 задаёт параметр <literal>backlog</literal> в вызове
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1247 <c-func>listen</c-func>, который ограничивает
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1248 максимальный размер очереди ожидающих приёма соединений.
741
082a725038db Fixed default backlog value description for Mac OS X
Sergey Budnevitch <sb@waeme.net>
parents: 738
diff changeset
1249 По умолчанию <literal>backlog</literal> устанавливается равным -1 для
082a725038db Fixed default backlog value description for Mac OS X
Sergey Budnevitch <sb@waeme.net>
parents: 738
diff changeset
1250 FreeBSD и Mac OS X, и 511 для других платформ.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1251 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1252
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1253 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1254 <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
1255 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1256 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1257 задаёт размер буфера приёма
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1258 (параметр <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
1259 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1260
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1261 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1262 <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
1263 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1264 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1265 задаёт размер буфера передачи
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1266 (параметр <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
1267 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1268
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1269 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1270 <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
1271 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1272 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1273 задаёт название accept-фильтра
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1274 (параметр <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
1275 который включается для фильтрации входящих соединений
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1276 перед передачей их в <c-func>accept</c-func>.
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1277 Работает только на FreeBSD и NetBSD 5.0+.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1278 Можно использовать два фильтра:
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1279 <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
1280 и
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1281 <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
1282 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1283
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1284 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1285 <literal>deferred</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1286 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1287 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1288 указывает использовать отложенный <c-func>accept</c-func>
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1289 (параметр <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
1290 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1291
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1292 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1293 <literal>bind</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1294 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1295 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1296 указывает, что для данной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1297 <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
1298 <c-func>bind</c-func> отдельно.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1299 Это нужно потому, что если описаны несколько директив <literal>listen</literal>
629
7e4805858796 Fixed punctuation.
Ruslan Ermilov <ru@nginx.com>
parents: 625
diff changeset
1300 с одинаковым портом, но разными адресами, и одна из директив
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1301 <literal>listen</literal> слушает на всех адресах для данного порта
629
7e4805858796 Fixed punctuation.
Ruslan Ermilov <ru@nginx.com>
parents: 625
diff changeset
1302 (<literal>*:</literal><value>порт</value>), то nginx сделает
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1303 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1304 Необходимо заметить, что в этом случае для определения адреса, на которой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1305 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
1035
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1306 Если же используются параметры <literal>setfib</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1307 <literal>backlog</literal>, <literal>rcvbuf</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1308 <literal>sndbuf</literal>, <literal>accept_filter</literal>,
1279
7261e621dd4a Documented that "listen ipv6only=" implies "bind".
Maxim Dounin <mdounin@mdounin.ru>
parents: 1257
diff changeset
1309 <literal>deferred</literal>, <literal>ipv6only</literal>
7261e621dd4a Documented that "listen ipv6only=" implies "bind".
Maxim Dounin <mdounin@mdounin.ru>
parents: 1257
diff changeset
1310 или <literal>so_keepalive</literal>,
1035
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1311 то для данной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1312 <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
1313 отдельный вызов <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
1314 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1315
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1316 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1317 <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
1318 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1319 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1320 этот параметр (0.7.42) определяет
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1321 (через параметр сокета <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
1322 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1323 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения.
615
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1324 По умолчанию параметр включён.
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1325 Установить его можно только один раз на старте.
615
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1326 <note>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1327 До версии 1.3.4,
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1328 если этот параметр не был задан явно, то для сокета действовали
615
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1329 настройки операционной системы.
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1330 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1331 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1332
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1333 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1334 <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
1335 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1336 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1337 этот параметр (1.1.11) конфигурирует для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1338 поведение “TCP keepalive”.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1339 Если этот параметр опущен, то для сокета будут действовать
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1340 настройки операционной системы.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1341 Если он установлен в значение “<literal>on</literal>”, то для сокета
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1342 включается параметр <c-def>SO_KEEPALIVE</c-def>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1343 Если он установлен в значение “<literal>off</literal>”, то для сокета
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1344 параметр <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
1345 Некоторые операционные системы поддерживают настройку параметров
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1346 “TCP keepalive” на уровне сокета посредством параметров
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1347 <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
1348 <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
1349 На таких системах (в настоящий момент это 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
1350 FreeBSD 9.0-STABLE)
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1351 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1352 <value>keepintvl</value> и <value>keepcnt</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1353 Один или два параметра могут быть опущены, в таком случае для
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1354 соответствующего параметра сокета будут действовать стандартные
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1355 системные настройки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1356 Например,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1357 <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
1358 установит таймаут бездействия (<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
1359 для интервала проб (<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
1360 стандартная системная настройка, а счётчик проб (<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
1361 будет равен 10.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1362 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1363
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1364 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1365 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1366
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1367 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1368 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1369 <example>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1370 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
1371 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1372 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1373
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1374 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1375
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1376
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1377 <directive name="location">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1378 <syntax block="yes">[
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1379 <literal>=</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1380 <literal>~</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1381 <literal>~*</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1382 <literal>^~</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1383 ] <value>uri</value></syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1384 <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
1385 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1386 <context>server</context>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1387 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1388
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1389 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1390 Устанавливает конфигурацию в зависимости от URI запроса.
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1391 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1392
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1393 <para>
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1394 Для сопоставления используется URI запроса в нормализованном виде,
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1395 после декодирования текста, заданного в виде “<literal>%XX</literal>”,
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1396 преобразования относительных элементов пути “<literal>.</literal>” и
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1397 “<literal>..</literal>” в реальные и возможной
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1398 <link id="merge_slashes">замены</link> двух и более подряд идущих
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1399 слэшей на один.
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1400 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1401
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1402 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1403 location можно задать префиксной строкой или регулярным выражением.
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1404 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1405 (для поиска совпадения без учёта регистра символов),
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1406 либо с модификатором “<literal>~</literal>” (с учётом регистра).
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1407 Чтобы найти location, соответствующий запросу, вначале проверяются
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1408 location’ы, заданные префиксными строками (префиксные location’ы).
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1409 Среди них ищется location с совпадающим префиксом
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1410 максимальной длины и запоминается.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1411 Затем проверяются регулярные выражения, в порядке их следования
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1412 в конфигурационном файле.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1413 Проверка регулярных выражений прекращается после первого же совпадения,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1414 и используется соответствующая конфигурация.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1415 Если совпадение с регулярным выражением не найдено, то используется
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1416 конфигурация запомненного ранее префиксного location’а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1417 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1418
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1419 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1420 Блоки <literal>location</literal> могут быть вложенными,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1421 с некоторыми исключениями, о которых говорится ниже.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1422 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1423
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1424 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1425 Для операционных систем, нечувствительных к регистру символов, таких
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1426 как Mac OS X и Cygwin, сравнение с префиксными строками производится
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1427 без учёта регистра (0.7.7).
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1428 Однако сравнение ограничено только однобайтными locale’ями.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1429 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1430
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1431 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1432 Регулярные выражения могут содержать выделения (0.7.40), которые могут
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1433 затем использоваться в других директивах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1434 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1435
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1436 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1437 Если у совпавшего префиксного location’а максимальной длины указан модификатор
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1438 “<literal>^~</literal>”, то регулярные выражения не проверяются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1439 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1440
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1441 <para>
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1442 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1443 совпадение URI и location.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1444 При точном совпадении поиск сразу же прекращается.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1445 Например, если запрос “<literal>/</literal>” случается часто, то
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1446 указав “<literal>location = /</literal>”, можно ускорить обработку
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1447 этих запросов, так как поиск прекратится после первого же сравнения.
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1448 Очевидно, что такой location не может иметь вложенные location’ы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1449 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1450
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1451 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1452 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1453 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1454 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
1455 то поиск тоже сразу же прекращается и регулярные выражения также
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1456 не проверяются.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1457 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1458 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1459
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1460 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1461 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1462 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1463 location = / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1464 [ конфигурация А ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1465 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1466
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1467 location / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1468 [ конфигурация Б ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1469 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1470
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1471 location /documents/ {
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1472 [ конфигурация В ]
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1473 }
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1474
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1475 location ^~ /images/ {
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1476 [ конфигурация Г ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1477 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1478
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1479 location ~* \.(gif|jpg|jpeg)$ {
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1480 [ конфигурация Д ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1481 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1482 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1483 Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1484 для запроса “<literal>/index.html</literal>” — конфигурация Б,
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1485 для запроса “<literal>/documents/document.html</literal>” — конфигурация В,
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1486 для запроса “<literal>/images/1.gif</literal>” — конфигурация Г,
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1487 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Д.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1488 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1489
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1490 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1491 Префикс “<literal>@</literal>” задаёт именованный location.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1492 Такой location не используется при обычной обработке запросов, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1493 предназначен только для перенаправления в него запросов.
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1494 Такие location’ы не могут быть вложенными и не могут содержать
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1495 вложенные location’ы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1496 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1497
914
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1498 <para>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1499 Если location задан префиксной строкой со слэшом в конце
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1500 и запросы обрабатываются при помощи
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1501 <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
1502 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
1503 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
1504 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/> или
914
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1505 <link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>,
1257
ac7a5ee98768 Split long sentence into two.
Ruslan Ermilov <ru@nginx.com>
parents: 1194
diff changeset
1506 происходит специальная обработка.
ac7a5ee98768 Split long sentence into two.
Ruslan Ermilov <ru@nginx.com>
parents: 1194
diff changeset
1507 В ответ на запрос с URI равным этой строке, но без завершающего слэша,
914
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1508 будет возвращено постоянное перенаправление с кодом 301
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1509 на URI с добавленным в конец слэшом.
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1510 Если такое поведение нежелательно, можно задать точное совпадение
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1511 URI и location, например:
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1512 <example>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1513 location /user/ {
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1514 proxy_pass http://user.example.com;
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1515 }
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1516
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1517 location = /user {
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1518 proxy_pass http://login.example.com;
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1519 }
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1520 </example>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1521 </para>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1522
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1523 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1524 <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
1525 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1526
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1527 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1528
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1529
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1530 <directive name="log_not_found">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1531 <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
1532 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1533 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1534 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1535 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1536
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1537 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1538 Разрешает или запрещает записывать в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1539 <link doc="../ngx_core_module.xml" id="error_log"/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1540 ошибки о том, что файл не найден.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1541 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1542
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1543 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1544
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1545
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1546 <directive name="log_subrequest">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1547 <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
1548 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1549 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1550 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1551 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1552
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1553 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1554 Разрешает или запрещает записывать в
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
1555 <link doc="ngx_http_log_module.xml" id="access_log"/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1556 подзапросы.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1557 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1558
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1559 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1560
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1561
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1562 <directive name="max_ranges">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1563 <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
1564 <default/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1565 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1566 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1567 <context>location</context>
499
76a8eca844d0 Documented that "max_ranges" appeared in 1.1.2.
Ruslan Ermilov <ru@nginx.com>
parents: 477
diff changeset
1568 <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
1569
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1570 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1571 Ограничивает максимальное допустимое число диапазонов в запросах с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1572 указанием диапазона запрашиваемых байт (byte-range requests).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1573 Запросы, превышающие указанное ограничение, обрабатываются как
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1574 если бы они не содержали указания диапазонов.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1575 По умолчанию число диапазонов не ограничено.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1576 Значение 0 полностью запрещает поддержку диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1577 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1578
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1579 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1580
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1581
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1582 <directive name="merge_slashes">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1583 <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
1584 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1585 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1586 <context>server</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 идущих слэшей (“<literal>/</literal>”) на один.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1591 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1592
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1593 <para>
280
cbb789d3ce5e Fixed grammar error.
Ruslan Ermilov <ru@nginx.com>
parents: 274
diff changeset
1594 Необходимо иметь в виду, что это преобразование необходимо для корректной
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1595 проверки префиксных строк и регулярных выражений.
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1596 Если его не делать, то запрос “<literal>//scripts/one.php</literal>”
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1597 не попадёт в
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1598 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1599 location /scripts/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1600 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1601 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1602 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1603 и может быть обслужен как статический файл.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1604 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1605 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1606
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1607 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1608 Запрет преобразования может понадобиться, если в URI используются имена,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1609 закодированные методом base64, в котором задействован символ
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1610 “<literal>/</literal>”.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1611 Однако из соображений безопасности лучше избегать отключения преобразования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1612 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1613
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1614 <para>
1023
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1615 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1616 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1617 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1618 Указанное значение распространяется на все виртуальные серверы,
442
b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents: 438
diff changeset
1619 слушающие на том же адресе и порту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1620 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1621
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1622 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1623
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1624
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1625 <directive name="msie_padding">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1626 <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
1627 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1628 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1629 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1630 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1631
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1632 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1633 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1634 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1635 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1636
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1637 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1638
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1639
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1640 <directive name="msie_refresh">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1641 <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
1642 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1643 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1644 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1645 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1646
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1647 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1648 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1649 перенаправлений.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1650 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1651
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1652 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1653
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1654
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1655 <directive name="open_file_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1656 <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
1657 <syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1658 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1659 [<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
1660 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1661 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1662 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1663 <context>location</context>
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1666 Задаёт кэш, в котором могут храниться:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1667 <list type="bullet">
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 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1670 дескрипторы открытых файлов, информация об их размерах и времени модификации;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1671 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1672
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1673 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1674 информация о существовании каталогов;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1675 </listitem>
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 <listitem>
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1678 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1679 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1680 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1681 Кэширование ошибок нужно разрешить отдельно директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1682 <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
1683 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1684 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1685
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1686 </list>
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>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1690 У директивы есть следующие параметры:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1691 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1692
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1693 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1694 <literal>max</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1695 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1696 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1697 задаёт максимальное число элементов в кэше;
507
d00a4f9b1c5d Better translation of "LRU".
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
1698 при переполнении кэша удаляются наименее востребованные элементы (LRU);
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1699 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1700
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1701 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1702 <literal>inactive</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1703 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1704 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1705 задаёт время, после которого элемент кэша удаляется, если к нему
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1706 не было обращений в течение этого времени; по умолчанию 60 секунд;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1707 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1708
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1709 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1710 <literal>off</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1711 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1712 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1713 запрещает кэш.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1714 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1715
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1716 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1717 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1718
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1719 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1720 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1721 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1722 open_file_cache max=1000 inactive=20s;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1723 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1724 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1725 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
1726 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1727 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
1728 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1729 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1730 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1731
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1732 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1733
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1734
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1735 <directive name="open_file_cache_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1736 <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
1737 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1738 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1739 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1740 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1741
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1742 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1743 Разрешает или запрещает кэширование ошибок поиска файлов в
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1744 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1745 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1746
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1747 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1748
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1749
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1750 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1751
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1752 <directive name="open_file_cache_events">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1753 <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
1754 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1755 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1756 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1757 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1758
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1759 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1760 Разрешает использование событий ядра для проверки актуальности элементов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1761 <link id="open_file_cache"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1762 Эта директива работает только совместно с методом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1763 <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
1764 Заметьте, что только NetBSD&nbsp;2.0+ и FreeBSD&nbsp;6.0+
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1765 поддерживают события для файловых систем произвольного типа.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1766 Другие операционные системы поддерживают события только для
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1767 основных файловых систем, таких как UFS или FFS.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1768 </para>
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 </directive>
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 -->
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1775 <directive name="open_file_cache_min_uses">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1776 <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
1777 <default>1</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1778 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1779 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1780 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1781
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1782 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1783 Задаёт минимальное <value>число</value> обращений к файлу
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1784 в течение времени, заданного параметром <literal>inactive</literal>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1785 директивы <link id="open_file_cache"/>, необходимых для того, чтобы дескриптор
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1786 файла оставался открытым в кэше.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1787 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1788
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1789 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1790
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1791
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1792 <directive name="open_file_cache_valid">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1793 <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
1794 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1795 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1796 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1797 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1798
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1799 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1800 Определяет время, через которое следует проверять актуальность информации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1801 об элементе в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1802 <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
1803 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1804 При включенном
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1805 <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
1806 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1807 по факту их изменения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1808 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1809 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1810
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1811 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1812
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 <directive name="optimize_server_names">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1815 <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
1816 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1817 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1818 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1819
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1820 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1821 Директива устарела.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1822 Вместо неё следует использовать директиву <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
1823 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1824
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1825 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1826 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1827 Разрешает или запрещает оптимизировать проверку имени хоста в name-based
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1828 виртуальных серверах.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1829 Проверка в частности влияет на имя хоста, используемого в перенаправлениях.
381
8ad9df891e23 Fixed grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
1830 Если оптимизация разрешена и все name-based серверы, слушающие на одной
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1831 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1832 имена не проверяются и в перенаправлениях используется первое имя сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1833 Если в перенаправлении нужно использовать имя хоста, переданное клиентом,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1834 то оптимизацию нужно выключить.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1835 </para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1836 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1837
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1838 </directive>
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
1024
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1841 <directive name="output_buffers">
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1842 <syntax><value>number</value> <value>size</value></syntax>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1843 <default>1 32k</default>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1844 <context>http</context>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1845 <context>server</context>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1846 <context>location</context>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1847
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1848 <para>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1849 Задаёт <value>число</value> и <value>размер</value> буферов,
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1850 используемых при чтении ответа с диска.
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1851 </para>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1852
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1853 </directive>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1854
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1855
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1856 <directive name="port_in_redirect">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1857 <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
1858 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1859 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1860 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1861 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1862
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1863 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1864 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx’ом.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1865 </para>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1866
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1867 <para>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
1868 Использование в перенаправлениях основного имени сервера управляется
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
1869 директивой <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
1870 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1871
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1872 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1873
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1874
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1875 <directive name="postpone_output">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1876 <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
1877 <default>1460</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1878 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1879 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1880 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1881
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1882 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1883 Если это возможно, то отправка данных клиенту будет отложена пока nginx не
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1884 накопит по крайней мере указанное количество байт для отправки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1885 Значение 0 запрещает отложенную отправку данных.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1886 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1887
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1888 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1889
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1890
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1891 <directive name="read_ahead">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1892 <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
1893 <default>0</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1894 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1895 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1896 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1897
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1898 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1899 Задаёт ядру размер предчтения при работе с файлами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1900 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1901
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1902 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1903 На Linux используется системный вызов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1904 <literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1905 поэтому параметр <value>размер</value> там игнорируется.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1906 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1907
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1908 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1909 На FreeBSD используется системный вызов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1910 <literal>fcntl(O_READAHEAD,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1911 </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
1912 появившийся во FreeBSD&nbsp;9.0-CURRENT.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1913 Для FreeBSD&nbsp;7 необходимо установить
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1914 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1915 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1916
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1917 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1920 <directive name="recursive_error_pages">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1921 <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
1922 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1923 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1924 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1925 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1926
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1927 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1928 Разрешает или запрещает делать несколько перенаправлений через директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1929 <link id="error_page"/>.
709
a4648185190a Fixed the link internal to the module.
Ruslan Ermilov <ru@nginx.com>
parents: 679
diff changeset
1930 Число таких перенаправлений <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
1931 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1932
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1933 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1934
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1935
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1936 <directive name="request_pool_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1937 <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
1938 <default>4k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1939 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1940 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1941
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1942 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1943 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1944 под конкретные запросы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1945 Эта директива не оказывает существенного влияния на
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1946 производительность, и её не следует использовать.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1947 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1950
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1951
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1952 <directive name="reset_timedout_connection">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1953 <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
1954 <default>off</default>
253
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 Разрешает или запрещает сброс соединений по таймауту.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1961 Сброс делается следующим образом.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1962 Перед закрытием сокета для него задаётся параметр
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1963 <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
1964 с таймаутом 0.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1965 После этого при закрытии сокета клиенту отсылается TCP RST, а вся память,
253
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 Это позволяет избежать длительного нахождения уже закрытого сокета в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1968 состоянии FIN_WAIT1 с заполненными буферами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1969 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1970
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1971 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1972 Необходимо отметить, что keep-alive соединения по истечении таймаута
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1973 закрываются обычным образом.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1974 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1975
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1976 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1977
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1978
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1979 <directive name="resolver">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1980 <syntax>
1031
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
1981 <value>адрес</value> ...
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
1982 [<literal>valid</literal>=<value>время</value>]
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
1983 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
1984 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1985 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1986 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1987 <context>location</context>
76
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 <para>
318
4a0fe9283dc7 Word polishing in the description of the "server" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 280
diff changeset
1990 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1991 в адреса, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1992 <example>
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
1993 resolver 127.0.0.1 [::1]:5353;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1994 </example>
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
1995 Адрес может быть указан в виде доменного имени или IP-адреса,
566
f8148fc88224 Documented 1.2.2 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 549
diff changeset
1996 и необязательного порта (1.3.1, 1.2.2).
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
1997 Если порт не указан, используется порт 53.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1998 Серверы DNS опрашиваются циклически.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1999 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2000 До версии 1.1.7 можно было задать лишь один DNS-сервер.
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2001 Задание DNS-серверов с помощью IPv6-адресов поддерживается
566
f8148fc88224 Documented 1.2.2 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 549
diff changeset
2002 начиная с версий 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
2003 </note>
1031
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2004 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2005 при преобразовании имён в адреса.
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2006 Если поиск IPv6-адресов нежелателен,
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2007 можно указать параметр <literal>ipv6=off</literal>.
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2008 <note>
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2009 Преобразование имён в IPv6-адреса поддерживается
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2010 начиная с версии 1.5.8.
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2011 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2012 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2013 Необязательный параметр <literal>valid</literal> позволяет это
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2014 переопределить:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2015 <example>
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2016 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
2017 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2018 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2019 До версии 1.1.9 настройка времени кэширования была невозможна
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2020 и nginx всегда кэшировал ответы на срок в 5 минут.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2021 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2022 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2023
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2024 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2025
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2026
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2027 <directive name="resolver_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2028 <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
2029 <default>30s</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2030 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2031 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2032 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2033
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2034 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2035 Задаёт таймаут для преобразования имени в адрес, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2036 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2037 resolver_timeout 5s;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2038 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2039 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2040
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2041 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2042
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2043
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2044 <directive name="root">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2045 <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
2046 <default>html</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2047 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2048 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2049 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2050 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2051
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2052 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2053 Задаёт корневой каталог для запросов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2054 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2055 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2056 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2057 root /data/w3;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2058 }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2059 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2060 в ответ на запрос “<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
2061 <path>/data/w3/i/top.gif</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2062 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2063
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2064 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2065 В значении параметра <value>путь</value> можно использовать переменные,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2066 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2067 </para>
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2070 Путь к файлу формируется путём простого добавления URI к значению директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2071 <literal>root</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2072 Если же URI необходимо поменять, следует воспользоваться директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2073 <link id="alias"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2074 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2077
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2078
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2079 <directive name="satisfy">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2080 <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
2081 <default>all</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2082 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2083 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2084 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2085
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2086 <para>
971
6316a7579448 Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents: 966
diff changeset
2087 Разрешает доступ, если все (<literal>all</literal>)
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2088 или хотя бы один (<literal>any</literal>) из модулей
971
6316a7579448 Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents: 966
diff changeset
2089 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>,
6316a7579448 Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents: 966
diff changeset
2090 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> или
6316a7579448 Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents: 966
diff changeset
2091 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2092 разрешают доступ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2093 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2094
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2095 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2096 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2097 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2098 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2099 satisfy any;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2100
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2101 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
2102 deny all;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2103
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2104 auth_basic "closed site";
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2105 auth_basic_user_file conf/htpasswd;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2106 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2107 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2108 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2109
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2110 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2111
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2112
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2113 <directive name="satisfy_any">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2114 <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
2115 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2116 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2117 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2118 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2119
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2120 <para>
406
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
2121 Эта директива была заменена параметром <literal>any</literal>
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
2122 директивы <link id="satisfy"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2123 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2124
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2125 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2126
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2127
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2128 <directive name="send_lowat">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2129 <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
2130 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2131 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2132 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2133 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2134
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2135 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2136 При установке этой директивы в ненулевое значение nginx будет пытаться
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2137 минимизировать число операций отправки на клиентских сокетах либо при
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2138 помощи флага <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
2139 <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
2140 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2141 В обоих случаях будет использован указанный <value>размер</value>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2142 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2143
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2144 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2145 Эта директива игнорируется на Linux, Solaris и Windows.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2146 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2147
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2148 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2149
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2150
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2151 <directive name="send_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2152 <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
2153 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2154 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2155 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2156 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2157
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2158 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2159 Задаёт таймаут при передаче ответа клиенту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2160 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2161 а только между двумя операциями записями.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2162 Если по истечении этого времени клиент ничего не примет,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2163 соединение будет закрыто.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2164 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2165
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2166 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2167
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2168
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2169 <directive name="sendfile">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2170
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2171 <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
2172 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2173 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2174 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2175 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2176 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2177
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2178 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2179 Разрешает или запрещает использовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2180 <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
2181 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2182
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2183 <para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2184 Начиная с nginx&nbsp;0.8.12 и FreeBSD&nbsp;5.2.1,
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2185 можно использовать <link id="aio"/> для подгрузки данных
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2186 для <c-func>sendfile</c-func>:
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2187 <example>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2188 location /video/ {
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2189 sendfile on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2190 tcp_nopush on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2191 aio on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2192 }
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2193 </example>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2194 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2195 <c-def>SF_NODISKIO</c-def>, в результате чего она не блокируется на диске, а
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2196 сообщает об отсутствии данных в памяти.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2197 После этого nginx инициирует асинхронную подгрузку данных, читая один байт.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2198 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2199 при последующих чтениях файл подгружается частями только по 16K.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2200 Изменить это можно с помощью директивы
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2201 <link id="read_ahead"/>.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2202 <note>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2203 До версии 1.7.11 подгрузка данных включалась с помощью
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2204 <literal>aio sendfile;</literal>.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2205 </note>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2206 </para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2207
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2208 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2209
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2210
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2211 <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
2212
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2213 <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
2214 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2215 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2216 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2217 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2218
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2219 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2220 При установке в ненулевое значение ограничивает объём данных,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2221 который может передан за один вызов <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
2222 Без этого ограничения одно быстрое соединение может целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2223 захватить рабочий процесс.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2224 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2225
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2226 </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="server">
108
72524ae53106 Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
2230 <syntax block="yes"/>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
2231 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2232 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2233
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2234 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2235 Задаёт конфигурацию для виртуального сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2236 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2237 и 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
2238 Вместо этого директивами <link id="listen"/> описываются все
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2239 адреса и порты, на которых нужно принимать соединения для этого сервера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2240 а в директиве <link id="server_name"/> указываются все имена серверов.
522
ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
2241 Примеры конфигураций описаны в документе
ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
2242 “<link doc="request_processing.xml"/>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2243 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2244
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2245 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2246
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2247
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2248 <directive name="server_name">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2249 <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
2250 <default>""</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2251 <context>server</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2252
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2253 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2254 Задаёт имена виртуального сервера, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2255 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2256 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2257 server_name example.com www.example.com;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2258 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2259 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2260 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2261
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2262 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2263 Первое имя становится основным именем сервера.
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2264 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2265
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2266 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2267 В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2268 для замены первой или последней части имени:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2269 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2270 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2271 server_name example.com *.example.com www.example.*;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2272 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2273 </example>
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2274 Такие имена называются именами с маской.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2275 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2276
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2277 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2278 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2279 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2280 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2281 server_name .example.com;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2282 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2283 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2284 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2285
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2286 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2287 В качестве имени сервера можно также использовать регулярное выражение,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2288 указав перед ним тильду (“<literal>~</literal>”):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2289 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2290 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2291 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
2292 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2293 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2294 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2295
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2296 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2297 Регулярное выражение может содержать выделения (0.7.40),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2298 которые могут затем использоваться в других директивах:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2299 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2300 server {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2301 server_name ~^(www\.)?(.+)$;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2302
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2303 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2304 root /sites/$2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2305 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2306 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2307
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2308 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2309 server_name _;
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 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2312 root /sites/default;
76
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 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2315 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2316 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2317
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2318 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2319 Именованные выделения в регулярном выражении создают переменные (0.8.25),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2320 которые могут затем использоваться в других директивах:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2321 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2322 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2323 server_name ~^(www\.)?(?&lt;domain&gt;.+)$;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2324
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2325 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2326 root /sites/$domain;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2327 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2328 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2329
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2330 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2331 server_name _;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2332
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2333 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2334 root /sites/default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2335 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2336 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2337 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2338 </para>
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 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2341 Если параметр директивы установлен в “<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
2342 подставляется имя хоста (hostname) машины.
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2343 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2344
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2345 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2346 Возможно также указать пустое имя сервера (0.7.11):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2347 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2348 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2349 server_name www.example.com "";
76
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 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2352 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2353 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2354 Это настройка по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2355 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2356 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2357 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2358 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2359
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2360 <para>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2361 При поиске виртуального сервера по имени,
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2362 если имени соответствует несколько из указанных вариантов,
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2363 например, одновременно подходят и имя с маской, и регулярное выражение,
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2364 будет выбран первый подходящий вариант в следующем порядке приоритета:
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2365 <list type="enum">
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 <listitem>
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2368 точное имя
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2369 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2370
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2371 <listitem>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2372 самое длинное имя с маской в начале,
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2373 например “<literal>*.example.com</literal>”
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2374 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2375
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2376 <listitem>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2377 самое длинное имя с маской в конце,
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2378 например “<literal>mail.*</literal>”
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2379 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2380
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2381 <listitem>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2382 первое подходящее регулярное выражение
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2383 (в порядке следования в конфигурационном файле)
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2384 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2385
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2386 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2387 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2388
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2389 <para>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2390 Подробнее имена серверов обсуждаются в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2391 <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
2392 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2393
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2394 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2395
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2396
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2397 <directive name="server_name_in_redirect">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2398 <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
2399 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2400 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2401 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2402 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2403
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2404 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2405 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2406 основное имя сервера, задаваемое директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2407 <link id="server_name"/>.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2408 Если использование основного имени сервера запрещено, то используется имя,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2409 указанное в поле <header>Host</header> заголовка запроса.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2410 Если же этого поля нет, то используется IP-адрес сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2411 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2412
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2413 <para>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2414 Использование в перенаправлениях порта управляется
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2415 директивой <link id="port_in_redirect"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2416 </para>
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2419
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2420
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2421 <directive name="server_names_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2422 <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
2423 <default>32|64|128</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2424 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2425
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2426 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2427 Задаёт размер корзины в хэш-таблицах имён серверов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2428 Значение по умолчанию зависит от размера строки кэша процессора.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2429 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2430 <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
2431 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2432
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2433 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2434
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2435
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2436 <directive name="server_names_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2437 <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
2438 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2439 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2440
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2441 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2442 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2443 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2444 <link doc="../hash.xml">документе</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2445 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2446
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2447 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2448
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2449
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2450 <directive name="server_tokens">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2451 <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
2452 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2453 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2454 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2455 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2456
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2457 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2458 Разрешает или запрещает выдавать версию nginx’а в сообщениях об ошибках и
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2459 в поле <header>Server</header> заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2460 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2463
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2464
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2465 <directive name="tcp_nodelay">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2466 <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
2467 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2468 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2469 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2470 <context>location</context>
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 <para>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2473 Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>.
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2474 Параметр включаются только при переходе соединения в состояние keep-alive.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2475 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2476
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2477 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2478
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2479
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2480 <directive name="tcp_nopush">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2481 <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
2482 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2483 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2484 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2485 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2486
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2487 <para>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2488 Разрешает или запрещает использование параметра сокета
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2489 <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
2490 <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
2491 Параметр включаются только при использовании <link id="sendfile"/>.
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2492 Включение параметра позволяет
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2493 <list type="bullet">
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 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2496 передавать заголовок ответа и начало файла в одном пакете
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2497 в Linux и во FreeBSD&nbsp;4.*;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2498 </listitem>
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 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2501 передавать файл полными пакетами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2502 </listitem>
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 </list>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2508
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2509
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2510 <directive name="try_files">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2511 <syntax><value>файл</value> ... <value>uri</value></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2512 <syntax><value>файл</value> ... =<value>код</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
2513 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2514 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2515 <context>location</context>
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2518 Проверяет существование файлов в заданном порядке и использует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2519 для обработки запроса первый найденный файл, причём обработка
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2520 делается в контексте этого же location’а.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2521 Путь к файлу строится из параметра <value>файл</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2522 в соответствии с директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2523 <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
2524 С помощью слэша в конце имени можно проверить существование каталога,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2525 например, “<literal>$uri/</literal>”.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2526 В случае, если ни один файл не найден, то делается внутреннее
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2527 перенаправление на <value>uri</value>, заданный последним параметром.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2528 Например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2529 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2530 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2531 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
2532 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2533
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2534 location = /images/default.gif {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2535 expires 30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2536 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2537 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2538 Последний параметр может также указывать на именованный location,
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2539 как в примерах ниже.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2540 С версии 0.7.51 последний параметр может также быть <value>кодом</value>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2541 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2542 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2543 try_files $uri $uri/index.html $uri.html =404;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2544 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2545 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2546 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2547
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2548 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2549 Пример использования при проксировании Mongrel:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2550 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2551 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2552 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
2553 $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
2554 @mongrel;
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2557 location @mongrel {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2558 proxy_pass http://mongrel;
76
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 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2561 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2562
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2563 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2564 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2565 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2566 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2567 try_files $uri $uri/ @drupal;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2568 }
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 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2571 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2572
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2573 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2574
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2575 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
2576 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
2577 fastcgi_param QUERY_STRING $args;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2578
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2579 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2580 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2581
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2582 location @drupal {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2583 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2584
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2585 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
2586 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
2587 fastcgi_param QUERY_STRING q=$uri&amp;$args;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2588
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2589 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2590 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2591 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2592 В следующем примере директива <literal>try_files</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2593 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2594 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2595 try_files $uri $uri/ @drupal;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2596 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2597 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2598 аналогична директивам
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2599 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2600 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2601 error_page 404 = @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2602 log_not_found off;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2603 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2604 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2605 А здесь
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2606 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2607 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2608 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2609
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2610 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2611
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2612 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2613
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2614 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2615 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2616 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2617 <literal>try_files</literal> проверяет существование PHP-файла,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2618 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2619 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2620
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2621 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2622 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2623 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2624 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2625 try_files $uri $uri/ @wordpress;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2626 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2627
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2628 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2629 try_files $uri @wordpress;
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 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2632
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2633 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2634 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2635 }
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 location @wordpress {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2638 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2639
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2640 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2641 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2642 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2643 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2644 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2645
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2646 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2647
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2648
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2649 <directive name="types">
108
72524ae53106 Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
2650 <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
2651 <default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2652 text/html html;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2653 image/gif gif;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2654 image/jpeg jpg;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2655 </default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2656 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2657 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2658 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2659
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2660 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2661 Задаёт соответствие расширений имён файлов и MIME-типов ответов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2662 Расширения нечувствительны к регистру символов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2663 Одному MIME-типу может соответствовать несколько расширений, например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2664 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2665 types {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2666 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
2667 application/octet-stream deb;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2668 application/octet-stream dmg;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2669 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2670 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2671 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2672
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2673 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2674 Достаточно полная таблица соответствий входит в дистрибутив nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2675 и находится в файле <path>conf/mime.types</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2676 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2677
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2678 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 958
diff changeset
2679 Для того чтобы для определённого location’а для всех ответов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2680 выдавался 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
2681 можно использовать следующее:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2682 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2683 location /download/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2684 types { }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2685 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
2686 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2687 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2688 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2689
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2690 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2691
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2692
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2693 <directive name="types_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2694 <syntax><value>размер</value></syntax>
1132
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2695 <default>64</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2696 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2697 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2698 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2699
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2700 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2701 Задаёт размер корзины в хэш-таблицах типов.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2702 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2703 <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
2704 <note>
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2705 До версии 1.5.13
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2706 значение по умолчанию зависело от размера строки кэша процессора.
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2707 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2708 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2709
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2710 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2711
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2712
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2713 <directive name="types_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2714 <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
2715 <default>1024</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2716 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2717 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2718 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2719
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2720 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2721 Задаёт максимальный <value>размер</value> хэш-таблиц типов.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2722 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2723 <link doc="../hash.xml">документе</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2724 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2727
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2728
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2729 <directive name="underscores_in_headers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2730 <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
2731 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2732 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2733 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2734
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2735 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2736 Разрешает или запрещает использование символов подчёркивания в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2737 полях заголовка запроса клиента.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2738 Если использование символов подчёркивания запрещено, поля заголовка запроса, в
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2739 именах которых есть подчёркивания,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2740 помечаются как недопустимые и подпадают под действие директивы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2741 <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
2742 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2743
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2744 <para>
1023
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2745 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2746 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2747 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2748 Указанное значение распространяется на все виртуальные серверы,
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2749 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2750 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2751
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2752 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2753
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2754
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2755 <directive name="variables_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2756 <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
2757 <default>64</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2758 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2759
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2760 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2761 Задаёт размер корзины в хэш-таблице переменных.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2762 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2763 <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
2764 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2765
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2766 </directive>
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2769 <directive name="variables_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2770 <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
2771 <default>1024</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2772 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2773
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2774 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2775 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2776 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2777 <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
2778 <note>
a0543e9213e7 New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents: 1097
diff changeset
2779 До версии 1.5.13 по умолчанию использовалось значение 512.
a0543e9213e7 New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents: 1097
diff changeset
2780 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2781 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2782
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2783 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2784
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2785 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2786
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2787
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2788 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2789
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2790 <para>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2791 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2792 переменные, имена которых совпадают с именами переменных веб-сервера Apache.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2793 Прежде всего, это переменные, представляющие из себя поля заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2794 запроса клиента, такие как <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
2795 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2796 Кроме того, есть и другие переменные:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2797 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2798
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2799 <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
2800 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2801 аргумент <value>имя</value> в строке запроса
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2802 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2803
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2804 <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
2805 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2806 аргументы в строке запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2807 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2808
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2809 <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
2810 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2811 адрес клиента в бинарном виде, длина значения всегда 4 байта
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2812 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2813
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2814 <tag-name id="var_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
2815 <tag-desc>
769
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2816 число байт, переданное клиенту, без учёта заголовка ответа;
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2817 переменная совместима с параметром “<literal>%B</literal>” модуля Apache
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2818 <literal>mod_log_config</literal>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2819 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2820
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2821 <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
2822 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2823 число байт, переданное клиенту (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
2824 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2825
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2826 <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
2827 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2828 порядковый номер соединения (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
2829 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2830
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2831 <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
2832 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2833 текущее число запросов в соединении (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
2834 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2835
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2836 <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
2837 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2838 поле <header>Content-Length</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2839 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2840
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2841 <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
2842 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2843 поле <header>Content-Type</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2844 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2845
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2846 <tag-name id="var_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
2847 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2848 cookie <value>имя</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2849 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2850
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2851 <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
2852 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2853 значение директивы <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
2854 для текущего запроса
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2855 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2856
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2857 <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
2858 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2859 то же, что и <var>$uri</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2860 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2861
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2862 <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
2863 <tag-desc>
940
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2864 в порядке приоритета:
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2865 имя хоста из строки запроса, или
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2866 имя хоста из поля <header>Host</header> заголовка запроса, или
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2867 имя сервера, соответствующего запросу
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2868 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2869
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2870 <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
2871 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2872 имя хоста
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2873 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2874
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2875 <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
2876 <tag-desc>
448
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2877 произвольное поле заголовка запроса;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2878 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2879 к нижнему регистру, с заменой символов тире на символы подчёркивания
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2880 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2881
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2882 <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
2883 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2884 “<literal>on</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2885 если соединение работает в режиме SSL,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2886 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2887 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2888
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2889 <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
2890 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2891 “<literal>?</literal>”, если в строке запроса есть аргументы,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2892 и пустая строка, если их нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2893 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2894
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2895 <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
2896 <tag-desc>
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
2897 установка этой переменной позволяет ограничивать скорость
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
2898 передачи ответа, см. <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
2899 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2900
771
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
2901 <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
2902 <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
2903 текущее время в секундах с точностью до миллисекунд (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
2904 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
2905
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2906 <tag-name id="var_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
2907 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2908 версия nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2909 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2910
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2911 <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
2912 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2913 номер (PID) рабочего процесса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2914 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2915
826
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
2916 <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
2917 <tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
2918 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
2919 (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
2920 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
2921
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2922 <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
2923 <tag-desc>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2924 адрес клиента, полученный из заголовка протокола PROXY, либо пустая строка
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2925 (1.5.12)
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2926 <para>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2927 Протокол PROXY должен быть предварительно включён при помощи установки
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2928 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2929 </para>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2930 </tag-desc>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2931
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2932 <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
2933 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2934 то же, что и <var>$args</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2935 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2936
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2937 <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
2938 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2939 абсолютный путь, соответствующий
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2940 значению директивы <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
2941 для текущего запроса,
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2942 в котором все символические ссылки преобразованы в реальные пути
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2943 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2944
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2945 <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
2946 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2947 адрес клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2948 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2949
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2950 <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
2951 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2952 порт клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2953 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2954
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2955 <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
2956 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2957 имя пользователя, использованное в Basic аутентификации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2958 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2959
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2960 <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
2961 <tag-desc>
431
0412333658fe Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents: 429
diff changeset
2962 первоначальная строка запроса целиком
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2963 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2964
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2965 <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
2966 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2967 тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2968 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2969 Значение переменной появляется в location’ах, обрабатываемых
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2970 директивами
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
2971 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>,
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
2972 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
2973 <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
2974 и
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
2975 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2976 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2977 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2978
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2979 <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
2980 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2981 имя временного файла, в котором хранится тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2982 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2983 По завершении обработки файл необходимо удалить.
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 958
diff changeset
2984 Для того чтобы тело запроса всегда записывалось в файл,
406
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
2985 следует включить <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
2986 При передаче имени временного файла в проксированном запросе
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
2987 или в запросе к FastCGI/uwsgi/SCGI-серверу следует запретить передачу самого
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2988 тела директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2989 <link doc="ngx_http_proxy_module.xml" id="proxy_pass_request_body">
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
2990 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
2991 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass_request_body">
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
2992 fastcgi_pass_request_body off</link>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
2993 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass_request_body">
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
2994 uwsgi_pass_request_body off</link>
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
2995 или
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
2996 <link doc="ngx_http_scgi_module.xml" id="scgi_pass_request_body">
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
2997 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
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 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3001
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3002 <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
3003 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3004 “<literal>OK</literal>” если запрос завершился,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3005 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3006 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3007
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3008 <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
3009 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3010 путь к файлу для текущего запроса, формируемый из директив
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3011 <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
3012 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3013
826
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3014 <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
3015 <tag-desc>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3016 длина запроса (включая строку запроса, заголовок и тело запроса)
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3017 (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
3018 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3019
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3020 <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
3021 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3022 метод запроса, обычно
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3023 “<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
3024 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3025
771
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
3026 <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
3027 <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
3028 время обработки запроса в секундах с точностью до миллисекунд
32b8498cfb40 $msec and $request_time have become generic variables in 1.2.6.
Ruslan Ermilov <ru@nginx.com>
parents: 771
diff changeset
3029 (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
3030 время, прошедшее с момента чтения первых байт от клиента
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
3031 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
3032
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3033 <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
3034 <tag-desc>
431
0412333658fe Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents: 429
diff changeset
3035 первоначальный URI запроса целиком (с аргументами)
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3036 </tag-desc>
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_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
3039 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3040 схема запроса, “<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
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_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
3044 <tag-desc>
448
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
3045 произвольное поле заголовка ответа;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
3046 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
3047 к нижнему регистру, с заменой символов тире на символы подчёркивания
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3048 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3049
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3050 <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
3051 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3052 адрес сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3053 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3054 Получение значения этой переменной обычно требует одного системного вызова.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3055 Чтобы избежать системного вызова, в директивах <link id="listen"/>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3056 следует указывать адреса и использовать параметр <literal>bind</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3057 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3058 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3059
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3060 <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
3061 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3062 имя сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3063 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3064
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3065 <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
3066 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3067 порт сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3068 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3069
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3070 <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
3071 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3072 протокол сервера, обычно
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3073 “<literal>HTTP/1.0</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3074 или
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3075 “<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
3076 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3077
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3078 <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
3079 <tag-desc>
769
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
3080 статус ответа (1.3.2, 1.2.2)
541
a8971cf346be Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents: 537
diff changeset
3081 </tag-desc>
a8971cf346be Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents: 537
diff changeset
3082
826
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3083 <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
3084 <tag-desc>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3085 локальное время в формате по стандарту 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
3086 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3087
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3088 <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
3089 <tag-desc>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3090 локальное время в 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
3091 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3092
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3093 <tag-name id="var_tcpinfo_">
453
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3094 <var>$tcpinfo_rtt</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3095 <var>$tcpinfo_rttvar</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3096 <var>$tcpinfo_snd_cwnd</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3097 <var>$tcpinfo_rcv_space</var>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3098 </tag-name>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3099 <tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3100 информация о клиентском TCP-соединении; доступна на системах,
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
3101 поддерживающих параметр сокета <c-def>TCP_INFO</c-def>
453
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3102 </tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3103
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3104 <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
3105 <tag-desc>
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3106 текущий 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
3107 <para>
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3108 Значение <var>$uri</var> может изменяться в процессе обработки запроса,
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3109 например, при внутренних перенаправлениях
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3110 или при использовании индексных файлов.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3111 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3112 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3113
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3114 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3115 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3116
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3117 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3118
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3119 </module>