annotate xml/ru/docs/http/ngx_http_core_module.xml @ 1692:4319f72f11f5

Documented the $request_id variable.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 28 Apr 2016 14:24:04 +0300
parents 57c3f36b3b6a
children 6c96a644b0b3
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"
1692
4319f72f11f5 Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
13 rev="55">
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> |
1436
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
20 <literal>off</literal> |
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
21 <literal>threads</literal>[<literal>=</literal><value>pool</value>]</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
22 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
23 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
24 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
25 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
26 <appeared-in>0.8.11</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
29 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO)
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
30 во FreeBSD и Linux:
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
31 <example>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
32 location /video/ {
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
33 aio on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
34 output_buffers 1 64k;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
35 }
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
36 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
40 Во FreeBSD 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
41 AIO можно либо собрать в ядре статически:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 options VFS_AIO
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
45 либо загрузить динамически через загружаемый модуль ядра:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47 kldload aio
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50
1430
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
51 <!--
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
53 В версиях FreeBSD 5 и 6 включение AIO статически или динамически
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
54 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
55 будет использовать блокировку Giant, что может негативно сказаться на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
56 производительности системы в целом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
57 Это ограничение устранено во 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
58 и во FreeBSD&nbsp;7.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
59 Однако, начиная с FreeBSD&nbsp;5.3 есть возможность включать AIO,
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
60 не связывая сетевую подсистему блокировкой Giant — для этого модуль
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
61 AIO нужно подгружать уже после загрузки ядра.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
62 В этом случае в <path>/var/log/messages</path> появится следующее сообщение:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68 <note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
69 Требование использовать блокировку Giant в AIO связано с тем, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
70 FreeBSD поддерживает асинхронные вызовы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
71 <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
72 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
73 <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
74 для работы с сокетами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
75 Но поскольку nginx использует AIO только для работы с диском,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
76 то проблем не возникает.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77 </note>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78 </para>
1430
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
79 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
82 В Linux AIO можно использовать только начиная с версии ядра 2.6.22.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
83 Кроме того, необходимо также дополнительно включить
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
84 <link id="directio"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
85 иначе чтение будет блокирующимся:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
87 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
88 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
89 directio 512;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
90 output_buffers 1 128k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
94
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
96 В Linux
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
97 <link id="directio"/>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
98 можно использовать только для чтения блоков, выравненных
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
99 на границу 512 байт (или 4К для XFS).
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
100 Невыравненный конец файла будет читаться блокированно.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
101 То же относится к запросам с указанием диапазона запрашиваемых байт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
102 (byte-range requests) и к запросам FLV не с начала файла: чтение
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
103 невыравненных начала и конца ответа будет блокирующимся.
1430
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
104 </para>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
105
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
106 <para>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
107 При одновременном включении 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
108 для файлов, размер которых больше либо равен указанному
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
109 в директиве <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
110 а для файлов меньшего размера
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
111 или при выключенном <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
112 <example>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
113 location /video/ {
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
114 sendfile on;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
115 aio on;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
116 directio 8m;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
117 }
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux.
Ruslan Ermilov <ru@nginx.com>
parents: 1279
diff changeset
118 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
121 <para>
1436
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
122 Кроме того, читать и <link id="sendfile">отправлять</link>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
123 файлы можно в многопоточном режиме (1.7.11),
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
124 не блокируя при этом рабочий процесс:
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
125 <example>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
126 location /video/ {
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
127 sendfile on;
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
128 aio threads;
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
129 }
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
130 </example>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
131 Операции чтения или отправки файлов будут обрабатываться потоками из указанного
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
132 <link doc="../ngx_core_module.xml" id="thread_pool">пула</link>.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
133 Если пул потоков не задан явно,
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
134 используется пул с именем “<literal>default</literal>”.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
135 Имя пула может быть задано при помощи переменных:
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
136 <example>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
137 aio threads=pool$disk;
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
138 </example>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
139 По умолчанию поддержка многопоточности выключена, её сборку следует
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
140 разрешить с помощью конфигурационного параметра
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
141 <literal>--with-threads</literal>.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
142 В настоящий момент многопоточность совместима только с методами
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
143 <link doc="../events.xml" id="epoll"/>,
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
144 <link doc="../events.xml" id="kqueue"/>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
145 и
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
146 <link doc="../events.xml" id="eventport"/>.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
147 Отправка файлов в многопоточном режиме поддерживается только на Linux.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
148 </para>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
149
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1432
diff changeset
150 <para>
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
151 См. также директиву <link id="sendfile"/>.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
152 </para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
153
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
156
1664
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
157 <directive name="aio_write">
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
158 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
159 <default>off</default>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
160 <context>http</context>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
161 <context>server</context>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
162 <context>location</context>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
163 <appeared-in>1.9.13</appeared-in>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
164
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
165 <para>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
166 При включённом <link id="aio"/> разрешает его использование для записи файлов.
1665
57b53a0818df Slightly paraphrased aio_write description for better perception.
Ruslan Ermilov <ru@nginx.com>
parents: 1664
diff changeset
167 В настоящий момент это работает только при использовании
1664
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
168 <literal>aio threads</literal>
1665
57b53a0818df Slightly paraphrased aio_write description for better perception.
Ruslan Ermilov <ru@nginx.com>
parents: 1664
diff changeset
169 и ограничено записью временных файлов с данными,
1664
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
170 полученными от проксируемых серверов.
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
171 </para>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
172
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
173 </directive>
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
174
1a05fd32dca8 Documented the "aio_write" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1636
diff changeset
175
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176 <directive name="alias">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
177 <syntax><value>путь</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
178 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
179 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
181 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
182 Задаёт замену для указанного location’а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
183 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
184 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
185 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
186 alias /data/w3/images/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
187 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
188 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
189 на запрос
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
190 “<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
191 <path>/data/w3/images/top.gif</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
193
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
195 В значении параметра <value>путь</value> можно использовать переменные,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
196 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
197 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
198
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
200 Если <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
201 регулярным выражением, то регулярное выражение должно содержать
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
202 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
203 (0.7.40), например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
204 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205 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
206 alias /data/w3/images/$1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
207 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
208 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
209 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
210
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
212 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
213 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
214 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
215 alias /data/w3/images/;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
216 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
217 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
218 то лучше воспользоваться директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
219 <link id="root"/>:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
220 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
221 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
222 root /data/w3;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
225 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
226
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
227 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
228
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
229
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
230 <directive name="chunked_transfer_encoding">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
231 <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
232 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
233 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
234 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
235 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
236
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
237 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
238 Позволяет запретить формат передачи данных частями (chunked transfer
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
239 encoding) в HTTP/1.1.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
240 Это может понадобиться при использовании программ, не поддерживающих
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
241 chunked encoding, несмотря на требования стандарта.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
242 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
243
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
244 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
245
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
246
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
247 <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
248
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
249 <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
250 <default>8k|16k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
251 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
252 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
253 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
254
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
255 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
256 Задаёт размер буфера для чтения тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
257 Если тело запроса больше заданного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
258 то всё тело запроса или только его часть записывается во
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
259 <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
260 По умолчанию размер одного буфера равен двум размерам страницы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
261 На 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
262 На других 64-битных платформах это обычно 16K.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
263 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
264
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
265 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
266
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 <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
269 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
270 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
271 <literal>clean</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
272 <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
273 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
274 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
275 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
276 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
277
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
278 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
279 Определяет, сохранять ли всё тело запроса клиента в файл.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
280 Директиву можно использовать для отладки и при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
281 <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
282 или метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
283 <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
284 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
285 <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
286 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
287
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
288 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
289 При установке значения <literal>on</literal> временные файлы
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
290 по окончании обработки запроса не удаляются.
76
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 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
294 Значение <literal>clean</literal> разрешает удалять временные файлы,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
295 оставшиеся по окончании обработки запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
296 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
297
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
298 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
299
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
300
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
301 <directive name="client_body_in_single_buffer">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
302 <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
303 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
304 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
305 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
306 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
307
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
308 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
309 Определяет, сохранять ли всё тело запроса клиента в одном буфере.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
310 Директива рекомендуется при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
311 <var>$request_body</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
312 для уменьшения требуемого числа операций копирования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313 </para>
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
316
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
317
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
318 <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
319 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
320 <value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
321 [<value>уровень1</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
322 [<value>уровень2</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
323 [<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
324 <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
325 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
326 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
327 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
328
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
329 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
330 Задаёт каталог для хранения временных файлов с телами запросов клиентов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
331 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
332 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
333 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
334 client_body_temp_path /spool/nginx/client_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335 </example>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
336 путь к временному файлу будет следующего вида:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
337 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
338 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
339 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
340 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
341
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
342 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
343
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
344
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
345 <directive name="client_body_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
346 <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
347 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
348 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
349 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
350 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
351
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
352 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
353 Задаёт таймаут при чтении тела запроса клиента.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
354 Таймаут устанавливается не на всю передачу тела запроса,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
355 а только между двумя последовательными операциями чтения.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
356 Если по истечении этого времени клиент ничего не передаст,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
357 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
358 <http-status code="408" text="Request Time-out"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
359 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
360
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
361 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
362
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
363
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
364 <directive name="client_header_buffer_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
365 <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
366 <default>1k</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
367 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
368 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
369
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
370 <para>
253
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 Для большинства запросов достаточно буфера размером в 1K байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
373 Однако если в запросе есть длинные cookies, или же запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
374 пришёл от WAP-клиента, то он может не поместиться в 1K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
375 Поэтому, если строка запроса или поле заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
376 не помещаются полностью в этот буфер, то выделяются буферы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
377 большего размера, задаваемые директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
378 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
379 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
380
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
381 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
382
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
383
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
384 <directive name="client_header_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
385 <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
386 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
387 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
388 <context>server</context>
76
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
391 Задаёт таймаут при чтении заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
392 Если по истечении этого времени клиент не передаст полностью заголовок,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
393 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
394 <http-status code="408" text="Request Time-out"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
395 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
396
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
397 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
398
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
399
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
400 <directive name="client_max_body_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
401 <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
402 <default>1m</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
403 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
404 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
405 <context>location</context>
76
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
408 Задаёт максимально допустимый размер тела запроса клиента,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
409 указываемый в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
410 <header>Content-Length</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
411 заголовка запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
412 Если размер больше заданного, то клиенту возвращается ошибка
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
413 <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
414 Следует иметь в виду, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
415 <!--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
416 эту ошибку<!--/link-->.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
417 Установка параметра <value>размер</value> в 0 отключает
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
418 проверку размера тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
419 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
420
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
421 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
422
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
423
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
424 <directive name="connection_pool_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
425 <syntax><value>размер</value></syntax>
1619
88ad8fcea975 Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1597
diff changeset
426 <default>256|512</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
427 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
428 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
429
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
430 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
431 Позволяет производить точную настройку выделения памяти
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
432 под конкретные соединения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
433 Эта директива не оказывает существенного влияния на
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
434 производительность, и её не следует использовать.
1619
88ad8fcea975 Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1597
diff changeset
435 По умолчанию размер равен
88ad8fcea975 Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1597
diff changeset
436 256 байт на 32-битных платформах и 512 байт на 64-битных платформах.
88ad8fcea975 Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1597
diff changeset
437 <note>
88ad8fcea975 Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1597
diff changeset
438 До версии 1.9.8 по умолчанию использовалось значение 256 на всех платформах.
88ad8fcea975 Changed default value of connection_pool_size.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1597
diff changeset
439 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
440 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
441
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
442 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
443
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
444
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
445 <directive name="default_type">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
446 <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
447 <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
448 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
449 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
450 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
451
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
452 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
453 Задаёт MIME-тип ответов по умолчанию.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
454 Соответствие расширений имён файлов MIME-типу ответов задаётся
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
455 с помощью директивы <link id="types"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
456 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
457
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
458 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
459
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
460
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
461 <directive name="directio">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
462 <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
463 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
464 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
465 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
466 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
467 <appeared-in>0.7.7</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
468
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
469 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
470 Разрешает использовать флаги
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
471 <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
472 <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
473 или функцию <c-func>directio</c-func> (Solaris)
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
474 при чтении файлов, размер которых больше либо равен указанному.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
475 Директива автоматически запрещает (0.7.15) использование
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
476 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
477 для данного запроса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
478 Рекомендуется использовать для больших файлов:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
479 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
480 directio 4m;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
481 </example>
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
482 или при использовании <link id="aio"/> в Linux.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
483 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
484
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
485 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
486
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
487
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
488 <directive name="directio_alignment">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
489 <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
490 <default>512</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
491 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
492 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
493 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
494 <appeared-in>0.8.11</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
495
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
496 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
497 Устанавливает выравнивание для
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
498 <link id="directio"/>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
499 В большинстве случаев достаточно 512-байтового выравнивания, однако
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
500 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
501 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
502
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
503 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
504
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
505
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
506 <directive name="disable_symlinks">
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
507 <syntax><literal>off</literal></syntax>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
508 <syntax>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
509 <literal>on</literal> |
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
510 <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
511 [<literal>from</literal>=<value>часть</value>]</syntax>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
512 <default>off</default>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
513 <context>http</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
514 <context>server</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
515 <context>location</context>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
516 <appeared-in>1.1.15</appeared-in>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
517
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
518 <para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
519 Определяет, как следует поступать с символическими ссылками
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 <list type="tag">
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
522
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
523 <tag-name><literal>off</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
524 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
525 Символические ссылки в пути допускаются и не проверяются.
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
526 Это стандартное поведение.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
527 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
528
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
529 <tag-name><literal>on</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
530 <tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
531 Если любой компонент пути является символической ссылкой,
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
532 доступ к файлу запрещается.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
533 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
534
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
535 <tag-name><literal>if_not_owner</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
536 <tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
537 Доступ к файлу запрещается, если любой компонент пути
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
538 является символической ссылкой, а ссылка и объект, на
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
539 который она ссылается, имеют разных владельцев.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
540 </tag-desc>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
541
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
542 <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
543 <tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
544 При проверке символических ссылок
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
545 (параметры <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
546 обычно проверяются все компоненты пути.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
547 Можно не проверять символические ссылки в начальной части пути,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
548 указав дополнительно параметр
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
549 <literal>from</literal>=<value>часть</value>.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
550 В этом случае символические ссылки проверяются лишь начиная
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
551 с компонента пути, который следует за заданной начальной частью.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
552 Если значение не является начальной частью проверяемого пути,
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
553 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
554 Если значение целиком совпадает с именем файла,
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
555 символические ссылки не проверяются.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
556 В значении параметра можно использовать переменные.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
557 </tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
558
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
559 </list>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
560 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
561
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
562 <para>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
563 Пример:
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
564 <example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
565 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
566 </example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
567 </para>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
568
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
569 <para>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
570 Эта директива доступна только на системах, в которых есть
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
571 интерфейсы <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
572 К таким системам относятся современные версии FreeBSD, Linux и Solaris.
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
573 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
574
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
575 <para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
576 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
577 требуют дополнительных затрат на обработку.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
578 <note>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
579 На системах, не поддерживающих операцию открытия каталогов только для поиска,
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
580 для использования этих параметров требуется, чтобы рабочие процессы
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
581 имели право читать все проверяемые каталоги.
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
582 </note>
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
583 </para>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
584
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
585 <para>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
586 <note>
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
587 Модули
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
588 <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
589 <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
590 и <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
591 в настоящий момент игнорируют эту директиву.
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
592 </note>
418
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
593 </para>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
594
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
595 </directive>
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
596
2638f67205ee Documented the disable_symlinks directive.
Ruslan Ermilov <ru@nginx.com>
parents: 406
diff changeset
597
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
598 <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
599 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
600 <value>код</value> ...
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
601 [<literal>=</literal>[<value>ответ</value>]]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
602 <value>uri</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
603 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
604 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
605 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
606 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
607 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
608
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
609 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
610 Задаёт URI, который будет показываться для указанных ошибок.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
611 Директивы <literal>error_page</literal> наследуются с предыдущего уровня
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
612 при условии, что на данном уровне не заданы свои директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
613 <literal>error_page</literal>.
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
614 В значении <literal>uri</literal> можно использовать переменные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
615 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
616
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
617 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
618 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
619 <example>
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
620 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
621 error_page 500 502 503 504 /50x.html;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
622 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
623 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
624
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
625 <para>
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
626 Кроме того, можно поменять код ответа на другой,
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
627 используя синтаксис вида “<literal>=</literal><value>ответ</value>”, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
628 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
629 error_page 404 =200 /empty.gif;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
630 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
631 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
632
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
633 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
634 Если ошибочный ответ обрабатывается проксированным сервером или
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
635 FastCGI/uwsgi/SCGI-сервером, и этот сервер может вернуть разные коды ответов,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
636 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
637 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
638 error_page 404 = /404.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
639 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
640 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
641
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
642 <para>
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
643 Также существует возможность использовать перенаправления для обработки
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
644 ошибок:
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
645 <example>
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
646 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
647 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
648 </example>
871
96839d165b8a Clarify the description of error_page example.
Sergey Kandaurov <pluknet@nginx.com>
parents: 869
diff changeset
649 В этом случае по умолчанию клиенту возвращается код ответа 302.
948
2b0731e3adc9 Slightly fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 941
diff changeset
650 Его можно изменить только на один из кодов ответа, относящихся к
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
651 перенаправлениям (301, 302, 303 и 307).
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
652 </para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
653
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
654 <para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
655 Если при внутреннем перенаправлении не нужно менять URI, то можно передать
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
656 обработку ошибки в именованный location:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
657 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
658 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
659 error_page 404 = @fallback;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
660 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
661
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
662 location @fallback {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
663 proxy_pass http://backend;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
664 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
665 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
666 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
667
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
668 <para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
669 <note>
711
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 709
diff changeset
670 Если при обработке <literal>uri</literal> происходит ошибка,
948
2b0731e3adc9 Slightly fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 941
diff changeset
671 клиенту возвращается ответ с кодом последней случившейся ошибки.
679
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
672 </note>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
673 </para>
9888364847b7 Documented status codes in the error_page directive.
Vladimir Homutov <vl@nginx.com>
parents: 674
diff changeset
674
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
675 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
676
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
677
576
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
678 <directive name="etag">
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
679 <syntax><literal>on</literal> | <literal>off</literal></syntax>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
680 <default>on</default>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
681 <context>http</context>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
682 <context>server</context>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
683 <context>location</context>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
684 <appeared-in>1.3.3</appeared-in>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
685
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
686 <para>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
687 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
688 заголовка ответа для статических ресурсов.
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
689 </para>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
690
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
691 </directive>
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
692
cac22cc79afd Documented the "etag" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 566
diff changeset
693
651
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
694 <directive name="http">
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
695 <syntax block="yes"/>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
696 <default/>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
697 <context>main</context>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
698
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
699 <para>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
700 Предоставляет контекст конфигурационного файла, в котором указываются
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
701 директивы HTTP-сервера.
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
702 </para>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
703
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
704 </directive>
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
705
eba81bfb6aaf Documented the "http" directive.
Vladimir Homutov <vl@nginx.com>
parents: 646
diff changeset
706
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
707 <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
708 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
709 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
710 <literal>exact</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
711 <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
712 <default>exact</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
713 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
714 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
715 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
716 <appeared-in>0.7.24</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
717
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
718 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
719 Определяет, как сравнивать время модификации ответа с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
720 временем в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
721 <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
722 заголовка запроса:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
723
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
724 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
725
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
726 <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
727 <tag-desc>
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 <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
730 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
731
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
732 <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
733 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
734 точное совпадение;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
735 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
736
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
737 <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
738 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
739 время модификации ответа меньше или равно времени, заданному в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
740 <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
741 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
742
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
743 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
744 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
745
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
746 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
747
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
748
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
749 <directive name="ignore_invalid_headers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
750 <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
751 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
752 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
753 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
754
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
755 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
756 Если включено, nginx игнорирует поля заголовка с недопустимыми именами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
757 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
758 и возможно знаков подчёркивания (последнее контролируется директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
759 <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
760 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
761
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
762 <para>
1023
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
763 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
764 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
765 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
766 Указанное значение распространяется на все виртуальные серверы,
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
767 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
768 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
769
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
770 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
771
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
772
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
773 <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
774 <syntax/>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
775 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
776 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
777
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
778 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
779 Указывает, что location может использоваться только для внутренних запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
780 Для внешних запросов клиенту будет возвращаться ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
781 <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
782 Внутренними запросами являются:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
783
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
784 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
785
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
786 <listitem>
429
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
787 запросы, перенаправленные директивами
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
788 <link id="error_page"/>,
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
789 <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
790 <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
791 <link id="try_files"/>;
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
792 </listitem>
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
793
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
794 <listitem>
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
795 запросы, перенаправленные с помощью поля
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
796 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
797 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
798
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
799 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
800 подзапросы, формируемые командой
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
801 “<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
802 модуля
438
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
803 <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
804 и директивами модуля
b27974b92a58 - corrected the description of the from= parameter of the
Ruslan Ermilov <ru@nginx.com>
parents: 436
diff changeset
805 <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
806 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
807
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
808 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
809 запросы, изменённые директивой
429
2b9507b2cdf3 List all sources of internal requests.
Ruslan Ermilov <ru@nginx.com>
parents: 426
diff changeset
810 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
811 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
812
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
813 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
814 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
815
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
816 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
817 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
818 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
819 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
820
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
821 location /404.html {
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
822 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
823 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
824 </example>
674
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
825 <note>
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
826 Для предотвращения зацикливания, которое может возникнуть при
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
827 использовании некорректных конфигураций, количество внутренних
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
828 перенаправлений ограничено десятью.
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
829 По достижении этого ограничения будет возвращена ошибка
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
830 <http-status code="500" text="Internal Server Error"/>.
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
831 В таком случае в лог-файле ошибок можно увидеть сообщение
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
832 “rewrite or internal redirection cycle”.
c48c0936b4df Documented internal redirections limit.
Vladimir Homutov <vl@nginx.com>
parents: 659
diff changeset
833 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
834 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
835
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
836 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
837
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
838
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
839 <directive name="keepalive_disable">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
840 <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
841 <default>msie6</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
842 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
843 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
844 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
845
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
846 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
847 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
848 Параметры <value>браузер</value> указывают, на какие браузеры это
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
849 распространяется.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
850 Значение <literal>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
851 со старыми версиями MSIE после получения запроса POST.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
852 Значение <literal>safari</literal> запрещает keep-alive соединения
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
853 с Safari и подобными им браузерами на Mac OS X и подобных ей ОС.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
854 Значение <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
855 со всеми браузерами.
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
856 <note>
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
857 До версии 1.1.18 под значение <literal>safari</literal> подпадали
549
ab1449e0573b Typo fixed.
Andrey Belov <defan@nginx.com>
parents: 541
diff changeset
858 все Safari и подобные им браузеры на всех ОС, и keep-alive
467
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
859 соединения с ними были по умолчанию запрещены.
c505c92c8658 Documented recent changes to the "keepalive_disable" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 454
diff changeset
860 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
861 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
862
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
863 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
864
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
865
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
866 <directive name="keepalive_requests">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
867 <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
868 <default>100</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
869 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
870 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
871 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
872 <appeared-in>0.8.0</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
873
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
874 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
875 Задаёт максимальное число запросов, которые можно
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
876 сделать по одному keep-alive соединению.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
877 После того, как сделано максимальное число запросов,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
878 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
879 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
880
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
881 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
884 <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
885 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
886 <value>таймаут</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
887 [<value>заголовок_таймаута</value>]</syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
888 <default>75s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
889 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
890 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
891 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
892
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
893 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
894 Первый параметр задаёт таймаут, в течение которого keep-alive
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
895 соединение с клиентом не будет закрыто со стороны сервера.
835
e0263d44a59b Http core: documented "keepalive_timeout 0".
Ruslan Ermilov <ru@nginx.com>
parents: 826
diff changeset
896 Значение 0 запрещает keep-alive соединения с клиентами.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
897 Второй необязательный параметр задаёт значение в поле
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
898 <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
899 заголовка ответа.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
900 Два параметра могут отличаться друг от друга.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
901 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
902
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
903 <para>
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 <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
906 заголовка понимают Mozilla и Konqueror.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
907 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
908 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
909
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
910 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
911
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
912
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
913 <directive name="large_client_header_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
914 <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
915 <default>4 8k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
916 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
917 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
918
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
919 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
920 Задаёт максимальное <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
921 буферов для чтения большого заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
922 Строка запроса не должна превышать размера одного буфера, иначе клиенту
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
923 возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
924 <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
925 Поле заголовка запроса также не должно превышать размера одного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
926 иначе клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
927 <http-status code="400" text="Bad Request"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
928 Буферы выделяются только по мере необходимости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
929 По умолчанию размер одного буфера равен 8K байт.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
930 Если по окончании обработки запроса соединение переходит в состояние
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
931 keep-alive, эти буферы освобождаются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
932 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
933
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
934 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
935
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
936
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
937 <directive name="limit_except">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
938 <syntax block="yes"><value>метод</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
939 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
940 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
941
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
942 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
943 Ограничивает HTTP-методы, доступные внутри location.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
944 Параметр <value>метод</value> может быть одним из
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
945 <literal>GET</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
946 <literal>HEAD</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
947 <literal>POST</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
948 <literal>PUT</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
949 <literal>DELETE</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
950 <literal>MKCOL</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
951 <literal>COPY</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
952 <literal>MOVE</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
953 <literal>OPTIONS</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
954 <literal>PROPFIND</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
955 <literal>PROPPATCH</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
956 <literal>LOCK</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
957 <literal>UNLOCK</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
958 или
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
959 <literal>PATCH</literal>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
960 Если разрешён метод <literal>GET</literal>, то метод
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
961 <literal>HEAD</literal> также будет разрешён.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
962 Доступ к остальным методам может быть ограничен при помощи директив модулей
79
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
963 <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
964 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
965 <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
966 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
967 limit_except GET {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
968 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
969 deny all;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
970 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
971 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
972 Обратите внимание, что данное ограничение действует для всех методов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
973 <emphasis>кроме</emphasis> GET и HEAD.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
974 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
975
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
976 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
977
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
978
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
979 <directive name="limit_rate">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
980 <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
981 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
982 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
983 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
984 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
985 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
986
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
987 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
988 Ограничивает скорость передачи ответа клиенту.
1519
89ac38f2225b Added missing tags to the "limit_rate" directive in Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1513
diff changeset
989 <value>Скорость</value> задаётся в байтах в секунду.
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
990 Значение 0 отключает ограничение скорости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
991 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
992 Чем меньше скорость, тем более аккуратным будет ограничение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
993 -->
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
994 Ограничение устанавливается на запрос, поэтому, если клиент одновременно
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
995 откроет два соединения, суммарная скорость будет вдвое выше
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
996 заданного ограничения.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
997 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
998
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
999 <para>
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
1000 Ограничение скорости можно также задать в переменной <var>$limit_rate</var>.
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
1001 Это может быть полезно в случаях, когда скорость нужно ограничивать
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
1002 в зависимости от какого-либо условия:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1003 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1004 server {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1005
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1006 if ($slow) {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1007 set $limit_rate 4k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1008 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1009
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1010 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1011 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1012 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1013 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1014
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 503
diff changeset
1015 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 503
diff changeset
1016 Кроме того, ограничение скорости может быть задано в поле
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
1017 <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
1018 Эту возможность можно запретить с помощью директив
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
1019 <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
1020 <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
1021 <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
1022 и
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
1023 <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
1024 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 503
diff changeset
1025
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1026 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1027
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1028
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1029 <directive name="limit_rate_after">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1030 <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
1031 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1032 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1033 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1034 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1035 <context>if в location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1036 <appeared-in>0.8.0</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1037
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1038 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1039 Задаёт начальный объём данных, после передачи которого начинает
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1040 ограничиваться скорость передачи ответа клиенту.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1041 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1042
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1043 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1044 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1045 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1046 location /flv/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1047 flv;
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1048 limit_rate_after 500k;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1049 limit_rate 50k;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1050 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1051 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1052 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1053
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1054 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1055
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1056
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1057 <directive name="lingering_close">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1058 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1059 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1060 <literal>on</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1061 <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
1062 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1063 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1064 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1065 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1066 <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
1067 <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
1068
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1069 <para>
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 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1072
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1073 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1074 Со значением по умолчанию “<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
1075 <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
1076 <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
1077 поступающие от клиента, перед полным закрытием соединения, но только
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1078 если эвристика указывает на то, что клиент может ещё послать данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1079 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1080
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1081 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1082 Со значением “<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
1083 ждать и обрабатывать дополнительные данные, поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1084 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1085
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1086 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1087 Со значением “<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
1088 дополнительных данных и сразу же закроет соединение.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1089 Это поведение нарушает протокол и поэтому не должно использоваться без
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1090 необходимости.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1091 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1092
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1093 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1094
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1095
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1096 <directive name="lingering_time">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1097 <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
1098 <default>30s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1099 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1100 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1101 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1102
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1103 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1104 Если действует <link id="lingering_close"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1105 эта директива задаёт максимальное время, в течение которого nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1106 будет обрабатывать (читать и игнорировать) дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1107 поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1108 По прошествии этого времени соединение будет закрыто, даже если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1109 будут ещё данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1110 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1111
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1112 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1113
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1114
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1115 <directive name="lingering_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1116 <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
1117 <default>5s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1118 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1119 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1120 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1121
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1122 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1123 Если действует <link id="lingering_close"/>, эта директива задаёт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1124 максимальное время ожидания поступления дополнительных данных от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1125 Если в течение этого времени данные не были получены, соединение закрывается.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1126 В противном случае данные читаются и игнорируются, и nginx снова
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1127 ждёт поступления данных.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1128 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1129 директивой <link id="lingering_time"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1130 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1131
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1132 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1133
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1134
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1135 <directive name="listen">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1136 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1137 <value>адрес</value>[:<value>порт</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1138 [<literal>default_server</literal>]
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1139 [<literal>ssl</literal>]
1567
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1140 [<literal>http2</literal> | <literal>spdy</literal>]
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1141 [<literal>proxy_protocol</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1142 [<literal>setfib</literal>=<value>число</value>]
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1143 [<literal>fastopen</literal>=<value>число</value>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1144 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1145 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1146 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1147 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1148 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1149 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1150 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1493
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1151 [<literal>reuseport</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1152 [<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
1153 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1154 <value>порт</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1155 [<literal>default_server</literal>]
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1156 [<literal>ssl</literal>]
1567
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1157 [<literal>http2</literal> | <literal>spdy</literal>]
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1158 [<literal>proxy_protocol</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1159 [<literal>setfib</literal>=<value>число</value>]
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1160 [<literal>fastopen</literal>=<value>число</value>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1161 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1162 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1163 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1164 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1165 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1166 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1167 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1493
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1168 [<literal>reuseport</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1169 [<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
1170 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1171 <literal>unix:</literal><value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1172 [<literal>default_server</literal>]
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1173 [<literal>ssl</literal>]
1567
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1174 [<literal>http2</literal> | <literal>spdy</literal>]
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1175 [<literal>proxy_protocol</literal>]
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1176 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1177 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1178 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1179 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1180 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1181 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1182 [<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
1183 <default>*:80 | *:8000</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1184 <context>server</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1185
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1186 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1187 Задаёт <value>адрес</value> и <value>порт</value> для IP
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1188 или <value>путь</value> для UNIX-сокета,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1189 на которых сервер будет принимать запросы.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1190 Можно указать <value>адрес</value> и <value>порт</value>,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1191 либо только <value>адрес</value> или только <value>порт</value>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1192 Кроме того, <value>адрес</value> может быть именем хоста, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1193 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1194 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
1195 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
1196 listen 8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1197 listen *:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1198 listen localhost:8000;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1199 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1200 IPv6-адреса (0.7.36) задаются в квадратных скобках:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1201 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1202 listen [::]:8000;
941
7d1d53d4d293 Removed link-scoped IPv6 addresses from examples.
Ruslan Ermilov <ru@nginx.com>
parents: 940
diff changeset
1203 listen [::1];
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1204 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1205 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
1206 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1207 listen unix:/var/run/nginx.sock;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1208 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1209 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1210
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1211 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1212 Если указан только <value>адрес</value>, то используется порт 80.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1213 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1214
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1215 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1216 Если директива не указана, то используется либо <literal>*:80</literal>,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1217 если nginx работает с привилегиями суперпользователя,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1218 либо <literal>*:8000</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1219 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1220
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1221 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1222 Если у директивы есть параметр <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
1223 в котором описана эта директива, будет сервером по умолчанию для указанной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1224 <value>адрес</value>:<value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1225 Если же директив с параметром <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
1226 сервером по умолчанию будет первый сервер, в котором описана пара
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1227 <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
1228 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1229 До версии 0.8.21 этот параметр назывался просто
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1230 <literal>default</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1231 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1232 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1233
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1234 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1235 Параметр <literal>ssl</literal> (0.7.14) указывает на то, что все соединения,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1236 принимаемые на данном порту, должны работать в режиме SSL.
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1237 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1238 id="single_http_https_server">конфигурацию</link> для сервера,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1239 работающего сразу в двух режимах — HTTP и HTTPS.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1240 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1241
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1242 <para>
1567
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1243 Параметр <literal>http2</literal> (1.9.5) позволяет принимать на этом порту
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1244 <link doc="ngx_http_v2_module.xml">HTTP/2</link>-соединения.
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1245 Обычно, чтобы это работало, следует также указать параметр
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1246 <literal>ssl</literal>, однако nginx можно также настроить и на приём
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1247 HTTP/2-соединений без SSL.
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1248 </para>
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1249
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1250 <para>
695999bdd4a5 Updated description of http2 parameter, translated into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1545
diff changeset
1251 Параметр <literal>spdy</literal> (1.3.15-1.9.4) позволяет принимать на этом порту
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1252 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1253 Обычно, чтобы это работало, следует также указать параметр
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1254 <literal>ssl</literal>, однако nginx можно также настроить и на приём
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1255 SPDY-соединений без SSL.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1256 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1257
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents: 840
diff changeset
1258 <para>
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1259 Параметр <literal>proxy_protocol</literal> (1.5.12)
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1260 указывает на то, что все соединения, принимаемые на данном порту,
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1261 должны использовать
1513
88d1a1d36c0c Corrected link to the PROXY protocol specification.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1507
diff changeset
1262 <link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">протокол
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1263 PROXY</link>.
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1264 </para>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1265
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
1266 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1267 В директиве <literal>listen</literal> можно также указать несколько
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1268 дополнительных параметров, специфичных для связанных с сокетами
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1269 системных вызовов.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1270 Эти параметры можно задать в любой директиве <literal>listen</literal>,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1271 но только один раз для указанной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1272 <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
1273 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1274 До версии 0.8.21 их можно было указывать лишь в директиве
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1275 <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
1276 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1277 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1278
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1279 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1280 <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
1281 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1282 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1283 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1284 (параметр <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
1285 В настоящий момент это работает только на FreeBSD.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1286 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1287
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1288 <tag-name>
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1289 <literal>fastopen</literal>=<value>число</value>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1290 </tag-name>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1291 <tag-desc>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1292 включает
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1293 “<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
1294 для слушающего сокета (1.5.8) и
1633
eb6409ad9dca Fixed link to TCP Fast Open RFC.
Ruslan Ermilov <ru@nginx.com>
parents: 1619
diff changeset
1295 <link url="http://tools.ietf.org/html/rfc7413#section-5.1">ограничивает</link>
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1296 максимальную длину очереди соединений, которые ещё не завершили процесс
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1297 three-way handshake.
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1298 <note>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1299 Не включайте “TCP Fast Open”, не убедившись, что сервер может адекватно
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1300 обрабатывать многократное получение
1633
eb6409ad9dca Fixed link to TCP Fast Open RFC.
Ruslan Ermilov <ru@nginx.com>
parents: 1619
diff changeset
1301 <link url="http://tools.ietf.org/html/rfc7413#section-6.1">
1036
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1302 одного и того же SYN-пакета с данными</link>.
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1303 </note>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1304 </tag-desc>
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1305
5894aa46ffef Documented "listen fastopen=" parameter.
Vladimir Homutov <vl@nginx.com>
parents: 1035
diff changeset
1306 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1307 <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
1308 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1309 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1310 задаёт параметр <literal>backlog</literal> в вызове
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1311 <c-func>listen</c-func>, который ограничивает
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1312 максимальный размер очереди ожидающих приёма соединений.
741
082a725038db Fixed default backlog value description for Mac OS X
Sergey Budnevitch <sb@waeme.net>
parents: 738
diff changeset
1313 По умолчанию <literal>backlog</literal> устанавливается равным -1 для
1501
40425063b413 Fixed the default "listen backlog" value on DragonFly BSD.
Ruslan Ermilov <ru@nginx.com>
parents: 1500
diff changeset
1314 FreeBSD, DragonFly BSD и 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
1315 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1316
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1317 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1318 <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
1319 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1320 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1321 задаёт размер буфера приёма
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1322 (параметр <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
1323 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1324
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1325 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1326 <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
1327 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1328 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1329 задаёт размер буфера передачи
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1330 (параметр <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
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>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
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>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1337 задаёт название accept-фильтра
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1338 (параметр <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
1339 который включается для фильтрации входящих соединений
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1340 перед передачей их в <c-func>accept</c-func>.
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1341 Работает только на FreeBSD и NetBSD 5.0+.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1342 Можно использовать два фильтра:
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1343 <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
1344 и
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1345 <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
1346 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1347
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1348 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1349 <literal>deferred</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1350 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1351 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1352 указывает использовать отложенный <c-func>accept</c-func>
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1353 (параметр <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
1354 </tag-desc>
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 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1357 <literal>bind</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1358 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1359 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1360 указывает, что для данной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1361 <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
1362 <c-func>bind</c-func> отдельно.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1363 Это нужно потому, что если описаны несколько директив <literal>listen</literal>
629
7e4805858796 Fixed punctuation.
Ruslan Ermilov <ru@nginx.com>
parents: 625
diff changeset
1364 с одинаковым портом, но разными адресами, и одна из директив
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1365 <literal>listen</literal> слушает на всех адресах для данного порта
629
7e4805858796 Fixed punctuation.
Ruslan Ermilov <ru@nginx.com>
parents: 625
diff changeset
1366 (<literal>*:</literal><value>порт</value>), то nginx сделает
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1367 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
1478
002216d96931 Typo fixed.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
1368 Необходимо заметить, что в этом случае для определения адреса, на который
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1369 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
1035
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1370 Если же используются параметры <literal>setfib</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1371 <literal>backlog</literal>, <literal>rcvbuf</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1372 <literal>sndbuf</literal>, <literal>accept_filter</literal>,
1279
7261e621dd4a Documented that "listen ipv6only=" implies "bind".
Maxim Dounin <mdounin@mdounin.ru>
parents: 1257
diff changeset
1373 <literal>deferred</literal>, <literal>ipv6only</literal>
7261e621dd4a Documented that "listen ipv6only=" implies "bind".
Maxim Dounin <mdounin@mdounin.ru>
parents: 1257
diff changeset
1374 или <literal>so_keepalive</literal>,
1035
e9c485d6cc0c Documented that "listen setfib=" implies "bind".
Ruslan Ermilov <ru@nginx.com>
parents: 1031
diff changeset
1375 то для данной пары
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1376 <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
1377 отдельный вызов <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
1378 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1379
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1380 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1381 <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
1382 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1383 <tag-desc>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1384 этот параметр (0.7.42) определяет
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1385 (через параметр сокета <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
1386 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1387 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения.
615
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1388 По умолчанию параметр включён.
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1389 Установить его можно только один раз на старте.
615
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1390 <note>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1391 До версии 1.3.4,
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1392 если этот параметр не был задан явно, то для сокета действовали
615
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1393 настройки операционной системы.
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1394 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1395 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1396
1507
14180fa9a518 Added ids for reuseport, mentioned reuseport in news.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1501
diff changeset
1397 <tag-name id="reuseport">
1493
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1398 <literal>reuseport</literal>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1399 </tag-name>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1400 <tag-desc>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1401 этот параметр (1.9.1) указывает, что нужно создавать отдельный слушающий сокет
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1402 для каждого рабочего процесса
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1403 (через параметр сокета <c-def>SO_REUSEPORT</c-def>), позволяя ядру
1496
99ce48c8cce3 Corrected the "reuseport" description of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1493
diff changeset
1404 распределять входящие соединения между рабочими процессами.
1500
cd534da03d02 Added Linux kernel version in reuseport.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1496
diff changeset
1405 В настоящий момент это работает только на Linux 3.9+ и DragonFly BSD.
1493
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1406 <note>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1407 Ненадлежащее использование параметра может иметь
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1408 <link url="http://man7.org/linux/man-pages/man7/socket.7.html">последствия</link>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1409 в плане безопасности.
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1410 </note>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1411 </tag-desc>
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1412
9faa78768252 Documented the "reuseport" option of the "listen" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1478
diff changeset
1413 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1414 <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
1415 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1416 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1417 этот параметр (1.1.11) конфигурирует для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1418 поведение “TCP keepalive”.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1419 Если этот параметр опущен, то для сокета будут действовать
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1420 настройки операционной системы.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1421 Если он установлен в значение “<literal>on</literal>”, то для сокета
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1422 включается параметр <c-def>SO_KEEPALIVE</c-def>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1423 Если он установлен в значение “<literal>off</literal>”, то для сокета
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1424 параметр <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
1425 Некоторые операционные системы поддерживают настройку параметров
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1426 “TCP keepalive” на уровне сокета посредством параметров
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1427 <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
1428 <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
1429 На таких системах (в настоящий момент это 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
1430 FreeBSD 9.0-STABLE)
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1431 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1432 <value>keepintvl</value> и <value>keepcnt</value>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1433 Один или два параметра могут быть опущены, в таком случае для
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1434 соответствующего параметра сокета будут действовать стандартные
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1435 системные настройки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1436 Например,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1437 <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
1438 установит таймаут бездействия (<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
1439 для интервала проб (<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
1440 стандартная системная настройка, а счётчик проб (<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
1441 будет равен 10.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1442 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1443
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1444 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1445 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1446
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1447 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1448 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1449 <example>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
1450 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
1451 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1452 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1453
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1454 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1455
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1456
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1457 <directive name="location">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1458 <syntax block="yes">[
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1459 <literal>=</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1460 <literal>~</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1461 <literal>~*</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1462 <literal>^~</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1463 ] <value>uri</value></syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1464 <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
1465 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1466 <context>server</context>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1467 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1468
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1469 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1470 Устанавливает конфигурацию в зависимости от URI запроса.
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1471 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1472
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1473 <para>
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1474 Для сопоставления используется URI запроса в нормализованном виде,
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1475 после декодирования текста, заданного в виде “<literal>%XX</literal>”,
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1476 преобразования относительных элементов пути “<literal>.</literal>” и
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1477 “<literal>..</literal>” в реальные и возможной
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1478 <link id="merge_slashes">замены</link> двух и более подряд идущих
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1479 слэшей на один.
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1480 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1481
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1482 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1483 location можно задать префиксной строкой или регулярным выражением.
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1484 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1485 (для поиска совпадения без учёта регистра символов),
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1486 либо с модификатором “<literal>~</literal>” (с учётом регистра).
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1487 Чтобы найти location, соответствующий запросу, вначале проверяются
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1488 location’ы, заданные префиксными строками (префиксные location’ы).
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1489 Среди них ищется location с совпадающим префиксом
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1490 максимальной длины и запоминается.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1491 Затем проверяются регулярные выражения, в порядке их следования
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1492 в конфигурационном файле.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1493 Проверка регулярных выражений прекращается после первого же совпадения,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1494 и используется соответствующая конфигурация.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1495 Если совпадение с регулярным выражением не найдено, то используется
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1496 конфигурация запомненного ранее префиксного location’а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1497 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1498
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1499 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1500 Блоки <literal>location</literal> могут быть вложенными,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1501 с некоторыми исключениями, о которых говорится ниже.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1502 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1503
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1504 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1505 Для операционных систем, нечувствительных к регистру символов, таких
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1506 как Mac OS X и Cygwin, сравнение с префиксными строками производится
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1507 без учёта регистра (0.7.7).
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1508 Однако сравнение ограничено только однобайтными locale’ями.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1509 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1510
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1511 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1512 Регулярные выражения могут содержать выделения (0.7.40), которые могут
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1513 затем использоваться в других директивах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1514 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1515
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1516 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1517 Если у совпавшего префиксного location’а максимальной длины указан модификатор
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1518 “<literal>^~</literal>”, то регулярные выражения не проверяются.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1519 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1520
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1521 <para>
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1522 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1523 совпадение URI и location.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1524 При точном совпадении поиск сразу же прекращается.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1525 Например, если запрос “<literal>/</literal>” случается часто, то
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1526 указав “<literal>location = /</literal>”, можно ускорить обработку
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1527 этих запросов, так как поиск прекратится после первого же сравнения.
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1528 Очевидно, что такой location не может иметь вложенные location’ы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1529 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1530
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1531 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1532 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1533 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
810
7c72c3e67e77 The "location" directive: improved wording.
Ruslan Ermilov <ru@nginx.com>
parents: 779
diff changeset
1534 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
1535 то поиск тоже сразу же прекращается и регулярные выражения также
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1536 не проверяются.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1537 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1538 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1539
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1540 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1541 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1542 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1543 location = / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1544 [ конфигурация А ]
76
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
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1547 location / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1548 [ конфигурация Б ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1549 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1550
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1551 location /documents/ {
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1552 [ конфигурация В ]
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1553 }
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1554
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1555 location ^~ /images/ {
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1556 [ конфигурация Г ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1557 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1558
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1559 location ~* \.(gif|jpg|jpeg)$ {
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1560 [ конфигурация Д ]
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1561 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1562 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1563 Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
738
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1564 для запроса “<literal>/index.html</literal>” — конфигурация Б,
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1565 для запроса “<literal>/documents/document.html</literal>” — конфигурация В,
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1566 для запроса “<literal>/images/1.gif</literal>” — конфигурация Г,
0914bbb59fd2 Expanded "location" examples with another prefix location.
Ruslan Ermilov <ru@nginx.com>
parents: 711
diff changeset
1567 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Д.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1568 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1569
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1570 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1571 Префикс “<literal>@</literal>” задаёт именованный location.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1572 Такой location не используется при обычной обработке запросов, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1573 предназначен только для перенаправления в него запросов.
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1574 Такие location’ы не могут быть вложенными и не могут содержать
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1575 вложенные location’ы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1576 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1577
914
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1578 <para>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1579 Если location задан префиксной строкой со слэшом в конце
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1580 и запросы обрабатываются при помощи
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1581 <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
1582 <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
1583 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
1584 <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
1585 <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
1586 происходит специальная обработка.
ac7a5ee98768 Split long sentence into two.
Ruslan Ermilov <ru@nginx.com>
parents: 1194
diff changeset
1587 В ответ на запрос с URI равным этой строке, но без завершающего слэша,
914
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1588 будет возвращено постоянное перенаправление с кодом 301
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1589 на URI с добавленным в конец слэшом.
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1590 Если такое поведение нежелательно, можно задать точное совпадение
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1591 URI и location, например:
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1592 <example>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1593 location /user/ {
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1594 proxy_pass http://user.example.com;
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1595 }
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1596
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1597 location = /user {
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1598 proxy_pass http://login.example.com;
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1599 }
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1600 </example>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1601 </para>
474a21f26a2a Documented location behavior with proxying directives.
Vladimir Homutov <vl@nginx.com>
parents: 871
diff changeset
1602
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1603 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1604 <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
1605 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1606
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1607 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1608
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1609
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1610 <directive name="log_not_found">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1611 <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
1612 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1613 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1614 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1615 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1616
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1617 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1618 Разрешает или запрещает записывать в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1619 <link doc="../ngx_core_module.xml" id="error_log"/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1620 ошибки о том, что файл не найден.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1621 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1622
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1623 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1626 <directive name="log_subrequest">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1627 <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
1628 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1629 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1630 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1631 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1632
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1633 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1634 Разрешает или запрещает записывать в
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
1635 <link doc="ngx_http_log_module.xml" id="access_log"/>
76
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 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1638
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1639 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1640
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1641
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1642 <directive name="max_ranges">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1643 <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
1644 <default/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1645 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1646 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1647 <context>location</context>
499
76a8eca844d0 Documented that "max_ranges" appeared in 1.1.2.
Ruslan Ermilov <ru@nginx.com>
parents: 477
diff changeset
1648 <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
1649
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1650 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1651 Ограничивает максимальное допустимое число диапазонов в запросах с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1652 указанием диапазона запрашиваемых байт (byte-range requests).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1653 Запросы, превышающие указанное ограничение, обрабатываются как
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1654 если бы они не содержали указания диапазонов.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1655 По умолчанию число диапазонов не ограничено.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1656 Значение 0 полностью запрещает поддержку диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1657 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1658
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1659 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1660
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1661
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1662 <directive name="merge_slashes">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1663 <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
1664 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1665 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1666 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1667
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1668 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1669 Разрешает или запрещает преобразование URI путём замены двух и более подряд
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
1670 идущих слэшей (“<literal>/</literal>”) на один.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1671 </para>
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 <para>
280
cbb789d3ce5e Fixed grammar error.
Ruslan Ermilov <ru@nginx.com>
parents: 274
diff changeset
1674 Необходимо иметь в виду, что это преобразование необходимо для корректной
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1675 проверки префиксных строк и регулярных выражений.
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1676 Если его не делать, то запрос “<literal>//scripts/one.php</literal>”
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
1677 не попадёт в
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1678 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1679 location /scripts/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1680 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1681 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1682 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1683 и может быть обслужен как статический файл.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1684 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1685 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1686
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1687 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1688 Запрет преобразования может понадобиться, если в URI используются имена,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1689 закодированные методом base64, в котором задействован символ
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1690 “<literal>/</literal>”.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1691 Однако из соображений безопасности лучше избегать отключения преобразования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1692 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1693
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1694 <para>
1023
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1695 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1696 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1697 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
1698 Указанное значение распространяется на все виртуальные серверы,
442
b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes",
Ruslan Ermilov <ru@nginx.com>
parents: 438
diff changeset
1699 слушающие на том же адресе и порту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1700 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1701
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1702 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1703
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1704
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1705 <directive name="msie_padding">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1706 <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
1707 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1708 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1709 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1710 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1711
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1712 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1713 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1714 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1715 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1716
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1717 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1720 <directive name="msie_refresh">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1721 <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
1722 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1723 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1724 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1725 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1726
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1727 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1728 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1729 перенаправлений.
76
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">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1736 <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
1737 <syntax>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1738 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1739 [<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
1740 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1741 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1742 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1743 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1744
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1745 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1746 Задаёт кэш, в котором могут храниться:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1747 <list type="bullet">
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 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1750 дескрипторы открытых файлов, информация об их размерах и времени модификации;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1751 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1752
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1753 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1754 информация о существовании каталогов;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1755 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1756
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1757 <listitem>
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1758 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1759 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1760 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1761 Кэширование ошибок нужно разрешить отдельно директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1762 <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
1763 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1764 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1765
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1766 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1767 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1768
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1769 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1770 У директивы есть следующие параметры:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1771 <list type="tag">
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 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1774 <literal>max</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1775 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1776 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1777 задаёт максимальное число элементов в кэше;
507
d00a4f9b1c5d Better translation of "LRU".
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
1778 при переполнении кэша удаляются наименее востребованные элементы (LRU);
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1779 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1780
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1781 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1782 <literal>inactive</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1783 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1784 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1785 задаёт время, после которого элемент кэша удаляется, если к нему
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1786 не было обращений в течение этого времени; по умолчанию 60 секунд;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1787 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1788
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1789 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1790 <literal>off</literal>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1791 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1792 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1793 запрещает кэш.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1794 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1795
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1796 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1797 </para>
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 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1801 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1802 open_file_cache max=1000 inactive=20s;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1803 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1804 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1805 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
1806 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1807 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
1808 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1809 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1810 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1811
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1812 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1813
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1814
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1815 <directive name="open_file_cache_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1816 <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
1817 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1818 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1819 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1820 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1821
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1822 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1823 Разрешает или запрещает кэширование ошибок поиска файлов в
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1824 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1825 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1826
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1827 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1828
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1829
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1830 <!--
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 <directive name="open_file_cache_events">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1833 <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
1834 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1835 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1836 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1837 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1838
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1839 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1840 Разрешает использование событий ядра для проверки актуальности элементов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1841 <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
1842 Эта директива работает только совместно с методом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1843 <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
1844 Заметьте, что только 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
1845 поддерживают события для файловых систем произвольного типа.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1846 Другие операционные системы поддерживают события только для
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1847 основных файловых систем, таких как UFS или FFS.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1848 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1849
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1850 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1851
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1852 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1853
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1854
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1855 <directive name="open_file_cache_min_uses">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1856 <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
1857 <default>1</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1858 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1859 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1860 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1861
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1862 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1863 Задаёт минимальное <value>число</value> обращений к файлу
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1864 в течение времени, заданного параметром <literal>inactive</literal>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1865 директивы <link id="open_file_cache"/>, необходимых для того, чтобы дескриптор
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
1866 файла оставался открытым в кэше.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1867 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1868
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1869 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1870
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1871
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1872 <directive name="open_file_cache_valid">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1873 <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
1874 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1875 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1876 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1877 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1878
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1879 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1880 Определяет время, через которое следует проверять актуальность информации
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 <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
1883 <!--
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 <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
1886 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1887 по факту их изменения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1888 -->
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1889 </para>
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1892
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1893
1024
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1894 <directive name="output_buffers">
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1895 <syntax><value>number</value> <value>size</value></syntax>
1576
7f97ab081d24 Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1567
diff changeset
1896 <default>2 32k</default>
1024
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1897 <context>http</context>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1898 <context>server</context>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1899 <context>location</context>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1900
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1901 <para>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1902 Задаёт <value>число</value> и <value>размер</value> буферов,
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1903 используемых при чтении ответа с диска.
1576
7f97ab081d24 Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1567
diff changeset
1904 <note>
7f97ab081d24 Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1567
diff changeset
1905 До версии 1.9.5 по умолчанию использовалось значение 1 32k.
7f97ab081d24 Changed default value in the output_buffers directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1567
diff changeset
1906 </note>
1024
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1907 </para>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1908
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1909 </directive>
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1910
e47971bf6619 Documented output_buffers directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1023
diff changeset
1911
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1912 <directive name="port_in_redirect">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1913 <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
1914 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1915 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1916 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1917 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1918
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1919 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
1920 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx’ом.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1921 </para>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1922
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1923 <para>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
1924 Использование в перенаправлениях основного имени сервера управляется
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
1925 директивой <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
1926 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1927
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1928 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1929
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1930
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1931 <directive name="postpone_output">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1932 <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
1933 <default>1460</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1934 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1935 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1936 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1937
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1938 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1939 Если это возможно, то отправка данных клиенту будет отложена пока nginx не
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1940 накопит по крайней мере указанное количество байт для отправки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1941 Значение 0 запрещает отложенную отправку данных.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1942 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1943
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1944 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1945
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1946
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1947 <directive name="read_ahead">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1948 <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
1949 <default>0</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1950 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1951 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1952 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1953
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1954 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1955 Задаёт ядру размер предчтения при работе с файлами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1956 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1957
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1958 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1959 На Linux используется системный вызов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1960 <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
1961 поэтому параметр <value>размер</value> там игнорируется.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1962 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1963
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1964 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1965 На FreeBSD используется системный вызов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1966 <literal>fcntl(O_READAHEAD,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1967 </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
1968 появившийся во 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
1969 Для FreeBSD&nbsp;7 необходимо установить
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1970 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1971 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1972
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1973 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1974
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 name="recursive_error_pages">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1977 <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
1978 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1979 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1980 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1981 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1982
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1983 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1984 Разрешает или запрещает делать несколько перенаправлений через директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1985 <link id="error_page"/>.
709
a4648185190a Fixed the link internal to the module.
Ruslan Ermilov <ru@nginx.com>
parents: 679
diff changeset
1986 Число таких перенаправлений <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
1987 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1988
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1989 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1990
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1991
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1992 <directive name="request_pool_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
1993 <syntax><value>размер</value></syntax>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1994 <default>4k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1995 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1996 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1997
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1998 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1999 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2000 под конкретные запросы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2001 Эта директива не оказывает существенного влияния на
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2002 производительность, и её не следует использовать.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2003 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2004
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2005 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2006
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2007
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2008 <directive name="reset_timedout_connection">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2009 <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
2010 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2011 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2012 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2013 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2014
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2015 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2016 Разрешает или запрещает сброс соединений по таймауту.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2017 Сброс делается следующим образом.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2018 Перед закрытием сокета для него задаётся параметр
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2019 <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
2020 с таймаутом 0.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2021 После этого при закрытии сокета клиенту отсылается TCP RST, а вся память,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2022 связанная с этим сокетом, освобождается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2023 Это позволяет избежать длительного нахождения уже закрытого сокета в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2024 состоянии FIN_WAIT1 с заполненными буферами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2025 </para>
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 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2028 Необходимо отметить, что keep-alive соединения по истечении таймаута
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2029 закрываются обычным образом.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2030 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2031
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2032 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2035 <directive name="resolver">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2036 <syntax>
1031
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2037 <value>адрес</value> ...
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2038 [<literal>valid</literal>=<value>время</value>]
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2039 [<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
2040 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2041 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2042 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2043 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2044
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2045 <para>
318
4a0fe9283dc7 Word polishing in the description of the "server" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 280
diff changeset
2046 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2047 в адреса, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2048 <example>
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2049 resolver 127.0.0.1 [::1]:5353;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2050 </example>
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2051 Адрес может быть указан в виде доменного имени или IP-адреса,
566
f8148fc88224 Documented 1.2.2 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 549
diff changeset
2052 и необязательного порта (1.3.1, 1.2.2).
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2053 Если порт не указан, используется порт 53.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2054 Серверы DNS опрашиваются циклически.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2055 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2056 До версии 1.1.7 можно было задать лишь один DNS-сервер.
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2057 Задание DNS-серверов с помощью IPv6-адресов поддерживается
566
f8148fc88224 Documented 1.2.2 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 549
diff changeset
2058 начиная с версий 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
2059 </note>
1031
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2060 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2061 при преобразовании имён в адреса.
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2062 Если поиск IPv6-адресов нежелателен,
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2063 можно указать параметр <literal>ipv6=off</literal>.
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2064 <note>
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2065 Преобразование имён в IPv6-адреса поддерживается
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2066 начиная с версии 1.5.8.
f7f23f5928ef Documented "resolver ipv6=" parameter.
Ruslan Ermilov <ru@nginx.com>
parents: 1024
diff changeset
2067 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2068 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2069 Необязательный параметр <literal>valid</literal> позволяет это
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2070 переопределить:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2071 <example>
527
58d79f8c412d Documented 1.3.1 changes in "resolver".
Ruslan Ermilov <ru@nginx.com>
parents: 522
diff changeset
2072 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
2073 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2074 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2075 До версии 1.1.9 настройка времени кэширования была невозможна
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2076 и nginx всегда кэшировал ответы на срок в 5 минут.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2077 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2078 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2079
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2080 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2081
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2082
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2083 <directive name="resolver_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2084 <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
2085 <default>30s</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2086 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2087 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2088 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2089
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2090 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2091 Задаёт таймаут для преобразования имени в адрес, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2092 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2093 resolver_timeout 5s;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2094 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2095 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2096
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2097 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2098
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2099
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2100 <directive name="root">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2101 <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
2102 <default>html</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2103 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2104 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2105 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2106 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2107
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2108 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2109 Задаёт корневой каталог для запросов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2110 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2111 <example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2112 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2113 root /data/w3;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2114 }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2115 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2116 в ответ на запрос “<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
2117 <path>/data/w3/i/top.gif</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2118 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2119
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2120 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2121 В значении параметра <value>путь</value> можно использовать переменные,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2122 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2123 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2124
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2125 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2126 Путь к файлу формируется путём простого добавления URI к значению директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2127 <literal>root</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2128 Если же URI необходимо поменять, следует воспользоваться директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2129 <link id="alias"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2130 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2131
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2132 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2133
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2134
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2135 <directive name="satisfy">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2136 <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
2137 <default>all</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2138 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2139 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2140 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2141
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2142 <para>
971
6316a7579448 Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents: 966
diff changeset
2143 Разрешает доступ, если все (<literal>all</literal>)
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2144 или хотя бы один (<literal>any</literal>) из модулей
971
6316a7579448 Documented the "ngx_http_auth_request" module.
Vladimir Homutov <vl@nginx.com>
parents: 966
diff changeset
2145 <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
2146 <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
2147 <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
2148 разрешают доступ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2149 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2150
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2151 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2152 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2153 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2154 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2155 satisfy any;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2156
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2157 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
2158 deny all;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2159
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2160 auth_basic "closed site";
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2161 auth_basic_user_file conf/htpasswd;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2162 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2163 </example>
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
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2169 <directive name="send_lowat">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2170 <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
2171 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2172 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2173 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2174 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2175
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2176 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2177 При установке этой директивы в ненулевое значение nginx будет пытаться
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2178 минимизировать число операций отправки на клиентских сокетах либо при
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2179 помощи флага <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
2180 <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
2181 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>.
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2182 В обоих случаях будет использован указанный <value>размер</value>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2183 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2184
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2185 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2186 Эта директива игнорируется на Linux, Solaris и Windows.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2187 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2188
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2189 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2190
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2191
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2192 <directive name="send_timeout">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2193 <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
2194 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2195 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2196 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2197 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2198
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2199 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2200 Задаёт таймаут при передаче ответа клиенту.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2201 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2202 а только между двумя операциями записями.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2203 Если по истечении этого времени клиент ничего не примет,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2204 соединение будет закрыто.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2205 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2206
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2207 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2208
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2209
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2210 <directive name="sendfile">
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2211
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2212 <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
2213 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2214 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2215 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2216 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2217 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2218
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2219 <para>
253
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 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2223
1432
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2224 <para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2225 Начиная с 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
2226 можно использовать <link id="aio"/> для подгрузки данных
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2227 для <c-func>sendfile</c-func>:
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2228 <example>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2229 location /video/ {
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2230 sendfile on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2231 tcp_nopush on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2232 aio on;
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2233 }
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2234 </example>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2235 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2236 <c-def>SF_NODISKIO</c-def>, в результате чего она не блокируется на диске, а
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2237 сообщает об отсутствии данных в памяти.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2238 После этого nginx инициирует асинхронную подгрузку данных, читая один байт.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2239 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2240 при последующих чтениях файл подгружается частями только по 16K.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2241 Изменить это можно с помощью директивы
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2242 <link id="read_ahead"/>.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2243 <note>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2244 До версии 1.7.11 подгрузка данных включалась с помощью
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2245 <literal>aio sendfile;</literal>.
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2246 </note>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2247 </para>
9012d7935c9b Documented that "aio sendfile" is deprecated.
Ruslan Ermilov <ru@nginx.com>
parents: 1430
diff changeset
2248
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2249 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2250
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2251
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2252 <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
2253
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2254 <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
2255 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2256 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2257 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2258 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2259
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2260 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2261 При установке в ненулевое значение ограничивает объём данных,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2262 который может передан за один вызов <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
2263 Без этого ограничения одно быстрое соединение может целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2264 захватить рабочий процесс.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2265 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2266
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2267 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2268
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2269
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2270 <directive name="server">
108
72524ae53106 Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
2271 <syntax block="yes"/>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
2272 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2273 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2274
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2275 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2276 Задаёт конфигурацию для виртуального сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2277 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2278 и 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
2279 Вместо этого директивами <link id="listen"/> описываются все
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2280 адреса и порты, на которых нужно принимать соединения для этого сервера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2281 а в директиве <link id="server_name"/> указываются все имена серверов.
522
ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
2282 Примеры конфигураций описаны в документе
ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts"
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
2283 “<link doc="request_processing.xml"/>”.
76
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2287
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2288
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2289 <directive name="server_name">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2290 <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
2291 <default>""</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2292 <context>server</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2293
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2294 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2295 Задаёт имена виртуального сервера, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2296 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2297 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2298 server_name example.com www.example.com;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2299 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2300 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2301 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2302
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2303 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2304 Первое имя становится основным именем сервера.
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2305 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2306
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2307 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2308 В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2309 для замены первой или последней части имени:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2310 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2311 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2312 server_name example.com *.example.com www.example.*;
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 </example>
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2315 Такие имена называются именами с маской.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2316 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2317
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2318 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2319 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2320 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2321 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2322 server_name .example.com;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2323 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2324 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2325 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2326
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2327 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2328 В качестве имени сервера можно также использовать регулярное выражение,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2329 указав перед ним тильду (“<literal>~</literal>”):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2330 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2331 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2332 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
2333 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2334 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2335 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2336
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2337 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2338 Регулярное выражение может содержать выделения (0.7.40),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2339 которые могут затем использоваться в других директивах:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2340 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2341 server {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2342 server_name ~^(www\.)?(.+)$;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2343
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2344 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2345 root /sites/$2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2346 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2347 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2348
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2349 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2350 server_name _;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2351
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2352 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2353 root /sites/default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2354 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2355 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2356 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2357 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2358
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2359 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2360 Именованные выделения в регулярном выражении создают переменные (0.8.25),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2361 которые могут затем использоваться в других директивах:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2362 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2363 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2364 server_name ~^(www\.)?(?&lt;domain&gt;.+)$;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2365
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2366 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2367 root /sites/$domain;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2368 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2369 }
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 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2372 server_name _;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2373
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2374 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2375 root /sites/default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2376 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2377 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2378 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2379 </para>
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 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2382 Если параметр директивы установлен в “<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
2383 подставляется имя хоста (hostname) машины.
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2384 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2385
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2386 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2387 Возможно также указать пустое имя сервера (0.7.11):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2388 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2389 server {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2390 server_name www.example.com "";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2391 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2392 </example>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2393 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2394 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2395 Это настройка по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2396 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2397 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2398 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2399 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2400
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2401 <para>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2402 При поиске виртуального сервера по имени,
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2403 если имени соответствует несколько из указанных вариантов,
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2404 например, одновременно подходят и имя с маской, и регулярное выражение,
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2405 будет выбран первый подходящий вариант в следующем порядке приоритета:
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2406 <list type="enum">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2407
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2408 <listitem>
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2409 точное имя
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2410 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2411
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2412 <listitem>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2413 самое длинное имя с маской в начале,
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2414 например “<literal>*.example.com</literal>”
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2415 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2416
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2417 <listitem>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2418 самое длинное имя с маской в конце,
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2419 например “<literal>mail.*</literal>”
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2420 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2421
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2422 <listitem>
587
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2423 первое подходящее регулярное выражение
5bb7716cae7e Documented in more depth how server names are matched.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
2424 (в порядке следования в конфигурационном файле)
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2425 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2426
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2427 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2428 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2429
646
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2430 <para>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2431 Подробнее имена серверов обсуждаются в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2432 <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
2433 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive.
Vladimir Homutov <vl@nginx.com>
parents: 629
diff changeset
2434
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2435 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2436
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2437
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2438 <directive name="server_name_in_redirect">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2439 <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
2440 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2441 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2442 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2443 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2444
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2445 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2446 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2447 основное имя сервера, задаваемое директивой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2448 <link id="server_name"/>.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2449 Если использование основного имени сервера запрещено, то используется имя,
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2450 указанное в поле <header>Host</header> заголовка запроса.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2451 Если же этого поля нет, то используется IP-адрес сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2452 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2453
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2454 <para>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2455 Использование в перенаправлениях порта управляется
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2456 директивой <link id="port_in_redirect"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2457 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2458
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2459 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2460
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 name="server_names_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2463 <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
2464 <default>32|64|128</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2465 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2466
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2467 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2468 Задаёт размер корзины в хэш-таблицах имён серверов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2469 Значение по умолчанию зависит от размера строки кэша процессора.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2470 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2471 <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
2472 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2473
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2474 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2475
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2476
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2477 <directive name="server_names_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2478 <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
2479 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2480 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2481
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2482 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2483 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2484 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2485 <link doc="../hash.xml">документе</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2486 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2487
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2488 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2489
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2490
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2491 <directive name="server_tokens">
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2492 <syntax>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2493 <literal>on</literal> |
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2494 <literal>off</literal> |
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2495 <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
2496 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2497 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2498 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2499 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2500
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2501 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2502 Разрешает или запрещает выдавать версию nginx’а в сообщениях об ошибках и
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2503 в поле <header>Server</header> заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2504 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2505
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2506 <para>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2507 Дополнительно, как часть
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2508 <commercial_version>коммерческой подписки</commercial_version>,
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2509 начиная с версии 1.9.13
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2510 подписи в сообщениях об ошибках и
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2511 значение поля <header>Server</header> заголовка ответа
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2512 можно задать явно с помощью строки с переменными.
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2513 Пустая строка запрещает выдачу поля <header>Server</header>.
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2514 </para>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1665
diff changeset
2515
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2516 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2517
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2518
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2519 <directive name="tcp_nodelay">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2520 <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
2521 <default>on</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2522 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2523 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2524 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2525
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2526 <para>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2527 Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>.
1545
e66acc310eb6 Fixed typo in the Russian translation of tcp_nodelay.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1519
diff changeset
2528 Параметр включается только при переходе соединения в состояние keep-alive.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2529 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2530
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2531 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2532
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2533
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2534 <directive name="tcp_nopush">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2535 <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
2536 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2537 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2538 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2539 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2540
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2541 <para>
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2542 Разрешает или запрещает использование параметра сокета
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2543 <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
2544 <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
2545 Параметр включаются только при использовании <link id="sendfile"/>.
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
2546 Включение параметра позволяет
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2547 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2548
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2549 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2550 передавать заголовок ответа и начало файла в одном пакете
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2551 в Linux и во FreeBSD&nbsp;4.*;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2552 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2553
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2554 <listitem>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2555 передавать файл полными пакетами.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2556 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2557
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2558 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2559 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2560
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2561 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2564 <directive name="try_files">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2565 <syntax><value>файл</value> ... <value>uri</value></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2566 <syntax><value>файл</value> ... =<value>код</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
2567 <default/>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2568 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2569 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2570
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2571 <para>
253
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 для обработки запроса первый найденный файл, причём обработка
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
2574 делается в контексте этого же location’а.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2575 Путь к файлу строится из параметра <value>файл</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2576 в соответствии с директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2577 <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
2578 С помощью слэша в конце имени можно проверить существование каталога,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2579 например, “<literal>$uri/</literal>”.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2580 В случае, если ни один файл не найден, то делается внутреннее
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2581 перенаправление на <value>uri</value>, заданный последним параметром.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2582 Например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2583 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2584 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2585 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
2586 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2587
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2588 location = /images/default.gif {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2589 expires 30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2590 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2591 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2592 Последний параметр может также указывать на именованный location,
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2593 как в примерах ниже.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2594 С версии 0.7.51 последний параметр может также быть <value>кодом</value>:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2595 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2596 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2597 try_files $uri $uri/index.html $uri.html =404;
76
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 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2601
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2602 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2603 Пример использования при проксировании Mongrel:
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 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2606 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
2607 $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
2608 @mongrel;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2609 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2610
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2611 location @mongrel {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2612 proxy_pass http://mongrel;
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 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2615 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2616
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2617 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2618 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2619 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2620 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2621 try_files $uri $uri/ @drupal;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2622 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2623
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2624 location ~ \.php$ {
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 @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2626
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2627 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2628
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2629 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
2630 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
2631 fastcgi_param QUERY_STRING $args;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2632
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2633 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2634 }
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 location @drupal {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2637 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2638
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2639 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
2640 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
2641 fastcgi_param QUERY_STRING q=$uri&amp;$args;
76
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 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2644 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2645 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2646 В следующем примере директива <literal>try_files</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2647 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2648 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2649 try_files $uri $uri/ @drupal;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2650 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2651 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2652 аналогична директивам
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2653 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2654 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2655 error_page 404 = @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2656 log_not_found off;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2657 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2658 </example>
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 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2661 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2662 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2663
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2664 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2665
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2666 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2667
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2668 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2669 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2670 </example>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2671 <literal>try_files</literal> проверяет существование PHP-файла,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2672 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2673 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2674
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2675 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2676 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2677 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2678 location / {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2679 try_files $uri $uri/ @wordpress;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2680 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2681
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2682 location ~ \.php$ {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2683 try_files $uri @wordpress;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2684
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2685 fastcgi_pass ...;
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 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2688 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2689 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2690
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2691 location @wordpress {
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2692 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2693
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2694 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2695 ... прочие fastcgi_param
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2696 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2697 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2698 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2699
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2700 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2701
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2702
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2703 <directive name="types">
108
72524ae53106 Explicitly marked directives with the block syntax. Such directives will
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
2704 <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
2705 <default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2706 text/html html;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2707 image/gif gif;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2708 image/jpeg jpg;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
2709 </default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2710 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2711 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2712 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2713
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2714 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2715 Задаёт соответствие расширений имён файлов и MIME-типов ответов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2716 Расширения нечувствительны к регистру символов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2717 Одному MIME-типу может соответствовать несколько расширений, например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2718 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2719 types {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2720 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
2721 application/octet-stream deb;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2722 application/octet-stream dmg;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2723 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2724 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2725 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2726
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2727 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2728 Достаточно полная таблица соответствий входит в дистрибутив nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2729 и находится в файле <path>conf/mime.types</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2730 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2731
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2732 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 958
diff changeset
2733 Для того чтобы для определённого location’а для всех ответов
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2734 выдавался 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
2735 можно использовать следующее:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2736 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2737 location /download/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2738 types { }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2739 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
2740 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2741 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2742 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2743
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2744 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2745
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2746
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2747 <directive name="types_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2748 <syntax><value>размер</value></syntax>
1132
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2749 <default>64</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2750 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2751 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2752 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2753
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2754 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2755 Задаёт размер корзины в хэш-таблицах типов.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2756 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2757 <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
2758 <note>
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2759 До версии 1.5.13
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2760 значение по умолчанию зависело от размера строки кэша процессора.
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size".
Ruslan Ermilov <ru@nginx.com>
parents: 1108
diff changeset
2761 </note>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2762 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2763
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2764 </directive>
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2767 <directive name="types_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2768 <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
2769 <default>1024</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2770 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2771 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2772 <context>location</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>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2778 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2779
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2780 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2781
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 name="underscores_in_headers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2784 <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
2785 <default>off</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2786 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2787 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2788
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2789 <para>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2790 Разрешает или запрещает использование символов подчёркивания в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2791 полях заголовка запроса клиента.
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2792 Если использование символов подчёркивания запрещено, поля заголовка запроса, в
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
2793 именах которых есть подчёркивания,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2794 помечаются как недопустимые и подпадают под действие директивы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2795 <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
2796 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2797
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2798 <para>
1023
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2799 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2800 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2801 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448).
Maxim Dounin <mdounin@mdounin.ru>
parents: 971
diff changeset
2802 Указанное значение распространяется на все виртуальные серверы,
426
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2803 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2804 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
Ruslan Ermilov <ru@nginx.com>
parents: 419
diff changeset
2805
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2806 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2807
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2808
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2809 <directive name="variables_hash_bucket_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2810 <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
2811 <default>64</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2812 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2813
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2814 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2815 Задаёт размер корзины в хэш-таблице переменных.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2816 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2817 <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
2818 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2819
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2820 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2821
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2822
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2823 <directive name="variables_hash_max_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2824 <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
2825 <default>1024</default>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2826 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2827
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2828 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2829 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2830 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 651
diff changeset
2831 <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
2832 <note>
a0543e9213e7 New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents: 1097
diff changeset
2833 До версии 1.5.13 по умолчанию использовалось значение 512.
a0543e9213e7 New default value for the variables_hash_max_size directive.
Andrei Belov <defan@nginx.com>
parents: 1097
diff changeset
2834 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2835 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2836
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2837 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2838
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2839 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2840
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2841
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2842 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2843
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2844 <para>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2845 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 318
diff changeset
2846 переменные, имена которых совпадают с именами переменных веб-сервера Apache.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2847 Прежде всего, это переменные, представляющие из себя поля заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2848 запроса клиента, такие как <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
2849 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2850 Кроме того, есть и другие переменные:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2851 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2852
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2853 <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
2854 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2855 аргумент <value>имя</value> в строке запроса
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2856 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2857
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2858 <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
2859 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2860 аргументы в строке запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2861 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2862
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2863 <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
2864 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2865 адрес клиента в бинарном виде, длина значения всегда 4 байта
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2866 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2867
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2868 <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
2869 <tag-desc>
769
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2870 число байт, переданное клиенту, без учёта заголовка ответа;
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2871 переменная совместима с параметром “<literal>%B</literal>” модуля Apache
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2872 <literal>mod_log_config</literal>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2873 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2874
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2875 <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
2876 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2877 число байт, переданное клиенту (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
2878 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2879
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2880 <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
2881 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2882 порядковый номер соединения (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
2883 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2884
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2885 <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
2886 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
2887 текущее число запросов в соединении (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
2888 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2889
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2890 <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
2891 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2892 поле <header>Content-Length</header> заголовка запроса
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_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
2896 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2897 поле <header>Content-Type</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2898 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2899
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2900 <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
2901 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2902 cookie <value>имя</value>
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2903 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2904
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2905 <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
2906 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2907 значение директивы <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
2908 для текущего запроса
253
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_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
2912 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2913 то же, что и <var>$uri</var>
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
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2916 <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
2917 <tag-desc>
940
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2918 в порядке приоритета:
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2919 имя хоста из строки запроса, или
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2920 имя хоста из поля <header>Host</header> заголовка запроса, или
ded8f4a5de28 Corrected description of the $host variable.
Ruslan Ermilov <ru@nginx.com>
parents: 914
diff changeset
2921 имя сервера, соответствующего запросу
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2922 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2923
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2924 <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
2925 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2926 имя хоста
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2927 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2928
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2929 <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
2930 <tag-desc>
448
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2931 произвольное поле заголовка запроса;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2932 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
2933 к нижнему регистру, с заменой символов тире на символы подчёркивания
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2934 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2935
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2936 <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
2937 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2938 “<literal>on</literal>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2939 если соединение работает в режиме SSL,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2940 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2941 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2942
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2943 <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
2944 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
2945 “<literal>?</literal>”, если в строке запроса есть аргументы,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2946 и пустая строка, если их нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2947 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2948
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2949 <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
2950 <tag-desc>
767
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
2951 установка этой переменной позволяет ограничивать скорость
1bb8b733416a Clarified the description of the limit_rate directive
Ruslan Ermilov <ru@nginx.com>
parents: 741
diff changeset
2952 передачи ответа, см. <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
2953 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2954
771
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
2955 <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
2956 <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
2957 текущее время в секундах с точностью до миллисекунд (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
2958 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
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_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
2961 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2962 версия nginx
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_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
2966 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2967 номер (PID) рабочего процесса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2968 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2969
826
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
2970 <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
2971 <tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
2972 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
2973 (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
2974 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
2975
1097
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2976 <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
2977 <tag-desc>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2978 адрес клиента, полученный из заголовка протокола PROXY, либо пустая строка
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2979 (1.5.12)
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2980 <para>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2981 Протокол PROXY должен быть предварительно включён при помощи установки
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2982 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2983 </para>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2984 </tag-desc>
eeb690d4212b Documented the PROXY protocol support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1037
diff changeset
2985
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2986 <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
2987 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2988 то же, что и <var>$args</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2989 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2990
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2991 <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
2992 <tag-desc>
436
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2993 абсолютный путь, соответствующий
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2994 значению директивы <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
2995 для текущего запроса,
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive,
Ruslan Ermilov <ru@nginx.com>
parents: 431
diff changeset
2996 в котором все символические ссылки преобразованы в реальные пути
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2997 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
2998
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
2999 <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
3000 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3001 адрес клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3002 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3003
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3004 <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
3005 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3006 порт клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3007 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3008
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3009 <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
3010 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3011 имя пользователя, использованное в Basic аутентификации
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
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3014 <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
3015 <tag-desc>
431
0412333658fe Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents: 429
diff changeset
3016 первоначальная строка запроса целиком
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3017 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3018
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3019 <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
3020 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3021 тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3022 <para>
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 617
diff changeset
3023 Значение переменной появляется в location’ах, обрабатываемых
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3024 директивами
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
3025 <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
3026 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
3027 <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
3028 и
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
3029 <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
3030 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3031 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
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_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
3034 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3035 имя временного файла, в котором хранится тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3036 <para>
958
fd1f8e0a405e Text review of ngx_http_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 948
diff changeset
3037 По завершении обработки файл необходимо удалить.
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 958
diff changeset
3038 Для того чтобы тело запроса всегда записывалось в файл,
406
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them.
Ruslan Ermilov <ru@nginx.com>
parents: 400
diff changeset
3039 следует включить <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
3040 При передаче имени временного файла в проксированном запросе
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
3041 или в запросе к FastCGI/uwsgi/SCGI-серверу следует запретить передачу самого
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3042 тела директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3043 <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
3044 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
3045 <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
3046 fastcgi_pass_request_body off</link>,
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
3047 <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
3048 uwsgi_pass_request_body off</link>
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
3049 или
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1132
diff changeset
3050 <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
3051 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
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 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3055
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3056 <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
3057 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3058 “<literal>OK</literal>” если запрос завершился,
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3059 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3060 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3061
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3062 <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
3063 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3064 путь к файлу для текущего запроса, формируемый из директив
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3065 <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
3066 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3067
1692
4319f72f11f5 Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
3068 <tag-name id="var_request_id"><var>$request_id</var></tag-name>
4319f72f11f5 Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
3069 <tag-desc>
4319f72f11f5 Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
3070 уникальный идентификатор запроса (1.11.0)
4319f72f11f5 Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
3071 </tag-desc>
4319f72f11f5 Documented the $request_id variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
3072
826
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3073 <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
3074 <tag-desc>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3075 длина запроса (включая строку запроса, заголовок и тело запроса)
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3076 (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
3077 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3078
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3079 <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
3080 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3081 метод запроса, обычно
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3082 “<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
3083 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3084
771
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
3085 <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
3086 <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
3087 время обработки запроса в секундах с точностью до миллисекунд
32b8498cfb40 $msec and $request_time have become generic variables in 1.2.6.
Ruslan Ermilov <ru@nginx.com>
parents: 771
diff changeset
3088 (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
3089 время, прошедшее с момента чтения первых байт от клиента
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
3090 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9.
Ruslan Ermilov <ru@nginx.com>
parents: 769
diff changeset
3091
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3092 <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
3093 <tag-desc>
431
0412333658fe Consistent translation of "original".
Ruslan Ermilov <ru@nginx.com>
parents: 429
diff changeset
3094 первоначальный URI запроса целиком (с аргументами)
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3095 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3096
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3097 <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
3098 <tag-desc>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3099 схема запроса, “<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
3100 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3101
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3102 <tag-name id="var_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
3103 <tag-desc>
448
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
3104 произвольное поле заголовка ответа;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
3105 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax.
Ruslan Ermilov <ru@nginx.com>
parents: 442
diff changeset
3106 к нижнему регистру, с заменой символов тире на символы подчёркивания
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3107 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3108
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3109 <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
3110 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3111 адрес сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3112 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3113 Получение значения этой переменной обычно требует одного системного вызова.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3114 Чтобы избежать системного вызова, в директивах <link id="listen"/>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
3115 следует указывать адреса и использовать параметр <literal>bind</literal>.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3116 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3117 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3118
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3119 <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
3120 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3121 имя сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3122 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3123
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3124 <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
3125 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3126 порт сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3127 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3128
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3129 <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
3130 <tag-desc>
1597
8b97ba73129b Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1576
diff changeset
3131 протокол запроса, обычно
8b97ba73129b Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1576
diff changeset
3132 “<literal>HTTP/1.0</literal>”,
8b97ba73129b Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1576
diff changeset
3133 “<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
3134 или
1597
8b97ba73129b Added HTTP/2.0 to the "server_protocol" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1576
diff changeset
3135 “<link doc="ngx_http_v2_module.xml">HTTP/2.0</link>”
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3136 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3137
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3138 <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
3139 <tag-desc>
769
d71e56d56ada Documented variables relocations between http log and core modules.
Vladimir Homutov <vl@nginx.com>
parents: 768
diff changeset
3140 статус ответа (1.3.2, 1.2.2)
541
a8971cf346be Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents: 537
diff changeset
3141 </tag-desc>
a8971cf346be Documented the $status core variable.
Andrey Belov <defan@nginx.com>
parents: 537
diff changeset
3142
826
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3143 <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
3144 <tag-desc>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3145 локальное время в формате по стандарту 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
3146 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3147
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3148 <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
3149 <tag-desc>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 835
diff changeset
3150 локальное время в 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
3151 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local.
Ruslan Ermilov <ru@nginx.com>
parents: 810
diff changeset
3152
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3153 <tag-name id="var_tcpinfo_">
453
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3154 <var>$tcpinfo_rtt</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3155 <var>$tcpinfo_rttvar</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3156 <var>$tcpinfo_snd_cwnd</var>,
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3157 <var>$tcpinfo_rcv_space</var>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3158 </tag-name>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3159 <tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3160 информация о клиентском TCP-соединении; доступна на системах,
617
368a449e85b8 Expanded documentation of what various parameters of the "listen"
Ruslan Ermilov <ru@nginx.com>
parents: 615
diff changeset
3161 поддерживающих параметр сокета <c-def>TCP_INFO</c-def>
453
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3162 </tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables.
Ruslan Ermilov <ru@nginx.com>
parents: 448
diff changeset
3163
768
f63b7fa3bf17 Added "id" attributes to http core module variables.
Vladimir Homutov <vl@nginx.com>
parents: 767
diff changeset
3164 <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
3165 <tag-desc>
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3166 текущий 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
3167 <para>
503
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3168 Значение <var>$uri</var> может изменяться в процессе обработки запроса,
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3169 например, при внутренних перенаправлениях
aed015c3dedd Documented URI normalization rules, including %-decoding.
Ruslan Ermilov <ru@nginx.com>
parents: 499
diff changeset
3170 или при использовании индексных файлов.
253
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3171 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
3172 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3173
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3174 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3175 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3176
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3177 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3178
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3179 </module>