nginx-site: xml/ru/docs/http/ngx_http_core

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 2976:cbd963190c15

Documented the http2 directive.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Tue, 13 Jun 2023 16:04:45 +0100
parents	9a8d15333a58
children	9eadb98ec770

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"
2976 cbd963190c15 Documented the http2 directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2972 diff changeset	13 rev="106">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	15 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16
1879 3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	17 <directive name="absolute_redirect">
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	18 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	19 <default>on</default>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	20 <context>http</context>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	21 <context>server</context>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	22 <context>location</context>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	23 <appeared-in>1.11.8</appeared-in>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	24
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	25 <para>
1881 ce0190c094ba Fixed grammar and sigle quote in absolute_redirect. Yaroslav Zhuravlev <yar@nginx.com> parents: 1879 diff changeset	26 Если запрещено, то перенаправления, выдаваемые nginx’ом, будут относительными.
1879 3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	27 </para>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	28
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	29 <para>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	30 См. также директивы <link id="server_name_in_redirect"/>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	31 и <link id="port_in_redirect"/>.
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	32 </para>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	33
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	34 </directive>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	35
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	36
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	37 <directive name="aio">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	38 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	39 <literal>on</literal> \|
1436 2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	40 <literal>off</literal> \|
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	41 <literal>threads</literal>[<literal>=</literal><value>pool</value>]</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	42 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	43 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	44 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	45 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	46 <appeared-in>0.8.11</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	47
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	48 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	49 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO)
1432 9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	50 во FreeBSD и Linux:
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	51 <example>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	52 location /video/ {
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	53 aio on;
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	54 output_buffers 1 64k;
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	55 }
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	56 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	57 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	58
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	59 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	60 Во FreeBSD AIO можно использовать, начиная с FreeBSD 4.3.
1859 5cd4964fbc5f Updated AIO description for FreeBSD 11.0 and upwards. Sergey Kandaurov <pluknet@nginx.com> parents: 1827 diff changeset	61 До FreeBSD 11.0
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	62 AIO можно либо собрать в ядре статически:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	63 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	64 options VFS_AIO
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	65 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	66 либо загрузить динамически через загружаемый модуль ядра:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	67 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	68 kldload aio
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	69 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	71
1430 0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	72 <!--
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	74 В версиях FreeBSD 5 и 6 включение AIO статически или динамически
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	75 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	76 будет использовать блокировку Giant, что может негативно сказаться на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	77 производительности системы в целом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	78 Это ограничение устранено во FreeBSD 6.4-STABLE в 2009 году
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	79 и во FreeBSD 7.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	80 Однако, начиная с FreeBSD 5.3 есть возможность включать AIO,
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	81 не связывая сетевую подсистему блокировкой Giant — для этого модуль
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	82 AIO нужно подгружать уже после загрузки ядра.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	83 В этом случае в <path>/var/log/messages</path> появится следующее сообщение:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	84 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	85 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	86 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	87 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	88 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89 <note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	90 Требование использовать блокировку Giant в AIO связано с тем, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	91 FreeBSD поддерживает асинхронные вызовы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	92 <c-func>aio_read</c-func>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	93 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	94 <c-func>aio_write</c-func>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	95 для работы с сокетами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	96 Но поскольку nginx использует AIO только для работы с диском,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	97 то проблем не возникает.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	98 </note>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99 </para>
1430 0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	100 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	102 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	103 В Linux AIO можно использовать только начиная с версии ядра 2.6.22.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	104 Кроме того, необходимо также дополнительно включить
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	105 <link id="directio"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	106 иначе чтение будет блокирующимся:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	107 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	108 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	109 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	110 directio 512;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	111 output_buffers 1 128k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	112 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	113 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	114 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	117 В Linux
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	118 <link id="directio"/>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	119 можно использовать только для чтения блоков, выравненных
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	120 на границу 512 байт (или 4К для XFS).
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	121 Невыравненный конец файла будет читаться блокированно.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	122 То же относится к запросам с указанием диапазона запрашиваемых байт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	123 (byte-range requests) и к запросам FLV не с начала файла: чтение
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	124 невыравненных начала и конца ответа будет блокирующимся.
1430 0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	125 </para>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	126
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	127 <para>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	128 При одновременном включении AIO и <link id="sendfile"/> в Linux
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	129 для файлов, размер которых больше либо равен указанному
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	130 в директиве <link id="directio"/>, будет использоваться AIO,
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	131 а для файлов меньшего размера
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	132 или при выключенном <link id="directio"/> — <link id="sendfile"/>:
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	133 <example>
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	134 location /video/ {
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	135 sendfile on;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	136 aio on;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	137 directio 8m;
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	138 }
0eb8e261f349 AIO: clarified the use of both AIO and sendfile on Linux. Ruslan Ermilov <ru@nginx.com> parents: 1279 diff changeset	139 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	140 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	141
1432 9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	142 <para>
1436 2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	143 Кроме того, читать и <link id="sendfile">отправлять</link>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	144 файлы можно в многопоточном режиме (1.7.11),
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 <example>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	147 location /video/ {
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	148 sendfile on;
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	149 aio threads;
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	150 }
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	151 </example>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	152 Операции чтения или отправки файлов будут обрабатываться потоками из указанного
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	153 <link doc="../ngx_core_module.xml" id="thread_pool">пула</link>.
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	154 Если пул потоков не задан явно,
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	155 используется пул с именем “<literal>default</literal>”.
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	156 Имя пула может быть задано при помощи переменных:
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	157 <example>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	158 aio threads=pool$disk;
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	159 </example>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	160 По умолчанию поддержка многопоточности выключена, её сборку следует
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	161 разрешить с помощью конфигурационного параметра
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	162 <literal>--with-threads</literal>.
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	163 В настоящий момент многопоточность совместима только с методами
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	164 <link doc="../events.xml" id="epoll"/>,
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	165 <link doc="../events.xml" id="kqueue"/>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	166 и
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	167 <link doc="../events.xml" id="eventport"/>.
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	168 Отправка файлов в многопоточном режиме поддерживается только на Linux.
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	169 </para>
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	170
2333e08e277d Documented thread pools. Ruslan Ermilov <ru@nginx.com> parents: 1432 diff changeset	171 <para>
1432 9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	172 См. также директиву <link id="sendfile"/>.
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	173 </para>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	174
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	175 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	176
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	177
1664 1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	178 <directive name="aio_write">
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	179 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	180 <default>off</default>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	181 <context>http</context>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	182 <context>server</context>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	183 <context>location</context>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	184 <appeared-in>1.9.13</appeared-in>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	185
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	186 <para>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	187 При включённом <link id="aio"/> разрешает его использование для записи файлов.
1665 57b53a0818df Slightly paraphrased aio_write description for better perception. Ruslan Ermilov <ru@nginx.com> parents: 1664 diff changeset	188 В настоящий момент это работает только при использовании
1664 1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	189 <literal>aio threads</literal>
1665 57b53a0818df Slightly paraphrased aio_write description for better perception. Ruslan Ermilov <ru@nginx.com> parents: 1664 diff changeset	190 и ограничено записью временных файлов с данными,
1664 1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	191 полученными от проксируемых серверов.
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	192 </para>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	193
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	194 </directive>
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	195
1a05fd32dca8 Documented the "aio_write" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1636 diff changeset	196
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	197 <directive name="alias">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	198 <syntax><value>путь</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	199 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	200 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	201
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	202 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	203 Задаёт замену для указанного location’а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	204 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	205 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	206 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	207 alias /data/w3/images/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	208 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	209 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	210 на запрос
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	211 “<literal>/i/top.gif</literal>” будет отдан файл
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	212 <path>/data/w3/images/top.gif</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	213 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	214
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	215 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	216 В значении параметра <value>путь</value> можно использовать переменные,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	217 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	218 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	220 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	221 Если <literal>alias</literal> используется внутри location’а, заданного
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	222 регулярным выражением, то регулярное выражение должно содержать
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	223 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	224 (0.7.40), например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	225 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226 location ~ ^/users/(.+\.(?:gif\|jpe?g\|png))$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	227 alias /data/w3/images/$1;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	228 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	229 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	230 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	231
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	232 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	233 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	234 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	235 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	236 alias /data/w3/images/;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	237 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	238 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	239 то лучше воспользоваться директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	240 <link id="root"/>:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	241 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	242 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	243 root /data/w3;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	244 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	245 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	246 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	247
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	248 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	249
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	250
2523 2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	251 <directive name="auth_delay">
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	252 <syntax><value>время</value></syntax>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	253 <default>0s</default>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	254 <context>http</context>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	255 <context>server</context>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	256 <context>location</context>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	257 <appeared-in>1.17.10</appeared-in>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	258
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	259 <para>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	260 Задерживает обработку неавторизованных запросов с кодом ответа 401
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	261 для предотвращения атак по времени в случае ограничения доступа по
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	262 <link doc="ngx_http_auth_basic_module.xml">паролю</link>, по
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	263 <link doc="ngx_http_auth_request_module.xml">результату подзапроса</link>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	264 или по <link doc="ngx_http_auth_jwt_module.xml">JWT</link>.
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	265 </para>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	266
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	267 </directive>
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	268
2bb06b3fbcc5 Documented the "auth_delay" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2458 diff changeset	269
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	270 <directive name="chunked_transfer_encoding">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	271 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	272 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	273 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	274 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	275 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	276
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	277 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	278 Позволяет запретить формат передачи данных частями (chunked transfer
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	279 encoding) в HTTP/1.1.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	280 Это может понадобиться при использовании программ, не поддерживающих
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	281 chunked encoding, несмотря на требования стандарта.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	282 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	283
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	284 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	285
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	286
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	287 <directive name="client_body_buffer_size">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	288
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	289 <syntax><value>размер</value></syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	290 <default>8k\|16k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	291 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	292 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	293 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	294
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	295 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	296 Задаёт размер буфера для чтения тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	297 Если тело запроса больше заданного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	298 то всё тело запроса или только его часть записывается во
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	299 <link id="client_body_temp_path">временный файл</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	300 По умолчанию размер одного буфера равен двум размерам страницы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	301 На x86, других 32-битных платформах и x86-64 это 8K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	302 На других 64-битных платформах это обычно 16K.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	303 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	304
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	305 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	306
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	307
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	308 <directive name="client_body_in_file_only">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	309 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	310 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	311 <literal>clean</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	312 <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	313 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	314 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	315 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	316 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	317
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	318 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	319 Определяет, сохранять ли всё тело запроса клиента в файл.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	320 Директиву можно использовать для отладки и при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	321 <var>$request_body_file</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	322 или метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	323 <link doc="ngx_http_perl_module.xml" id="methods">$r->request_body_file</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	324 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	325 <link doc="ngx_http_perl_module.xml">ngx_http_perl_module</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	326 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	327
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	328 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	329 При установке значения <literal>on</literal> временные файлы
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	330 по окончании обработки запроса не удаляются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	331 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	332
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	333 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	334 Значение <literal>clean</literal> разрешает удалять временные файлы,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	335 оставшиеся по окончании обработки запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	336 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	337
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	338 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	339
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	340
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	341 <directive name="client_body_in_single_buffer">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	342 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	343 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	344 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	345 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	346 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	347
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	348 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	349 Определяет, сохранять ли всё тело запроса клиента в одном буфере.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	350 Директива рекомендуется при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	351 <var>$request_body</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	352 для уменьшения требуемого числа операций копирования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	353 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	354
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	355 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	356
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	357
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	358 <directive name="client_body_temp_path">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	359 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	360 <value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	361 [<value>уровень1</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	362 [<value>уровень2</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	363 [<value>уровень3</value>]]]</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	364 <default>client_body_temp</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	365 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	366 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	367 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	368
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	369 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	370 Задаёт каталог для хранения временных файлов с телами запросов клиентов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	371 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	372 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	373 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	374 client_body_temp_path /spool/nginx/client_temp 1 2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	375 </example>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	376 путь к временному файлу будет следующего вида:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	377 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	378 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	379 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	380 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	381
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	382 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	383
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	384
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	385 <directive name="client_body_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	386 <syntax><value>время</value></syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	387 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	388 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	389 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	390 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	391
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	392 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	393 Задаёт таймаут при чтении тела запроса клиента.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	394 Таймаут устанавливается не на всю передачу тела запроса,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	395 а только между двумя последовательными операциями чтения.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	396 Если по истечении этого времени клиент ничего не передаст,
2220 896562a1ccde Fixed description of client_header_timeout and client_body_timeout. Sergey Kandaurov <pluknet@nginx.com> parents: 2206 diff changeset	397 обработка запроса прекращается с ошибкой
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	398 <http-status code="408" text="Request Time-out"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	399 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	400
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	401 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	402
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	403
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	404 <directive name="client_header_buffer_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	405 <syntax><value>размер</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	406 <default>1k</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	407 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	408 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	409
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	410 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	411 Задаёт размер буфера для чтения заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	412 Для большинства запросов достаточно буфера размером в 1K байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	413 Однако если в запросе есть длинные cookies, или же запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	414 пришёл от WAP-клиента, то он может не поместиться в 1K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	415 Поэтому, если строка запроса или поле заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	416 не помещаются полностью в этот буфер, то выделяются буферы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	417 большего размера, задаваемые директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	418 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	419 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	420
2795 691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	421 <para>
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	422 Если директива указана на уровне <link id="server"/>,
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	423 то может использоваться значение из сервера по умолчанию.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	424 Подробнее см. в разделе
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	425 “<link doc="server_names.xml" id="virtual_server_selection">Выбор
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	426 виртуального сервера</link>”.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	427 </para>
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	428
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	429 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	430
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	431
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	432 <directive name="client_header_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	433 <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	434 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	435 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	436 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	437
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	438 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	439 Задаёт таймаут при чтении заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	440 Если по истечении этого времени клиент не передаст полностью заголовок,
2220 896562a1ccde Fixed description of client_header_timeout and client_body_timeout. Sergey Kandaurov <pluknet@nginx.com> parents: 2206 diff changeset	441 обработка запроса прекращается с ошибкой
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	442 <http-status code="408" text="Request Time-out"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	443 </para>
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	446
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	447
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	448 <directive name="client_max_body_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	449 <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	450 <default>1m</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	451 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	452 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	453 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	454
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	455 <para>
2657 679fb7712ab4 Updated client_max_body_size for chunked encoding and HTTP/2. Sergey Kandaurov <pluknet@nginx.com> parents: 2593 diff changeset	456 Задаёт максимально допустимый размер тела запроса клиента.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	457 Если размер больше заданного, то клиенту возвращается ошибка
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	458 <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	459 Следует иметь в виду, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	460 <!--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	461 эту ошибку<!--/link-->.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	462 Установка параметра <value>размер</value> в 0 отключает
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	463 проверку размера тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	464 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	465
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	466 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	467
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	468
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	469 <directive name="connection_pool_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	470 <syntax><value>размер</value></syntax>
1619 88ad8fcea975 Changed default value of connection_pool_size. Yaroslav Zhuravlev <yar@nginx.com> parents: 1597 diff changeset	471 <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	472 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	473 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	474
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	475 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	476 Позволяет производить точную настройку выделения памяти
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	477 под конкретные соединения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	478 Эта директива не оказывает существенного влияния на
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	479 производительность, и её не следует использовать.
1619 88ad8fcea975 Changed default value of connection_pool_size. Yaroslav Zhuravlev <yar@nginx.com> parents: 1597 diff changeset	480 По умолчанию размер равен
88ad8fcea975 Changed default value of connection_pool_size. Yaroslav Zhuravlev <yar@nginx.com> parents: 1597 diff changeset	481 256 байт на 32-битных платформах и 512 байт на 64-битных платформах.
88ad8fcea975 Changed default value of connection_pool_size. Yaroslav Zhuravlev <yar@nginx.com> parents: 1597 diff changeset	482 <note>
88ad8fcea975 Changed default value of connection_pool_size. Yaroslav Zhuravlev <yar@nginx.com> parents: 1597 diff changeset	483 До версии 1.9.8 по умолчанию использовалось значение 256 на всех платформах.
88ad8fcea975 Changed default value of connection_pool_size. Yaroslav Zhuravlev <yar@nginx.com> parents: 1597 diff changeset	484 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	485 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	488
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	489
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	490 <directive name="default_type">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	491 <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	492 <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	493 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	494 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	495 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	496
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	497 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	498 Задаёт MIME-тип ответов по умолчанию.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	499 Соответствие расширений имён файлов MIME-типу ответов задаётся
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	500 с помощью директивы <link id="types"/>.
76 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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	506 <directive name="directio">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	507 <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	508 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	509 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	510 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	511 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	512 <appeared-in>0.7.7</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	513
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	514 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	515 Разрешает использовать флаги
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	516 <c-def>O_DIRECT</c-def> (FreeBSD, Linux),
1911 f024ac0ec5c7 Apple rebranded Mac OS X to macOS. Sergey Kandaurov <pluknet@nginx.com> parents: 1904 diff changeset	517 <c-def>F_NOCACHE</c-def> (macOS)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	518 или функцию <c-func>directio</c-func> (Solaris)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	519 при чтении файлов, размер которых больше либо равен указанному.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	520 Директива автоматически запрещает (0.7.15) использование
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	521 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	522 для данного запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	523 Рекомендуется использовать для больших файлов:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	524 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	525 directio 4m;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	526 </example>
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	527 или при использовании <link id="aio"/> в Linux.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	528 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	529
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	530 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	531
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	532
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	533 <directive name="directio_alignment">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	534 <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	535 <default>512</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	536 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	537 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	538 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	539 <appeared-in>0.8.11</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	540
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	541 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	542 Устанавливает выравнивание для
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	543 <link id="directio"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	544 В большинстве случаев достаточно 512-байтового выравнивания, однако
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	545 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	546 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	547
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	548 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	549
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	550
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	551 <directive name="disable_symlinks">
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	552 <syntax><literal>off</literal></syntax>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	553 <syntax>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	554 <literal>on</literal> \|
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	555 <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	556 [<literal>from</literal>=<value>часть</value>]</syntax>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	557 <default>off</default>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	558 <context>http</context>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	559 <context>server</context>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	560 <context>location</context>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	561 <appeared-in>1.1.15</appeared-in>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	562
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	563 <para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	564 Определяет, как следует поступать с символическими ссылками
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	565 при открытии файлов:
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	566 <list type="tag">
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	567
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	568 <tag-name><literal>off</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	569 <tag-desc>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	570 Символические ссылки в пути допускаются и не проверяются.
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	571 Это стандартное поведение.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	572 </tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	573
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	574 <tag-name><literal>on</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	575 <tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	576 Если любой компонент пути является символической ссылкой,
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	577 доступ к файлу запрещается.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	578 </tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	579
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	580 <tag-name><literal>if_not_owner</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	581 <tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	582 Доступ к файлу запрещается, если любой компонент пути
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	583 является символической ссылкой, а ссылка и объект, на
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	584 который она ссылается, имеют разных владельцев.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	585 </tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	586
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	587 <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	588 <tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	589 При проверке символических ссылок
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	590 (параметры <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	591 обычно проверяются все компоненты пути.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	592 Можно не проверять символические ссылки в начальной части пути,
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	593 указав дополнительно параметр
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	594 <literal>from</literal>=<value>часть</value>.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	595 В этом случае символические ссылки проверяются лишь начиная
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	596 с компонента пути, который следует за заданной начальной частью.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	597 Если значение не является начальной частью проверяемого пути,
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	598 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	599 Если значение целиком совпадает с именем файла,
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	600 символические ссылки не проверяются.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	601 В значении параметра можно использовать переменные.
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	602 </tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	603
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	604 </list>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	605 </para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	606
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	607 <para>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	608 Пример:
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	609 <example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	610 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	611 </example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	612 </para>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	613
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	614 <para>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	615 Эта директива доступна только на системах, в которых есть
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	616 интерфейсы <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	617 К таким системам относятся современные версии FreeBSD, Linux и Solaris.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	618 </para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	619
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	620 <para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	621 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	622 требуют дополнительных затрат на обработку.
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	623 <note>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	624 На системах, не поддерживающих операцию открытия каталогов только для поиска,
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	625 для использования этих параметров требуется, чтобы рабочие процессы
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	626 имели право читать все проверяемые каталоги.
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	627 </note>
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	628 </para>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	629
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	630 <para>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	631 <note>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	632 Модули
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	633 <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	634 <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	635 и <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	636 в настоящий момент игнорируют эту директиву.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	637 </note>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	638 </para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	639
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	640 </directive>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	641
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	642
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	643 <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	644 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	645 <value>код</value> ...
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	646 [<literal>=</literal>[<value>ответ</value>]]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	647 <value>uri</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	648 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	649 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	650 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	651 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	652 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	653
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	654 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	655 Задаёт URI, который будет показываться для указанных ошибок.
1826 da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	656 В значении <value>uri</value> можно использовать переменные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	657 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	658
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	659 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	660 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	661 <example>
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	662 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	663 error_page 500 502 503 504 /50x.html;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	664 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	665 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	666
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	667 <para>
1827 64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	668 При этом делается внутреннее перенаправление на указанный <value>uri</value>,
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	669 а метод запроса клиента меняется на “<literal>GET</literal>”
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	670 (для всех методов, отличных от
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	671 “<literal>GET</literal>” и “<literal>HEAD</literal>”).
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	672 </para>
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	673
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	674 <para>
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	675 Кроме того, можно поменять код ответа на другой,
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	676 используя синтаксис вида “<literal>=</literal><value>ответ</value>”, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	677 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	678 error_page 404 =200 /empty.gif;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	679 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	680 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	681
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	682 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	683 Если ошибочный ответ обрабатывается проксированным сервером или
2134 4cafd82e5007 Added info about gRPC to various modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2125 diff changeset	684 FastCGI/uwsgi/SCGI/gRPC-сервером,
4cafd82e5007 Added info about gRPC to various modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2125 diff changeset	685 и этот сервер может вернуть разные коды ответов,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	686 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	687 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	688 error_page 404 = /404.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	689 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	690 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	691
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	692 <para>
1827 64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	693 Если при внутреннем перенаправлении не нужно менять URI и метод,
64e2b8c5200d Documented request method change by error_page in /uri redirection. Ruslan Ermilov <ru@nginx.com> parents: 1826 diff changeset	694 то можно передать обработку ошибки в именованный location:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	695 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	696 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	697 error_page 404 = @fallback;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	698 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	699
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	700 location @fallback {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	701 proxy_pass http://backend;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	702 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	703 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	704 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	705
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	706 <para>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	707 <note>
1826 da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	708 Если при обработке <value>uri</value> происходит ошибка,
948 2b0731e3adc9 Slightly fixed wording. Ruslan Ermilov <ru@nginx.com> parents: 941 diff changeset	709 клиенту возвращается ответ с кодом последней случившейся ошибки.
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	710 </note>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	711 </para>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	712
1826 da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	713 <para>
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	714 Также существует возможность использовать перенаправления URL для обработки
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	715 ошибок:
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	716 <example>
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	717 error_page 403 http://example.com/forbidden.html;
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	718 error_page 404 =301 http://example.com/notfound.html;
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	719 </example>
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	720 В этом случае по умолчанию клиенту возвращается код ответа 302.
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	721 Его можно изменить только на один из кодов ответа, относящихся к
1964 2a3c58dcb3e8 Documented support for the 308 Permanent Redirect. Yaroslav Zhuravlev <yar@nginx.com> parents: 1953 diff changeset	722 перенаправлениям (301, 302, 303, 307 и 308).
2039 d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	723 <note>
d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	724 До версий 1.1.16 и 1.0.13 код 307 не обрабатывался как перенаправление.
d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	725 </note>
d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	726
d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	727 <note>
d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	728 До версии 1.13.0 код 308 не обрабатывался как перенаправление.
d2969b2f69ae Added history notes about codes 201, 307, and 308. Yaroslav Zhuravlev <yar@nginx.com> parents: 2036 diff changeset	729 </note>
1826 da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	730 </para>
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	731
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	732 <para>
2593 eeed494bba51 Unified phrases about configuration levels and inheritance. Ruslan Ermilov <ru@nginx.com> parents: 2567 diff changeset	733 Директивы наследуются с предыдущего уровня конфигурации при условии, что
eeed494bba51 Unified phrases about configuration levels and inheritance. Ruslan Ermilov <ru@nginx.com> parents: 2567 diff changeset	734 на данном уровне не описаны свои директивы <literal>error_page</literal>.
1826 da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	735 </para>
da6a3e401b26 Slightly reformatted the error_page description. Ruslan Ermilov <ru@nginx.com> parents: 1770 diff changeset	736
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	737 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	738
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	739
576 cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	740 <directive name="etag">
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	741 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	742 <default>on</default>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	743 <context>http</context>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	744 <context>server</context>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	745 <context>location</context>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	746 <appeared-in>1.3.3</appeared-in>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	747
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	748 <para>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	749 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	750 заголовка ответа для статических ресурсов.
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	751 </para>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	752
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	753 </directive>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	754
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	755
651 eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	756 <directive name="http">
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	757 <syntax block="yes"/>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	758 <default/>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	759 <context>main</context>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	760
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	761 <para>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	762 Предоставляет контекст конфигурационного файла, в котором указываются
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	763 директивы HTTP-сервера.
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	764 </para>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	765
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	766 </directive>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	767
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	768
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	769 <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	770 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	771 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	772 <literal>exact</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	773 <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	774 <default>exact</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	775 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	776 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	777 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	778 <appeared-in>0.7.24</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	779
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	780 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	781 Определяет, как сравнивать время модификации ответа с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	782 временем в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	783 <header>If-Modified-Since</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	784 заголовка запроса:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	785
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	786 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	787
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	788 <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	789 <tag-desc>
2921 52ea1f45b324 Clarified "if_modified_since off" behaviour (ticket #2176). Maxim Dounin <mdounin@mdounin.ru> parents: 2912 diff changeset	790 ответ всегда считается изменившимся (0.7.34);
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	791 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	792
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	793 <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	794 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	795 точное совпадение;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	796 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	797
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	798 <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	799 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	800 время модификации ответа меньше или равно времени, заданному в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	801 <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	802 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	803
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	804 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	805 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	806
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	807 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	808
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	809
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	810 <directive name="ignore_invalid_headers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	811 <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	812 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	813 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	814 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	815
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	816 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	817 Если включено, nginx игнорирует поля заголовка с недопустимыми именами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	818 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	819 и возможно знаков подчёркивания (последнее контролируется директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	820 <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	821 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	822
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	823 <para>
1023 375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	824 Если директива указана на уровне <link id="server"/>,
2795 691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	825 то может использоваться значение из сервера по умолчанию.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	826 Подробнее см. в разделе
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	827 “<link doc="server_names.xml" id="virtual_server_selection">Выбор
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	828 виртуального сервера</link>”.
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	829 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	830
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	831 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	832
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	833
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	834 <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	835 <syntax/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	836 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	837 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	838
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	839 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	840 Указывает, что location может использоваться только для внутренних запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	841 Для внешних запросов клиенту будет возвращаться ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	842 <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	843 Внутренними запросами являются:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	844
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	845 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	846
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	847 <listitem>
429 2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	848 запросы, перенаправленные директивами
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	849 <link id="error_page"/>,
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	850 <link doc="ngx_http_index_module.xml" id="index"/>,
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	851 <link doc="ngx_http_internal_redirect_module.xml" id="internal_redirect"/>,
429 2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	852 <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	853 <link id="try_files"/>;
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	854 </listitem>
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	855
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	856 <listitem>
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	857 запросы, перенаправленные с помощью поля
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	858 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	859 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	860
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	861 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	862 подзапросы, формируемые командой
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	863 “<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	864 модуля
2036 ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	865 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>,
ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	866 директивами модуля
ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	867 <link doc="ngx_http_addition_module.xml">ngx_http_addition_module</link>,
ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	868 а также директивами
ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	869 <link doc="ngx_http_auth_request_module.xml" id="auth_request"/> и
ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	870 <link doc="ngx_http_mirror_module.xml" id="mirror"/>;
ee0aeddbe8a2 Updated types of subrequests allowed in the internal location. Sergey Kandaurov <pluknet@nginx.com> parents: 2003 diff changeset	871
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	872 </listitem>
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 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	875 запросы, изменённые директивой
429 2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	876 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	877 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	878
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	879 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	880 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	881
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	882 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	883 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	884 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	885 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	886
2206 5cacd6fffade Eliminated some examples of unsafe prefix locations. Ruslan Ermilov <ru@nginx.com> parents: 2199 diff changeset	887 location = /404.html {
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	888 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	889 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	890 </example>
674 c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	891 <note>
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	892 Для предотвращения зацикливания, которое может возникнуть при
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	893 использовании некорректных конфигураций, количество внутренних
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	894 перенаправлений ограничено десятью.
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	895 По достижении этого ограничения будет возвращена ошибка
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	896 <http-status code="500" text="Internal Server Error"/>.
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	897 В таком случае в лог-файле ошибок можно увидеть сообщение
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	898 “rewrite or internal redirection cycle”.
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	899 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	900 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	901
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	902 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	903
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	904
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	905 <directive name="keepalive_disable">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	906 <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	907 <default>msie6</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	908 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	909 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	910 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	911
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	912 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	913 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	914 Параметры <value>браузер</value> указывают, на какие браузеры это
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	915 распространяется.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	916 Значение <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	917 со старыми версиями MSIE после получения запроса POST.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	918 Значение <literal>safari</literal> запрещает keep-alive соединения
1911 f024ac0ec5c7 Apple rebranded Mac OS X to macOS. Sergey Kandaurov <pluknet@nginx.com> parents: 1904 diff changeset	919 с Safari и подобными им браузерами на macOS и подобных ей ОС.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	920 Значение <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	921 со всеми браузерами.
467 c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	922 <note>
c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	923 До версии 1.1.18 под значение <literal>safari</literal> подпадали
549 ab1449e0573b Typo fixed. Andrey Belov <defan@nginx.com> parents: 541 diff changeset	924 все Safari и подобные им браузеры на всех ОС, и keep-alive
467 c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	925 соединения с ними были по умолчанию запрещены.
c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	926 </note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	927 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	928
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	929 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	930
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	931
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	932 <directive name="keepalive_requests">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	933 <syntax><value>число</value></syntax>
2706 4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	934 <default>1000</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	935 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	936 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	937 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	938 <appeared-in>0.8.0</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	939
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	940 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	941 Задаёт максимальное число запросов, которые можно
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	942 сделать по одному keep-alive соединению.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	943 После того, как сделано максимальное число запросов,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	944 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	945 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	946
2450 a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	947 <para>
a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	948 Периодическое закрытие соединений необходимо для освобождения
a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	949 памяти, выделенной под конкретные соединения.
a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	950 Поэтому использование слишком большого максимального числа запросов
a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	951 может приводить к чрезмерному потреблению памяти и не рекомендуется.
a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	952 </para>
a26a42699207 Added note about max number of keepalive requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2424 diff changeset	953
2706 4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	954 <para>
4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	955 <note>
4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	956 До версии 1.19.10 по умолчанию использовалось значение 100.
4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	957 </note>
4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	958 </para>
4f44386a16b1 Changed default value of keepalive_requests. Yaroslav Zhuravlev <yar@nginx.com> parents: 2705 diff changeset	959
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	960 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	961
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	962
2705 06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	963 <directive name="keepalive_time">
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	964 <syntax><value>время</value></syntax>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	965 <default>1h</default>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	966 <context>http</context>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	967 <context>server</context>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	968 <context>location</context>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	969 <appeared-in>1.19.10</appeared-in>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	970
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	971 <para>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	972 Ограничивает максимальное время, в течение которого
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	973 могут обрабатываться запросы в рамках keep-alive соединения.
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	974 По достижении заданного времени соединение закрывается
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	975 после обработки очередного запроса.
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	976 </para>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	977
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	978 </directive>
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	979
06805824d0f0 Documented the keepalive_time directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2657 diff changeset	980
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	981 <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	982 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	983 <value>таймаут</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	984 [<value>заголовок_таймаута</value>]</syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	985 <default>75s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	986 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	987 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	988 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	989
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	990 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	991 Первый параметр задаёт таймаут, в течение которого keep-alive
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	992 соединение с клиентом не будет закрыто со стороны сервера.
835 e0263d44a59b Http core: documented "keepalive_timeout 0". Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	993 Значение 0 запрещает keep-alive соединения с клиентами.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	994 Второй необязательный параметр задаёт значение в поле
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	995 <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	996 заголовка ответа.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	997 Два параметра могут отличаться друг от друга.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	998 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	999
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1000 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1001 Поле
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1002 <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	1003 заголовка понимают Mozilla и Konqueror.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1004 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1005 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1006
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1007 </directive>
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 <directive name="large_client_header_buffers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1011 <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	1012 <default>4 8k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1013 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1014 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1015
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1016 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1017 Задаёт максимальное <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	1018 буферов для чтения большого заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1019 Строка запроса не должна превышать размера одного буфера, иначе клиенту
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1020 возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1021 <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	1022 Поле заголовка запроса также не должно превышать размера одного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1023 иначе клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1024 <http-status code="400" text="Bad Request"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1025 Буферы выделяются только по мере необходимости.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1026 По умолчанию размер одного буфера равен 8K байт.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1027 Если по окончании обработки запроса соединение переходит в состояние
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1028 keep-alive, эти буферы освобождаются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1029 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1030
2795 691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1031 <para>
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1032 Если директива указана на уровне <link id="server"/>,
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1033 то может использоваться значение из сервера по умолчанию.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1034 Подробнее см. в разделе
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1035 “<link doc="server_names.xml" id="virtual_server_selection">Выбор
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1036 виртуального сервера</link>”.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1037 </para>
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1038
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1039 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1040
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1041
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1042 <directive name="limit_except">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1043 <syntax block="yes"><value>метод</value> ...</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	1044 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1045 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1046
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1047 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1048 Ограничивает HTTP-методы, доступные внутри location.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1049 Параметр <value>метод</value> может быть одним из
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1050 <literal>GET</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1051 <literal>HEAD</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1052 <literal>POST</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1053 <literal>PUT</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1054 <literal>DELETE</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1055 <literal>MKCOL</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1056 <literal>COPY</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1057 <literal>MOVE</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1058 <literal>OPTIONS</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1059 <literal>PROPFIND</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1060 <literal>PROPPATCH</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1061 <literal>LOCK</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1062 <literal>UNLOCK</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1063 или
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1064 <literal>PATCH</literal>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1065 Если разрешён метод <literal>GET</literal>, то метод
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1066 <literal>HEAD</literal> также будет разрешён.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1067 Доступ к остальным методам может быть ограничен при помощи директив модулей
2139 f6e578b1b02d Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2134 diff changeset	1068 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>,
f6e578b1b02d Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2134 diff changeset	1069 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1070 и
2139 f6e578b1b02d Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2134 diff changeset	1071 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link>
f6e578b1b02d Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2134 diff changeset	1072 (1.13.10):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1073 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1074 limit_except GET {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1075 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	1076 deny all;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1077 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1078 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1079 Обратите внимание, что данное ограничение действует для всех методов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1080 <emphasis>кроме</emphasis> GET и HEAD.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1081 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1082
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1083 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1084
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1085
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1086 <directive name="limit_rate">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1087 <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	1088 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1089 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1090 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1091 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1092 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1093
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1094 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1095 Ограничивает скорость передачи ответа клиенту.
1519 89ac38f2225b Added missing tags to the "limit_rate" directive in Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1513 diff changeset	1096 <value>Скорость</value> задаётся в байтах в секунду.
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	1097 Значение 0 отключает ограничение скорости.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1098 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1099 Чем меньше скорость, тем более аккуратным будет ограничение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1100 -->
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1101 Ограничение устанавливается на запрос, поэтому, если клиент одновременно
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	1102 откроет два соединения, суммарная скорость будет вдвое выше
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	1103 заданного ограничения.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1104 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1105
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1106 <para>
2384 144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1107 В значении параметра можно использовать переменные (1.17.0).
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	1108 Это может быть полезно в случаях, когда скорость нужно ограничивать
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	1109 в зависимости от какого-либо условия:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1110 <example>
2384 144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1111 map $slow $rate {
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1112 1 4k;
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1113 2 8k;
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1114 }
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1115
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1116 limit_rate $rate;
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1117 </example>
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1118 </para>
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1119
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1120 <para>
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1121 Ограничение скорости можно также задать в переменной
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1122 <link id="var_limit_rate"><var>$limit_rate</var></link>,
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1123 однако начиная с 1.17.0 использовать данный метод не рекомендуется:
144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1124 <example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1125 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1126
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1127 if ($slow) {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1128 set $limit_rate 4k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1129 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1130
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1131 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1132 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1133 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1134 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1135
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	1136 <para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	1137 Кроме того, ограничение скорости может быть задано в поле
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	1138 <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	1139 Эту возможность можно запретить с помощью директив
1181 b8f0362f61e5 Added links to scgi. Yaroslav Zhuravlev <yar@nginx.com> parents: 1132 diff changeset	1140 <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	1141 <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	1142 <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	1143 и
1181 b8f0362f61e5 Added links to scgi. Yaroslav Zhuravlev <yar@nginx.com> parents: 1132 diff changeset	1144 <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	1145 </para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	1146
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1147 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1148
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1149
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1150 <directive name="limit_rate_after">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1151 <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	1152 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1153 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1154 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1155 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1156 <context>if в location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1157 <appeared-in>0.8.0</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1158
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1159 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1160 Задаёт начальный объём данных, после передачи которого начинает
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1161 ограничиваться скорость передачи ответа клиенту.
2384 144c8e3d6c09 Documented variables support in limit_rate and limit_rate_after. Yaroslav Zhuravlev <yar@nginx.com> parents: 2357 diff changeset	1162 В значении параметра можно использовать переменные (1.17.0).
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1163 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1164
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1165 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1166 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1167 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1168 location /flv/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1169 flv;
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1170 limit_rate_after 500k;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1171 limit_rate 50k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1172 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1173 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1174 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1175
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1176 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1177
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1178
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1179 <directive name="lingering_close">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1180 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1181 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1182 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1183 <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	1184 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1185 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1186 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1187 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1188 <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	1189 <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	1190
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1191 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1192 Управляет закрытием соединений с клиентами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1193 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1194
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1195 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1196 Со значением по умолчанию “<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	1197 <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	1198 <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	1199 поступающие от клиента, перед полным закрытием соединения, но только
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1200 если эвристика указывает на то, что клиент может ещё послать данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1201 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1202
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1203 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1204 Со значением “<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	1205 ждать и обрабатывать дополнительные данные, поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1206 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1207
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1208 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1209 Со значением “<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	1210 дополнительных данных и сразу же закроет соединение.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1211 Это поведение нарушает протокол и поэтому не должно использоваться без
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1212 необходимости.
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
2567 4f3494d80949 Documented support for HTTP/2 in lingering_close. Yaroslav Zhuravlev <yar@nginx.com> parents: 2523 diff changeset	1215 <para>
4f3494d80949 Documented support for HTTP/2 in lingering_close. Yaroslav Zhuravlev <yar@nginx.com> parents: 2523 diff changeset	1216 Для управления закрытием
4f3494d80949 Documented support for HTTP/2 in lingering_close. Yaroslav Zhuravlev <yar@nginx.com> parents: 2523 diff changeset	1217 <link doc="ngx_http_v2_module.xml">HTTP/2</link>-соединений
4f3494d80949 Documented support for HTTP/2 in lingering_close. Yaroslav Zhuravlev <yar@nginx.com> parents: 2523 diff changeset	1218 директива должна быть задана на уровне <link id="server"/> (1.19.1).
4f3494d80949 Documented support for HTTP/2 in lingering_close. Yaroslav Zhuravlev <yar@nginx.com> parents: 2523 diff changeset	1219 </para>
4f3494d80949 Documented support for HTTP/2 in lingering_close. Yaroslav Zhuravlev <yar@nginx.com> parents: 2523 diff changeset	1220
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1221 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1222
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1223
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1224 <directive name="lingering_time">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1225 <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	1226 <default>30s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1227 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1228 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1229 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1230
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1231 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1232 Если действует <link id="lingering_close"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1233 эта директива задаёт максимальное время, в течение которого nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1234 будет обрабатывать (читать и игнорировать) дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1235 поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1236 По прошествии этого времени соединение будет закрыто, даже если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1237 будут ещё данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1238 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1239
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1240 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1241
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1242
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1243 <directive name="lingering_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1244 <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	1245 <default>5s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1246 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1247 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1248 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1249
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1250 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1251 Если действует <link id="lingering_close"/>, эта директива задаёт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1252 максимальное время ожидания поступления дополнительных данных от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1253 Если в течение этого времени данные не были получены, соединение закрывается.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1254 В противном случае данные читаются и игнорируются, и nginx снова
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1255 ждёт поступления данных.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1256 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1257 директивой <link id="lingering_time"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1258 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1259
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1260 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1261
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1262
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1263 <directive name="listen">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1264 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1265 <value>адрес</value>[:<value>порт</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1266 [<literal>default_server</literal>]
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1267 [<literal>ssl</literal>]
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1268 [<literal>http2</literal> \|
2972 9a8d15333a58 Removed obsolete SPDY documentation. Sergey Kandaurov <pluknet@nginx.com> parents: 2965 diff changeset	1269 <literal>quic</literal>]
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1270 [<literal>proxy_protocol</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1271 [<literal>setfib</literal>=<value>число</value>]
1036 5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1272 [<literal>fastopen</literal>=<value>число</value>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1273 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1274 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1275 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1276 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1277 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1278 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1279 [<literal>ipv6only</literal>=<literal>on</literal>\|<literal>off</literal>]
1493 9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1280 [<literal>reuseport</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1281 [<literal>so_keepalive</literal>=<literal>on</literal>\|<literal>off</literal>\|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1282 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1283 <value>порт</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1284 [<literal>default_server</literal>]
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1285 [<literal>ssl</literal>]
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1286 [<literal>http2</literal> \|
2972 9a8d15333a58 Removed obsolete SPDY documentation. Sergey Kandaurov <pluknet@nginx.com> parents: 2965 diff changeset	1287 <literal>quic</literal>]
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1288 [<literal>proxy_protocol</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1289 [<literal>setfib</literal>=<value>число</value>]
1036 5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1290 [<literal>fastopen</literal>=<value>число</value>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1291 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1292 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1293 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1294 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1295 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1296 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1297 [<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	1298 [<literal>reuseport</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1299 [<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	1300 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1301 <literal>unix:</literal><value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1302 [<literal>default_server</literal>]
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1303 [<literal>ssl</literal>]
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1304 [<literal>http2</literal> \|
2972 9a8d15333a58 Removed obsolete SPDY documentation. Sergey Kandaurov <pluknet@nginx.com> parents: 2965 diff changeset	1305 <literal>quic</literal>]
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1306 [<literal>proxy_protocol</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1307 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1308 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1309 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1310 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1311 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1312 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1313 [<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	1314 <default>:80 \| :8000</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1315 <context>server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1316
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1317 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1318 Задаёт <value>адрес</value> и <value>порт</value> для IP
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1319 или <value>путь</value> для UNIX-сокета,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1320 на которых сервер будет принимать запросы.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1321 Можно указать <value>адрес</value> и <value>порт</value>,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1322 либо только <value>адрес</value> или только <value>порт</value>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1323 Кроме того, <value>адрес</value> может быть именем хоста, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1324 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1325 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	1326 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	1327 listen 8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1328 listen *:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1329 listen localhost:8000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1330 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1331 IPv6-адреса (0.7.36) задаются в квадратных скобках:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1332 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1333 listen [::]:8000;
941 7d1d53d4d293 Removed link-scoped IPv6 addresses from examples. Ruslan Ermilov <ru@nginx.com> parents: 940 diff changeset	1334 listen [::1];
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1335 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1336 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	1337 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1338 listen unix:/var/run/nginx.sock;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1339 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1340 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1341
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1342 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1343 Если указан только <value>адрес</value>, то используется порт 80.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1344 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1345
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1346 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1347 Если директива не указана, то используется либо <literal>*:80</literal>,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1348 если nginx работает с привилегиями суперпользователя,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1349 либо <literal>*:8000</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1350 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1351
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1352 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1353 Если у директивы есть параметр <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	1354 в котором описана эта директива, будет сервером по умолчанию для указанной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1355 <value>адрес</value>:<value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1356 Если же директив с параметром <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	1357 сервером по умолчанию будет первый сервер, в котором описана пара
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1358 <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	1359 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1360 До версии 0.8.21 этот параметр назывался просто
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1361 <literal>default</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1362 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1363 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1364
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1365 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1366 Параметр <literal>ssl</literal> (0.7.14) указывает на то, что все соединения,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1367 принимаемые на данном порту, должны работать в режиме SSL.
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1368 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1369 id="single_http_https_server">конфигурацию</link> для сервера,
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1370 работающего сразу в двух режимах — HTTP и HTTPS.
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1371 </para>
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1372
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1373 <para>
1567 695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1374 Параметр <literal>http2</literal> (1.9.5) позволяет принимать на этом порту
695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1375 <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	1376 Обычно, чтобы это работало, следует также указать параметр
695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1377 <literal>ssl</literal>, однако nginx можно также настроить и на приём
695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1378 HTTP/2-соединений без SSL.
2976 cbd963190c15 Documented the http2 directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2972 diff changeset	1379 <note>
cbd963190c15 Documented the http2 directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2972 diff changeset	1380 Параметр устарел, вместо него следует использовать
cbd963190c15 Documented the http2 directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2972 diff changeset	1381 директиву <link doc="ngx_http_v2_module.xml" id="http2">http2</link>.
cbd963190c15 Documented the http2 directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2972 diff changeset	1382 </note>
1567 695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1383 </para>
695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1384
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1385 <para id="quic">
2965 23eedf89fd5d Updated QUIC documentation after QUIC code merge. Yaroslav Zhuravlev <yar@nginx.com> parents: 2956 diff changeset	1386 Параметр <literal>quic</literal> (1.25.0) позволяет принимать на этом порту
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1387 <link doc="ngx_http_v3_module.xml">QUIC</link>-соединения.
a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1388 </para>
a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1389
1567 695999bdd4a5 Updated description of http2 parameter, translated into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1545 diff changeset	1390 <para>
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1391 Параметр <literal>proxy_protocol</literal> (1.5.12)
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1392 указывает на то, что все соединения, принимаемые на данном порту,
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1393 должны использовать
2912 7ebe15d6c68d Updated link to the PROXY protocol specification. Yaroslav Zhuravlev <yar@nginx.com> parents: 2903 diff changeset	1394 <link url="http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">протокол
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1395 PROXY</link>.
2125 b19d5d47c16c Documented ver.2 of the PROXY protocol. Yaroslav Zhuravlev <yar@nginx.com> parents: 2121 diff changeset	1396 <note>
b19d5d47c16c Documented ver.2 of the PROXY protocol. Yaroslav Zhuravlev <yar@nginx.com> parents: 2121 diff changeset	1397 Протокол PROXY версии 2 поддерживается начиная с версии 1.13.11.
b19d5d47c16c Documented ver.2 of the PROXY protocol. Yaroslav Zhuravlev <yar@nginx.com> parents: 2121 diff changeset	1398 </note>
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1399 </para>
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1400
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	1401 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1402 В директиве <literal>listen</literal> можно также указать несколько
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1403 дополнительных параметров, специфичных для связанных с сокетами
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1404 системных вызовов.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1405 Эти параметры можно задать в любой директиве <literal>listen</literal>,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1406 но только один раз для указанной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1407 <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	1408 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1409 До версии 0.8.21 их можно было указывать лишь в директиве
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1410 <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	1411 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1412 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1413
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1414 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1415 <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	1416 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1417 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1418 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1419 (параметр <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	1420 В настоящий момент это работает только на FreeBSD.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1421 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1422
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1423 <tag-name>
1036 5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1424 <literal>fastopen</literal>=<value>число</value>
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1425 </tag-name>
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1426 <tag-desc>
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1427 включает
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1428 “<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	1429 для слушающего сокета (1.5.8) и
2831 4add6ae1296f Updated links to datatracker.ietf.org. Sergey Kandaurov <pluknet@nginx.com> parents: 2795 diff changeset	1430 <link url="https://datatracker.ietf.org/doc/html/rfc7413#section-5.1">ограничивает</link>
1036 5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1431 максимальную длину очереди соединений, которые ещё не завершили процесс
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1432 three-way handshake.
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1433 <note>
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1434 Не включайте “TCP Fast Open”, не убедившись, что сервер может адекватно
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1435 обрабатывать многократное получение
2831 4add6ae1296f Updated links to datatracker.ietf.org. Sergey Kandaurov <pluknet@nginx.com> parents: 2795 diff changeset	1436 <link url="https://datatracker.ietf.org/doc/html/rfc7413#section-6.1">
1036 5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1437 одного и того же SYN-пакета с данными</link>.
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1438 </note>
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1439 </tag-desc>
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1440
5894aa46ffef Documented "listen fastopen=" parameter. Vladimir Homutov <vl@nginx.com> parents: 1035 diff changeset	1441 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1442 <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	1443 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1444 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1445 задаёт параметр <literal>backlog</literal> в вызове
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1446 <c-func>listen</c-func>, который ограничивает
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1447 максимальный размер очереди ожидающих приёма соединений.
741 082a725038db Fixed default backlog value description for Mac OS X Sergey Budnevitch <sb@waeme.net> parents: 738 diff changeset	1448 По умолчанию <literal>backlog</literal> устанавливается равным -1 для
1911 f024ac0ec5c7 Apple rebranded Mac OS X to macOS. Sergey Kandaurov <pluknet@nginx.com> parents: 1904 diff changeset	1449 FreeBSD, DragonFly BSD и macOS, и 511 для других платформ.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1450 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1451
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1452 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1453 <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	1454 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1455 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1456 задаёт размер буфера приёма
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1457 (параметр <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	1458 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1459
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1460 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1461 <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	1462 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1463 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1464 задаёт размер буфера передачи
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1465 (параметр <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	1466 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1467
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1468 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1469 <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	1470 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1471 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1472 задаёт название accept-фильтра
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1473 (параметр <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	1474 который включается для фильтрации входящих соединений
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1475 перед передачей их в <c-func>accept</c-func>.
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1476 Работает только на FreeBSD и NetBSD 5.0+.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1477 Можно использовать два фильтра:
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1478 <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	1479 и
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1480 <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	1481 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1482
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1483 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1484 <literal>deferred</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1485 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1486 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1487 указывает использовать отложенный <c-func>accept</c-func>
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1488 (параметр <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	1489 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1490
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1491 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1492 <literal>bind</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1493 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1494 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1495 указывает, что для данной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1496 <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	1497 <c-func>bind</c-func> отдельно.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1498 Это нужно потому, что если описаны несколько директив <literal>listen</literal>
629 7e4805858796 Fixed punctuation. Ruslan Ermilov <ru@nginx.com> parents: 625 diff changeset	1499 с одинаковым портом, но разными адресами, и одна из директив
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1500 <literal>listen</literal> слушает на всех адресах для данного порта
629 7e4805858796 Fixed punctuation. Ruslan Ermilov <ru@nginx.com> parents: 625 diff changeset	1501 (<literal>*:</literal><value>порт</value>), то nginx сделает
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1502 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
1478 002216d96931 Typo fixed. Yaroslav Zhuravlev <yar@nginx.com> parents: 1471 diff changeset	1503 Необходимо заметить, что в этом случае для определения адреса, на который
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1504 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
1035 e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1505 Если же используются параметры <literal>setfib</literal>,
2724 00afc7c4d4df Documented listen options that imply "bind". Ruslan Ermilov <ru@nginx.com> parents: 2707 diff changeset	1506 <literal>fastopen</literal>,
1035 e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1507 <literal>backlog</literal>, <literal>rcvbuf</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1508 <literal>sndbuf</literal>, <literal>accept_filter</literal>,
2724 00afc7c4d4df Documented listen options that imply "bind". Ruslan Ermilov <ru@nginx.com> parents: 2707 diff changeset	1509 <literal>deferred</literal>, <literal>ipv6only</literal>,
00afc7c4d4df Documented listen options that imply "bind". Ruslan Ermilov <ru@nginx.com> parents: 2707 diff changeset	1510 <literal>reuseport</literal>
1279 7261e621dd4a Documented that "listen ipv6only=" implies "bind". Maxim Dounin <mdounin@mdounin.ru> parents: 1257 diff changeset	1511 или <literal>so_keepalive</literal>,
1035 e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1512 то для данной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1513 <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	1514 отдельный вызов <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	1515 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1516
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1517 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1518 <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	1519 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1520 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1521 этот параметр (0.7.42) определяет
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1522 (через параметр сокета <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	1523 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1524 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения.
615 f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1525 По умолчанию параметр включён.
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1526 Установить его можно только один раз на старте.
615 f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1527 <note>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1528 До версии 1.3.4,
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1529 если этот параметр не был задан явно, то для сокета действовали
615 f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1530 настройки операционной системы.
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1531 </note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1532 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1533
1507 14180fa9a518 Added ids for reuseport, mentioned reuseport in news. Yaroslav Zhuravlev <yar@nginx.com> parents: 1501 diff changeset	1534 <tag-name id="reuseport">
1493 9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1535 <literal>reuseport</literal>
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1536 </tag-name>
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1537 <tag-desc>
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1538 этот параметр (1.9.1) указывает, что нужно создавать отдельный слушающий сокет
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1539 для каждого рабочего процесса
2199 1d60e4b4ed64 Documented SO_REUSEPORT_LB for listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2139 diff changeset	1540 (через параметр сокета
1d60e4b4ed64 Documented SO_REUSEPORT_LB for listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2139 diff changeset	1541 <c-def>SO_REUSEPORT</c-def> для Linux 3.9+ и DragonFly BSD
1d60e4b4ed64 Documented SO_REUSEPORT_LB for listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2139 diff changeset	1542 или <c-def>SO_REUSEPORT_LB</c-def> для FreeBSD 12+), позволяя ядру
1496 99ce48c8cce3 Corrected the "reuseport" description of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1493 diff changeset	1543 распределять входящие соединения между рабочими процессами.
2199 1d60e4b4ed64 Documented SO_REUSEPORT_LB for listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2139 diff changeset	1544 В настоящий момент это работает только на Linux 3.9+, DragonFly BSD
1d60e4b4ed64 Documented SO_REUSEPORT_LB for listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2139 diff changeset	1545 и FreeBSD 12+ (1.15.1).
1493 9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1546 <note>
2357 344e2535f027 Corrected Russian translation of listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2220 diff changeset	1547 Ненадлежащее использование параметра может быть
344e2535f027 Corrected Russian translation of listen reuseport. Yaroslav Zhuravlev <yar@nginx.com> parents: 2220 diff changeset	1548 <link url="http://man7.org/linux/man-pages/man7/socket.7.html">небезопасно</link>.
1493 9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1549 </note>
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1550 </tag-desc>
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1551
9faa78768252 Documented the "reuseport" option of the "listen" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1478 diff changeset	1552 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1553 <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	1554 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1555 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1556 этот параметр (1.1.11) конфигурирует для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1557 поведение “TCP keepalive”.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1558 Если этот параметр опущен, то для сокета будут действовать
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1559 настройки операционной системы.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1560 Если он установлен в значение “<literal>on</literal>”, то для сокета
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1561 включается параметр <c-def>SO_KEEPALIVE</c-def>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1562 Если он установлен в значение “<literal>off</literal>”, то для сокета
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1563 параметр <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	1564 Некоторые операционные системы поддерживают настройку параметров
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1565 “TCP keepalive” на уровне сокета посредством параметров
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1566 <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	1567 <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	1568 На таких системах (в настоящий момент это 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	1569 FreeBSD 9.0-STABLE)
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1570 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1571 <value>keepintvl</value> и <value>keepcnt</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1572 Один или два параметра могут быть опущены, в таком случае для
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1573 соответствующего параметра сокета будут действовать стандартные
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1574 системные настройки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1575 Например,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1576 <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	1577 установит таймаут бездействия (<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	1578 для интервала проб (<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	1579 стандартная системная настройка, а счётчик проб (<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	1580 будет равен 10.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1581 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1582
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1583 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1584 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1585
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1586 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1587 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1588 <example>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1589 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	1590 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1591 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1592
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1593 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1594
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1595
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1596 <directive name="location">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1597 <syntax block="yes">[
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1598 <literal>=</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1599 <literal>~</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1600 <literal>~*</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1601 <literal>^~</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1602 ] <value>uri</value></syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1603 <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	1604 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1605 <context>server</context>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1606 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1607
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1608 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1609 Устанавливает конфигурацию в зависимости от URI запроса.
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1610 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1611
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1612 <para>
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1613 Для сопоставления используется URI запроса в нормализованном виде,
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1614 после декодирования текста, заданного в виде “<literal>%XX</literal>”,
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1615 преобразования относительных элементов пути “<literal>.</literal>” и
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1616 “<literal>..</literal>” в реальные и возможной
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1617 <link id="merge_slashes">замены</link> двух и более подряд идущих
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1618 слэшей на один.
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1619 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1620
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1621 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1622 location можно задать префиксной строкой или регулярным выражением.
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1623 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1624 (для поиска совпадения без учёта регистра символов),
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1625 либо с модификатором “<literal>~</literal>” (с учётом регистра).
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1626 Чтобы найти location, соответствующий запросу, вначале проверяются
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1627 location’ы, заданные префиксными строками (префиксные location’ы).
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1628 Среди них ищется location с совпадающим префиксом
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1629 максимальной длины и запоминается.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1630 Затем проверяются регулярные выражения, в порядке их следования
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1631 в конфигурационном файле.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1632 Проверка регулярных выражений прекращается после первого же совпадения,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1633 и используется соответствующая конфигурация.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1634 Если совпадение с регулярным выражением не найдено, то используется
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1635 конфигурация запомненного ранее префиксного location’а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1636 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1637
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1638 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1639 Блоки <literal>location</literal> могут быть вложенными,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1640 с некоторыми исключениями, о которых говорится ниже.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1641 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1642
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1643 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1644 Для операционных систем, нечувствительных к регистру символов, таких
1911 f024ac0ec5c7 Apple rebranded Mac OS X to macOS. Sergey Kandaurov <pluknet@nginx.com> parents: 1904 diff changeset	1645 как macOS и Cygwin, сравнение с префиксными строками производится
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1646 без учёта регистра (0.7.7).
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1647 Однако сравнение ограничено только однобайтными locale’ями.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1648 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1649
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1650 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1651 Регулярные выражения могут содержать выделения (0.7.40), которые могут
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1652 затем использоваться в других директивах.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1653 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1654
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1655 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1656 Если у совпавшего префиксного location’а максимальной длины указан модификатор
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1657 “<literal>^~</literal>”, то регулярные выражения не проверяются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1658 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1659
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1660 <para>
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1661 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1662 совпадение URI и location.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1663 При точном совпадении поиск сразу же прекращается.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1664 Например, если запрос “<literal>/</literal>” случается часто, то
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1665 указав “<literal>location = /</literal>”, можно ускорить обработку
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1666 этих запросов, так как поиск прекратится после первого же сравнения.
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1667 Очевидно, что такой location не может иметь вложенные location’ы.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1668 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1669
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1670 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1671 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1672 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1673 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	1674 то поиск тоже сразу же прекращается и регулярные выражения также
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1675 не проверяются.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1676 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1677 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1678
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1679 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1680 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1681 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1682 location = / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1683 [ конфигурация А ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1684 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1685
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1686 location / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1687 [ конфигурация Б ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1688 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1689
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1690 location /documents/ {
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1691 [ конфигурация В ]
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1692 }
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1693
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1694 location ^~ /images/ {
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1695 [ конфигурация Г ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1696 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1697
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1698 location ~* \.(gif\|jpg\|jpeg)$ {
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1699 [ конфигурация Д ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1700 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1701 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1702 Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1703 для запроса “<literal>/index.html</literal>” — конфигурация Б,
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1704 для запроса “<literal>/documents/document.html</literal>” — конфигурация В,
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1705 для запроса “<literal>/images/1.gif</literal>” — конфигурация Г,
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1706 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Д.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1707 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1708
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	1709 <para id="location_named">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1710 Префикс “<literal>@</literal>” задаёт именованный location.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1711 Такой location не используется при обычной обработке запросов, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1712 предназначен только для перенаправления в него запросов.
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1713 Такие location’ы не могут быть вложенными и не могут содержать
af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1714 вложенные location’ы.
76 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
914 474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1717 <para>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1718 Если location задан префиксной строкой со слэшом в конце
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1719 и запросы обрабатываются при помощи
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1720 <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	1721 <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	1722 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
2134 4cafd82e5007 Added info about gRPC to various modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2125 diff changeset	1723 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
4cafd82e5007 Added info about gRPC to various modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2125 diff changeset	1724 <link doc="ngx_http_memcached_module.xml" id="memcached_pass"/> или
4cafd82e5007 Added info about gRPC to various modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2125 diff changeset	1725 <link doc="ngx_http_grpc_module.xml" id="grpc_pass"/>,
1257 ac7a5ee98768 Split long sentence into two. Ruslan Ermilov <ru@nginx.com> parents: 1194 diff changeset	1726 происходит специальная обработка.
ac7a5ee98768 Split long sentence into two. Ruslan Ermilov <ru@nginx.com> parents: 1194 diff changeset	1727 В ответ на запрос с URI равным этой строке, но без завершающего слэша,
914 474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1728 будет возвращено постоянное перенаправление с кодом 301
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1729 на URI с добавленным в конец слэшом.
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1730 Если такое поведение нежелательно, можно задать точное совпадение
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1731 URI и location, например:
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1732 <example>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1733 location /user/ {
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1734 proxy_pass http://user.example.com;
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1735 }
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1736
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1737 location = /user {
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1738 proxy_pass http://login.example.com;
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1739 }
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1740 </example>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1741 </para>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1742
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1743 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1744 <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	1745 -->
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1748
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1749
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1750 <directive name="log_not_found">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1751 <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	1752 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1753 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1754 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1755 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1756
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1757 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1758 Разрешает или запрещает записывать в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1759 <link doc="../ngx_core_module.xml" id="error_log"/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1760 ошибки о том, что файл не найден.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1761 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1762
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1763 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1764
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 <directive name="log_subrequest">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1767 <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	1768 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1769 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1770 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1771 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1772
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1773 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1774 Разрешает или запрещает записывать в
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	1775 <link doc="ngx_http_log_module.xml" id="access_log"/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1776 подзапросы.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1777 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1778
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1779 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1780
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1781
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1782 <directive name="max_ranges">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1783 <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	1784 <default/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1785 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1786 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1787 <context>location</context>
499 76a8eca844d0 Documented that "max_ranges" appeared in 1.1.2. Ruslan Ermilov <ru@nginx.com> parents: 477 diff changeset	1788 <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	1789
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1790 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1791 Ограничивает максимальное допустимое число диапазонов в запросах с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1792 указанием диапазона запрашиваемых байт (byte-range requests).
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 если бы они не содержали указания диапазонов.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1795 По умолчанию число диапазонов не ограничено.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1796 Значение 0 полностью запрещает поддержку диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1797 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1798
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1799 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1800
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1801
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1802 <directive name="merge_slashes">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1803 <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	1804 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1805 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1806 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1807
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1808 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1809 Разрешает или запрещает преобразование URI путём замены двух и более подряд
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1810 идущих слэшей (“<literal>/</literal>”) на один.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1811 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1812
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1813 <para>
280 cbb789d3ce5e Fixed grammar error. Ruslan Ermilov <ru@nginx.com> parents: 274 diff changeset	1814 Необходимо иметь в виду, что это преобразование необходимо для корректной
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1815 проверки префиксных строк и регулярных выражений.
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1816 Если его не делать, то запрос “<literal>//scripts/one.php</literal>”
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1817 не попадёт в
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1818 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1819 location /scripts/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1820 ...
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 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1823 и может быть обслужен как статический файл.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1824 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1828 Запрет преобразования может понадобиться, если в URI используются имена,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1829 закодированные методом base64, в котором задействован символ
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1830 “<literal>/</literal>”.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1831 Однако из соображений безопасности лучше избегать отключения преобразования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1832 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1833
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1834 <para>
1023 375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	1835 Если директива указана на уровне <link id="server"/>,
2795 691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1836 то может использоваться значение из сервера по умолчанию.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1837 Подробнее см. в разделе
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1838 “<link doc="server_names.xml" id="virtual_server_selection">Выбор
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	1839 виртуального сервера</link>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1840 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1841
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1842 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1843
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1844
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1845 <directive name="msie_padding">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1846 <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	1847 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1848 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1849 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1850 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1851
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1852 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1853 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1854 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1855 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1856
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1857 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1858
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1859
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1860 <directive name="msie_refresh">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1861 <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	1862 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1863 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1864 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1865 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1866
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1867 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1868 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1869 перенаправлений.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1870 </para>
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1873
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1874
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1875 <directive name="open_file_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1876 <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	1877 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1878 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1879 [<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	1880 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1881 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1882 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1883 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1884
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1885 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1886 Задаёт кэш, в котором могут храниться:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1887 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1888
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1889 <listitem>
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 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1894 информация о существовании каталогов;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1895 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1896
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1897 <listitem>
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1898 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1899 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1900 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1901 Кэширование ошибок нужно разрешить отдельно директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1902 <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	1903 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1904 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1905
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1906 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1907 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1908
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1909 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1910 У директивы есть следующие параметры:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1911 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1912
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1913 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1914 <literal>max</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1915 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1916 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1917 задаёт максимальное число элементов в кэше;
507 d00a4f9b1c5d Better translation of "LRU". Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	1918 при переполнении кэша удаляются наименее востребованные элементы (LRU);
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1919 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1920
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1921 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1922 <literal>inactive</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1923 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1924 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1925 задаёт время, после которого элемент кэша удаляется, если к нему
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1926 не было обращений в течение этого времени; по умолчанию 60 секунд;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1927 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1928
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1929 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1930 <literal>off</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1931 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1932 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1933 запрещает кэш.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1934 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1935
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1936 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1937 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1938
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1939 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1940 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1941 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1942 open_file_cache max=1000 inactive=20s;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1943 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1944 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1945 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	1946 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1947 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	1948 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1949 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1950 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1951
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1952 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1955 <directive name="open_file_cache_errors">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1956 <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	1957 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1958 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1959 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1960 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1961
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1962 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1963 Разрешает или запрещает кэширование ошибок поиска файлов в
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1964 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1965 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1966
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1967 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1968
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1969
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1970 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1971
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1972 <directive name="open_file_cache_events">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1973 <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	1974 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1975 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1976 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1977 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1978
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1979 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1980 Разрешает использование событий ядра для проверки актуальности элементов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1981 <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	1982 Эта директива работает только совместно с методом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1983 <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	1984 Заметьте, что только NetBSD 2.0+ и FreeBSD 6.0+
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1985 поддерживают события для файловых систем произвольного типа.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1986 Другие операционные системы поддерживают события только для
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1987 основных файловых систем, таких как UFS или FFS.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1988 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1989
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1990 </directive>
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 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1993
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1994
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1995 <directive name="open_file_cache_min_uses">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1996 <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	1997 <default>1</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1998 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1999 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2000 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2001
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2002 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2003 Задаёт минимальное <value>число</value> обращений к файлу
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2004 в течение времени, заданного параметром <literal>inactive</literal>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2005 директивы <link id="open_file_cache"/>, необходимых для того, чтобы дескриптор
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2006 файла оставался открытым в кэше.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2007 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2008
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2009 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2010
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2011
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2012 <directive name="open_file_cache_valid">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2013 <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	2014 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2015 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2016 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2017 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2018
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2019 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2020 Определяет время, через которое следует проверять актуальность информации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2021 об элементе в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2022 <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	2023 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2024 При включенном
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2025 <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	2026 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2027 по факту их изменения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2028 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2029 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2030
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2031 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2032
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2033
1024 e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2034 <directive name="output_buffers">
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2035 <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	2036 <default>2 32k</default>
1024 e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2037 <context>http</context>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2038 <context>server</context>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2039 <context>location</context>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2040
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2041 <para>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2042 Задаёт <value>число</value> и <value>размер</value> буферов,
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2043 используемых при чтении ответа с диска.
1576 7f97ab081d24 Changed default value in the output_buffers directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1567 diff changeset	2044 <note>
7f97ab081d24 Changed default value in the output_buffers directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1567 diff changeset	2045 До версии 1.9.5 по умолчанию использовалось значение 1 32k.
7f97ab081d24 Changed default value in the output_buffers directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1567 diff changeset	2046 </note>
1024 e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2047 </para>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2048
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2049 </directive>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2050
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	2051
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2052 <directive name="port_in_redirect">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2053 <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	2054 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2055 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2056 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2057 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2058
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2059 <para>
1879 3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	2060 Разрешает или запрещает указывать порт в
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	2061 <link id="absolute_redirect">абсолютных</link>
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	2062 перенаправлениях, выдаваемых nginx’ом.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2063 </para>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2064
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2065 <para>
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2066 Использование в перенаправлениях основного имени сервера управляется
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2067 директивой <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	2068 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2069
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2070 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2071
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2072
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2073 <directive name="postpone_output">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2074 <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	2075 <default>1460</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2076 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2077 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2078 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2079
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2080 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2081 Если это возможно, то отправка данных клиенту будет отложена пока nginx не
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2082 накопит по крайней мере указанное количество байт для отправки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2083 Значение 0 запрещает отложенную отправку данных.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2084 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2085
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2086 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2087
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2088
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2089 <directive name="read_ahead">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2090 <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	2091 <default>0</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2092 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2093 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2094 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2095
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2096 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2097 Задаёт ядру размер предчтения при работе с файлами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2098 </para>
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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2101 На Linux используется системный вызов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2102 <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	2103 поэтому параметр <value>размер</value> там игнорируется.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2104 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2105
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2106 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2107 На FreeBSD используется системный вызов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2108 <literal>fcntl(O_READAHEAD,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2109 </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	2110 появившийся во FreeBSD 9.0-CURRENT.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2111 Для FreeBSD 7 необходимо установить
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2112 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2113 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2114
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2115 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2116
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2117
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2118 <directive name="recursive_error_pages">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2119 <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	2120 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2121 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2122 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2123 <context>location</context>
76 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 Разрешает или запрещает делать несколько перенаправлений через директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2127 <link id="error_page"/>.
709 a4648185190a Fixed the link internal to the module. Ruslan Ermilov <ru@nginx.com> parents: 679 diff changeset	2128 Число таких перенаправлений <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	2129 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2130
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2131 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2132
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2133
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2134 <directive name="request_pool_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2135 <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	2136 <default>4k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2137 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2138 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2139
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2140 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2141 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2142 под конкретные запросы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2143 Эта директива не оказывает существенного влияния на
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2144 производительность, и её не следует использовать.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2145 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2146
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2147 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2148
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2149
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2150 <directive name="reset_timedout_connection">
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2151 <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	2152 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2153 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2154 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2155 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2156
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2157 <para>
2390 655e7de7fd4b Documented "return 444" when reset_timedout_connection is on. Yaroslav Zhuravlev <yar@nginx.com> parents: 2384 diff changeset	2158 Разрешает или запрещает сброс соединений по таймауту,
655e7de7fd4b Documented "return 444" when reset_timedout_connection is on. Yaroslav Zhuravlev <yar@nginx.com> parents: 2384 diff changeset	2159 а также при
655e7de7fd4b Documented "return 444" when reset_timedout_connection is on. Yaroslav Zhuravlev <yar@nginx.com> parents: 2384 diff changeset	2160 <link doc="ngx_http_rewrite_module.xml" id="return">закрытии</link>
655e7de7fd4b Documented "return 444" when reset_timedout_connection is on. Yaroslav Zhuravlev <yar@nginx.com> parents: 2384 diff changeset	2161 соединений с помощью нестандартного кода 444 (1.15.2).
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2162 Сброс делается следующим образом.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2163 Перед закрытием сокета для него задаётся параметр
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2164 <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	2165 с таймаутом 0.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2166 После этого при закрытии сокета клиенту отсылается TCP RST, а вся память,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2167 связанная с этим сокетом, освобождается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2168 Это позволяет избежать длительного нахождения уже закрытого сокета в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2169 состоянии FIN_WAIT1 с заполненными буферами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2170 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2171
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2172 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2173 Необходимо отметить, что keep-alive соединения по истечении таймаута
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2174 закрываются обычным образом.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2175 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2176
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2177 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2178
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2179
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2180 <directive name="resolver">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2181 <syntax>
1031 f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2182 <value>адрес</value> ...
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2183 [<literal>valid</literal>=<value>время</value>]
2870 e06cf66a9f63 Documented the "ipv4=off" parameter of the "resolver" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2831 diff changeset	2184 [<literal>ipv4</literal>=<literal>on</literal>\|<literal>off</literal>]
2424 dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2185 [<literal>ipv6</literal>=<literal>on</literal>\|<literal>off</literal>]
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2186 [<literal>status_zone</literal>=<value>зона</value>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	2187 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2188 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2189 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2190 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2191
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2192 <para>
318 4a0fe9283dc7 Word polishing in the description of the "server" directive. Ruslan Ermilov <ru@nginx.com> parents: 280 diff changeset	2193 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2194 в адреса, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2195 <example>
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	2196 resolver 127.0.0.1 [::1]:5353;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2197 </example>
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	2198 Адрес может быть указан в виде доменного имени или IP-адреса,
566 f8148fc88224 Documented 1.2.2 changes. Ruslan Ermilov <ru@nginx.com> parents: 549 diff changeset	2199 и необязательного порта (1.3.1, 1.2.2).
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	2200 Если порт не указан, используется порт 53.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2201 Серверы DNS опрашиваются циклически.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2202 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2203 До версии 1.1.7 можно было задать лишь один DNS-сервер.
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	2204 Задание DNS-серверов с помощью IPv6-адресов поддерживается
566 f8148fc88224 Documented 1.2.2 changes. Ruslan Ermilov <ru@nginx.com> parents: 549 diff changeset	2205 начиная с версий 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	2206 </note>
2452 4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver. Yaroslav Zhuravlev <yar@nginx.com> parents: 2450 diff changeset	2207 </para>
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver. Yaroslav Zhuravlev <yar@nginx.com> parents: 2450 diff changeset	2208
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver. Yaroslav Zhuravlev <yar@nginx.com> parents: 2450 diff changeset	2209 <para id="resolver_ipv6">
1031 f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2210 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2211 при преобразовании имён в адреса.
2870 e06cf66a9f63 Documented the "ipv4=off" parameter of the "resolver" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2831 diff changeset	2212 Если поиск IPv4- или IPv6-адресов нежелателен,
e06cf66a9f63 Documented the "ipv4=off" parameter of the "resolver" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2831 diff changeset	2213 можно указать параметр <literal>ipv4=off</literal> (1.23.1) или
e06cf66a9f63 Documented the "ipv4=off" parameter of the "resolver" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2831 diff changeset	2214 <literal>ipv6=off</literal>.
1031 f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2215 <note>
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2216 Преобразование имён в IPv6-адреса поддерживается
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2217 начиная с версии 1.5.8.
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	2218 </note>
2452 4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver. Yaroslav Zhuravlev <yar@nginx.com> parents: 2450 diff changeset	2219 </para>
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver. Yaroslav Zhuravlev <yar@nginx.com> parents: 2450 diff changeset	2220
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver. Yaroslav Zhuravlev <yar@nginx.com> parents: 2450 diff changeset	2221 <para id="resolver_valid">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2222 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2223 Необязательный параметр <literal>valid</literal> позволяет это
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2224 переопределить:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2225 <example>
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	2226 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	2227 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2228 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2229 До версии 1.1.9 настройка времени кэширования была невозможна
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2230 и nginx всегда кэшировал ответы на срок в 5 минут.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2231 </note>
1770 ae46e57cecba Added note to the "resover" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1769 diff changeset	2232 <note>
ae46e57cecba Added note to the "resover" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1769 diff changeset	2233 Для предотвращения DNS-спуфинга рекомендуется
ae46e57cecba Added note to the "resover" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1769 diff changeset	2234 использовать DNS-серверы в защищённой доверенной локальной сети.
ae46e57cecba Added note to the "resover" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1769 diff changeset	2235 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2236 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2237
2424 dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2238 <para id="resolver_status_zone">
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2239 Необязательный параметр <literal>status_zone</literal> (1.17.1)
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2240 включает
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2241 <link doc="ngx_http_api_module.xml" id="resolvers_">сбор информации</link>
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2242 о запросах и ответах сервера DNS
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2243 в указанной <value>зоне</value>.
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2244 Параметр доступен как часть
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2245 <commercial_version>коммерческой подписки</commercial_version>.
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2246 </para>
dd3ac7eefeed Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 2391 diff changeset	2247
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2248 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2249
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2250
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2251 <directive name="resolver_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2252 <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	2253 <default>30s</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2254 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2255 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2256 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2257
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2258 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2259 Задаёт таймаут для преобразования имени в адрес, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2260 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2261 resolver_timeout 5s;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2262 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2263 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2264
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2265 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2268 <directive name="root">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2269 <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	2270 <default>html</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2271 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2272 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2273 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2274 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2275
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2276 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2277 Задаёт корневой каталог для запросов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2278 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2279 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2280 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2281 root /data/w3;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2282 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2283 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2284 в ответ на запрос “<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	2285 <path>/data/w3/i/top.gif</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2286 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2287
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2288 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2289 В значении параметра <value>путь</value> можно использовать переменные,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2290 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2291 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2292
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2293 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2294 Путь к файлу формируется путём простого добавления URI к значению директивы
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2295 <literal>root</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2296 Если же URI необходимо поменять, следует воспользоваться директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2297 <link id="alias"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2298 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2301
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2302
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2303 <directive name="satisfy">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2304 <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	2305 <default>all</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2306 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2307 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2308 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2309
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2310 <para>
971 6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2311 Разрешает доступ, если все (<literal>all</literal>)
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2312 или хотя бы один (<literal>any</literal>) из модулей
971 6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2313 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>,
1763 a7974b8d2a23 Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1732 diff changeset	2314 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>,
971 6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2315 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>
1763 a7974b8d2a23 Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1732 diff changeset	2316 или
a7974b8d2a23 Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1732 diff changeset	2317 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2318 разрешают доступ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2319 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2320
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2321 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2322 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2323 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2324 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2325 satisfy any;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2326
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2327 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	2328 deny all;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2329
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2330 auth_basic "closed site";
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2331 auth_basic_user_file conf/htpasswd;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2332 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2333 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2334 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2335
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2336 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2337
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2338
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2339 <directive name="send_lowat">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2340 <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	2341 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2342 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2343 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2344 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2345
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2346 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2347 При установке этой директивы в ненулевое значение nginx будет пытаться
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2348 минимизировать число операций отправки на клиентских сокетах либо при
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2349 помощи флага <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	2350 <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	2351 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2352 В обоих случаях будет использован указанный <value>размер</value>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2353 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2354
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2355 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2356 Эта директива игнорируется на Linux, Solaris и Windows.
76 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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2360
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2361
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2362 <directive name="send_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2363 <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	2364 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2365 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2366 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2367 <context>location</context>
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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2370 Задаёт таймаут при передаче ответа клиенту.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2371 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2372 а только между двумя операциями записями.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2373 Если по истечении этого времени клиент ничего не примет,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2374 соединение будет закрыто.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2375 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2378
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2379
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2380 <directive name="sendfile">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2381
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2382 <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	2383 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2384 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2385 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2386 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2387 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2388
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2389 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2390 Разрешает или запрещает использовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2391 <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	2392 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2393
1432 9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2394 <para>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2395 Начиная с nginx 0.8.12 и FreeBSD 5.2.1,
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2396 можно использовать <link id="aio"/> для подгрузки данных
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2397 для <c-func>sendfile</c-func>:
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2398 <example>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2399 location /video/ {
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2400 sendfile on;
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2401 tcp_nopush on;
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2402 aio on;
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2403 }
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2404 </example>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2405 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2406 <c-def>SF_NODISKIO</c-def>, в результате чего она не блокируется на диске, а
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2407 сообщает об отсутствии данных в памяти.
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2408 После этого nginx инициирует асинхронную подгрузку данных, читая один байт.
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2409 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2410 при последующих чтениях файл подгружается частями только по 16K.
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2411 Изменить это можно с помощью директивы
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2412 <link id="read_ahead"/>.
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2413 <note>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2414 До версии 1.7.11 подгрузка данных включалась с помощью
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2415 <literal>aio sendfile;</literal>.
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2416 </note>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2417 </para>
9012d7935c9b Documented that "aio sendfile" is deprecated. Ruslan Ermilov <ru@nginx.com> parents: 1430 diff changeset	2418
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2419 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2420
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2421
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2422 <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	2423
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2424 <syntax><value>размер</value></syntax>
2793 4934cbc1db19 Changed default value of sendfile_max_chunk to 2m. Yaroslav Zhuravlev <yar@nginx.com> parents: 2724 diff changeset	2425 <default>2m</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2426 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2427 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2428 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2429
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2430 <para>
2793 4934cbc1db19 Changed default value of sendfile_max_chunk to 2m. Yaroslav Zhuravlev <yar@nginx.com> parents: 2724 diff changeset	2431 Ограничивает объём данных,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2432 который может передан за один вызов <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	2433 Без этого ограничения одно быстрое соединение может целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2434 захватить рабочий процесс.
2793 4934cbc1db19 Changed default value of sendfile_max_chunk to 2m. Yaroslav Zhuravlev <yar@nginx.com> parents: 2724 diff changeset	2435 <note>
4934cbc1db19 Changed default value of sendfile_max_chunk to 2m. Yaroslav Zhuravlev <yar@nginx.com> parents: 2724 diff changeset	2436 До версии 1.21.4 по умолчанию ограничения не было.
4934cbc1db19 Changed default value of sendfile_max_chunk to 2m. Yaroslav Zhuravlev <yar@nginx.com> parents: 2724 diff changeset	2437 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2438 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2439
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2440 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2441
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2442
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2443 <directive name="server">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	2444 <syntax block="yes"/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	2445 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2446 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2447
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2448 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2449 Задаёт конфигурацию для виртуального сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2450 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2451 и 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	2452 Вместо этого директивами <link id="listen"/> описываются все
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2453 адреса и порты, на которых нужно принимать соединения для этого сервера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2454 а в директиве <link id="server_name"/> указываются все имена серверов.
522 ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts" Ruslan Ermilov <ru@nginx.com> parents: 507 diff changeset	2455 Примеры конфигураций описаны в документе
ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts" Ruslan Ermilov <ru@nginx.com> parents: 507 diff changeset	2456 “<link doc="request_processing.xml"/>”.
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_name">
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>""</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2465 <context>server</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 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2470 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2471 server_name example.com www.example.com;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2472 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2473 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2474 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2475
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2476 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2477 Первое имя становится основным именем сервера.
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2478 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2479
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2480 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2481 В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2482 для замены первой или последней части имени:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2483 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2484 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2485 server_name example.com .example.com www.example.;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2486 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2487 </example>
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2488 Такие имена называются именами с маской.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2489 </para>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2492 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2493 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2494 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2495 server_name .example.com;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2496 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2497 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2498 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2499
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2500 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2501 В качестве имени сервера можно также использовать регулярное выражение,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2502 указав перед ним тильду (“<literal>~</literal>”):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2503 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2504 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2505 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	2506 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2507 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2508 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2509
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2510 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2511 Регулярное выражение может содержать выделения (0.7.40),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2512 которые могут затем использоваться в других директивах:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2513 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2514 server {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2515 server_name ~^(www\.)?(.+)$;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2516
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2517 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2518 root /sites/$2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2519 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2520 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2521
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2522 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2523 server_name _;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2524
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2525 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2526 root /sites/default;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2527 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2528 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2529 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2530 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2531
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2532 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2533 Именованные выделения в регулярном выражении создают переменные (0.8.25),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2534 которые могут затем использоваться в других директивах:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2535 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2536 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2537 server_name ~^(www\.)?(?<domain>.+)$;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2538
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2539 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2540 root /sites/$domain;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2541 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2542 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2543
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2544 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2545 server_name _;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2546
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2547 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2548 root /sites/default;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2549 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2550 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2551 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2552 </para>
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 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2555 Если параметр директивы установлен в “<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	2556 подставляется имя хоста (hostname) машины.
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2557 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2558
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2559 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2560 Возможно также указать пустое имя сервера (0.7.11):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2561 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2562 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2563 server_name www.example.com "";
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2564 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2565 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2566 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2567 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2568 Это настройка по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2569 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2570 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2571 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2572 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2573
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2574 <para>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2575 При поиске виртуального сервера по имени,
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2576 если имени соответствует несколько из указанных вариантов,
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2577 например, одновременно подходят и имя с маской, и регулярное выражение,
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2578 будет выбран первый подходящий вариант в следующем порядке приоритета:
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2579 <list type="enum">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2580
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2581 <listitem>
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2582 точное имя
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2583 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2584
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2585 <listitem>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2586 самое длинное имя с маской в начале,
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2587 например “<literal>*.example.com</literal>”
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2588 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2589
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2590 <listitem>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2591 самое длинное имя с маской в конце,
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2592 например “<literal>mail.*</literal>”
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2593 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2594
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2595 <listitem>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2596 первое подходящее регулярное выражение
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2597 (в порядке следования в конфигурационном файле)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2598 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2599
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2600 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2601 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2602
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2603 <para>
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2604 Подробнее имена серверов обсуждаются в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2605 <link 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	2606 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2607
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2608 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2609
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2610
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2611 <directive name="server_name_in_redirect">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2612 <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	2613 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2614 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2615 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2616 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2617
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2618 <para>
1879 3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	2619 Разрешает или запрещает использовать в
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	2620 <link id="absolute_redirect">абсолютных</link> перенаправлениях,
3685d90e133e Documented the "absolute_redirect" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1859 diff changeset	2621 выдаваемых nginx’ом, основное имя сервера, задаваемое директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2622 <link id="server_name"/>.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2623 Если использование основного имени сервера запрещено, то используется имя,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2624 указанное в поле <header>Host</header> заголовка запроса.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2625 Если же этого поля нет, то используется IP-адрес сервера.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2626 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2627
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2628 <para>
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2629 Использование в перенаправлениях порта управляется
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2630 директивой <link id="port_in_redirect"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2631 </para>
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 </directive>
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 <directive name="server_names_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2637 <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	2638 <default>32\|64\|128</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2639 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2640
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2641 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2642 Задаёт размер корзины в хэш-таблицах имён серверов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2643 Значение по умолчанию зависит от размера строки кэша процессора.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2644 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2645 <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	2646 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2647
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2648 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2649
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2650
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2651 <directive name="server_names_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2652 <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	2653 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2654 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2655
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2656 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2657 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2658 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2659 <link doc="../hash.xml">документе</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2660 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2661
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2662 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2663
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2664
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2665 <directive name="server_tokens">
1680 57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2666 <syntax>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2667 <literal>on</literal> \|
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2668 <literal>off</literal> \|
1904 d59199b0c022 Documented the "build" parameter of the "server_tokens" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1903 diff changeset	2669 <literal>build</literal> \|
1680 57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2670 <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	2671 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2672 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2673 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2674 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2675
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2676 <para>
1903 da00a2526415 Replaced "error messages" with "error pages" in server_tokens. Yaroslav Zhuravlev <yar@nginx.com> parents: 1881 diff changeset	2677 Разрешает или запрещает выдавать версию nginx’а на страницах ошибок и
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2678 в поле <header>Server</header> заголовка ответа.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2679 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2680
1904 d59199b0c022 Documented the "build" parameter of the "server_tokens" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1903 diff changeset	2681 <para id="server_tokens_build">
1953 408eed0bf491 Clarified description of server_tokens build. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	2682 Если указан параметр <literal>build</literal> (1.11.10),
408eed0bf491 Clarified description of server_tokens build. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	2683 то наряду с версией nginx’а будет также выдаваться
408eed0bf491 Clarified description of server_tokens build. Yaroslav Zhuravlev <yar@nginx.com> parents: 1923 diff changeset	2684 <link doc="../configure.xml" id="build">имя сборки</link>.
1904 d59199b0c022 Documented the "build" parameter of the "server_tokens" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1903 diff changeset	2685 </para>
d59199b0c022 Documented the "build" parameter of the "server_tokens" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1903 diff changeset	2686
1680 57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2687 <para>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2688 Дополнительно, как часть
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2689 <commercial_version>коммерческой подписки</commercial_version>,
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2690 начиная с версии 1.9.13
1903 da00a2526415 Replaced "error messages" with "error pages" in server_tokens. Yaroslav Zhuravlev <yar@nginx.com> parents: 1881 diff changeset	2691 подписи на страницах ошибок и
1680 57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2692 значение поля <header>Server</header> заголовка ответа
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2693 можно задать явно с помощью строки с переменными.
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2694 Пустая строка запрещает выдачу поля <header>Server</header>.
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2695 </para>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release. Ruslan Ermilov <ru@nginx.com> parents: 1665 diff changeset	2696
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2697 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2698
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2699
2118 0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2700 <directive name="subrequest_output_buffer_size">
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2701 <syntax><value>размер</value></syntax>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2702 <default>4k\|8k</default>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2703 <context>http</context>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2704 <context>server</context>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2705 <context>location</context>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2706 <appeared-in>1.13.10</appeared-in>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2707
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2708 <para>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2709 Задаёт <value>размер</value> буфера, используемого для
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2710 хранения тела ответа подзапроса.
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2711 По умолчанию размер одного буфера равен размеру страницы памяти.
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2712 В зависимости от платформы это или 4K, или 8K,
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2713 однако его можно сделать меньше.
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2714 </para>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2715
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2716 <para>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2717 Директива применима только для подзапросов,
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2718 тело ответа которых сохраняется в памяти.
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2719 Например, подобные подзапросы создаются при помощи
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2720 <link doc="ngx_http_ssi_module.xml" id="ssi_include_set">SSI</link>.
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2721 </para>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2722
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2723 </directive>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2724
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2039 diff changeset	2725
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2726 <directive name="tcp_nodelay">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2727 <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	2728 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2729 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2730 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2731 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2732
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2733 <para>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2734 Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>.
2121 cf9e3d2893b6 Fixed description of the http tcp_nodelay directive. Ruslan Ermilov <ru@nginx.com> parents: 2118 diff changeset	2735 Параметр включается при переходе соединения в состояние keep-alive.
cf9e3d2893b6 Fixed description of the http tcp_nodelay directive. Ruslan Ermilov <ru@nginx.com> parents: 2118 diff changeset	2736 Также, он включается на SSL-соединениях,
cf9e3d2893b6 Fixed description of the http tcp_nodelay directive. Ruslan Ermilov <ru@nginx.com> parents: 2118 diff changeset	2737 при небуферизованном проксировании
cf9e3d2893b6 Fixed description of the http tcp_nodelay directive. Ruslan Ermilov <ru@nginx.com> parents: 2118 diff changeset	2738 и при проксировании <link doc="websocket.xml">WebSocket</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2739 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2740
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2741 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2742
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2743
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2744 <directive name="tcp_nopush">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2745 <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	2746 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2747 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2748 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2749 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2750
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2751 <para>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2752 Разрешает или запрещает использование параметра сокета
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2753 <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	2754 <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	2755 Параметр включаются только при использовании <link id="sendfile"/>.
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2756 Включение параметра позволяет
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2757 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2758
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2759 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2760 передавать заголовок ответа и начало файла в одном пакете
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2761 в Linux и во FreeBSD 4.*;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2762 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2763
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2764 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2765 передавать файл полными пакетами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2766 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2767
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2768 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2769 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2770
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2771 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2772
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2773
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2774 <directive name="try_files">
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2775 <syntax><value>файл</value> ... <value>uri</value></syntax>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2776 <syntax><value>файл</value> ... =<value>код</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	2777 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2778 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2779 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2780
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2781 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2782 Проверяет существование файлов в заданном порядке и использует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2783 для обработки запроса первый найденный файл, причём обработка
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	2784 делается в контексте этого же location’а.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2785 Путь к файлу строится из параметра <value>файл</value>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2786 в соответствии с директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2787 <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	2788 С помощью слэша в конце имени можно проверить существование каталога,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2789 например, “<literal>$uri/</literal>”.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2790 В случае, если ни один файл не найден, то делается внутреннее
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2791 перенаправление на <value>uri</value>, заданный последним параметром.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2792 Например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2793 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2794 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2795 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	2796 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2797
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2798 location = /images/default.gif {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2799 expires 30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2800 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2801 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2802 Последний параметр может также указывать на именованный location,
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2803 как в примерах ниже.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2804 С версии 0.7.51 последний параметр может также быть <value>кодом</value>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2805 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2806 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2807 try_files $uri $uri/index.html $uri.html =404;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2808 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2809 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2810 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2811
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2812 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2813 Пример использования при проксировании Mongrel:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2814 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2815 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2816 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	2817 $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	2818 @mongrel;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2819 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2820
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2821 location @mongrel {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2822 proxy_pass http://mongrel;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2823 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2824 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2825 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2826
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2827 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2828 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2829 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2830 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2831 try_files $uri $uri/ @drupal;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2832 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2833
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2834 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2835 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2836
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2837 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2838
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2839 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	2840 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	2841 fastcgi_param QUERY_STRING $args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2842
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2843 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2844 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2845
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2846 location @drupal {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2847 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2848
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2849 fastcgi_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	2850 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	2851 fastcgi_param QUERY_STRING q=$uri&$args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2852
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2853 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2854 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2855 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2856 В следующем примере директива <literal>try_files</literal>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2857 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2858 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2859 try_files $uri $uri/ @drupal;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2860 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2861 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2862 аналогична директивам
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2863 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2864 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2865 error_page 404 = @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2866 log_not_found off;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2867 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2868 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2869 А здесь
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2870 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2871 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2872 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2873
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2874 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2875
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2876 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2877
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2878 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2879 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2880 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2881 <literal>try_files</literal> проверяет существование PHP-файла,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2882 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2883 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2884
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2885 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2886 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2887 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2888 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2889 try_files $uri $uri/ @wordpress;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2890 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2891
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2892 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2893 try_files $uri @wordpress;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2894
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2895 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2896
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2897 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2898 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2899 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2900
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2901 location @wordpress {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2902 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2903
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2904 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2905 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2906 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2907 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2908 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2909
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2910 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2911
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2912
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2913 <directive name="types">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	2914 <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	2915 <default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2916 text/html html;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2917 image/gif gif;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2918 image/jpeg jpg;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2919 </default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2920 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2921 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2922 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2923
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2924 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2925 Задаёт соответствие расширений имён файлов и MIME-типов ответов.
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 Одному MIME-типу может соответствовать несколько расширений, например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2928 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2929 types {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2930 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	2931 application/octet-stream deb;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2932 application/octet-stream dmg;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2933 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2934 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2935 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2936
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2937 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2938 Достаточно полная таблица соответствий входит в дистрибутив nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2939 и находится в файле <path>conf/mime.types</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2940 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2941
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2942 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 958 diff changeset	2943 Для того чтобы для определённого location’а для всех ответов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2944 выдавался 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	2945 можно использовать следующее:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2946 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2947 location /download/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2948 types { }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2949 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	2950 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2951 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2952 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2953
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2954 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2955
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2956
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2957 <directive name="types_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2958 <syntax><value>размер</value></syntax>
1132 8bdb4eb27f48 Documented the new default of "types_hash_bucket_size". Ruslan Ermilov <ru@nginx.com> parents: 1108 diff changeset	2959 <default>64</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2960 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2961 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2962 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2963
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2964 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2965 Задаёт размер корзины в хэш-таблицах типов.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2966 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2967 <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	2968 <note>
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size". Ruslan Ermilov <ru@nginx.com> parents: 1108 diff changeset	2969 До версии 1.5.13
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size". Ruslan Ermilov <ru@nginx.com> parents: 1108 diff changeset	2970 значение по умолчанию зависело от размера строки кэша процессора.
8bdb4eb27f48 Documented the new default of "types_hash_bucket_size". Ruslan Ermilov <ru@nginx.com> parents: 1108 diff changeset	2971 </note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2972 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2973
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2974 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2975
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2976
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2977 <directive name="types_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2978 <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	2979 <default>1024</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2980 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2981 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2982 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2983
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2984 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2985 Задаёт максимальный <value>размер</value> хэш-таблиц типов.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2986 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2987 <link doc="../hash.xml">документе</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2988 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2989
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2990 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2991
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2992
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2993 <directive name="underscores_in_headers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2994 <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	2995 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2996 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2997 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2998
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2999 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3000 Разрешает или запрещает использование символов подчёркивания в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3001 полях заголовка запроса клиента.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	3002 Если использование символов подчёркивания запрещено, поля заголовка запроса, в
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	3003 именах которых есть подчёркивания,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3004 помечаются как недопустимые и подпадают под действие директивы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3005 <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	3006 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3007
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	3008 <para>
1023 375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	3009 Если директива указана на уровне <link id="server"/>,
2795 691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	3010 то может использоваться значение из сервера по умолчанию.
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	3011 Подробнее см. в разделе
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	3012 “<link doc="server_names.xml" id="virtual_server_selection">Выбор
691de23367a7 Added link to "Virtual server Selection" in buffer directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 2793 diff changeset	3013 виртуального сервера</link>”.
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	3014 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	3015
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3016 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3017
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3018
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3019 <directive name="variables_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3020 <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	3021 <default>64</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3022 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3023
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3024 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3025 Задаёт размер корзины в хэш-таблице переменных.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	3026 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	3027 <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	3028 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3029
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3030 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3031
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3032
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3033 <directive name="variables_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3034 <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	3035 <default>1024</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3036 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3037
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3038 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3039 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	3040 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	3041 <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	3042 <note>
a0543e9213e7 New default value for the variables_hash_max_size directive. Andrei Belov <defan@nginx.com> parents: 1097 diff changeset	3043 До версии 1.5.13 по умолчанию использовалось значение 512.
a0543e9213e7 New default value for the variables_hash_max_size directive. Andrei Belov <defan@nginx.com> parents: 1097 diff changeset	3044 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3045 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3046
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3047 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3048
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3049 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3050
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	3051
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3052 <section id="variables" name="Встроенные переменные">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3053
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3054 <para>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	3055 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	3056 переменные, имена которых совпадают с именами переменных веб-сервера Apache.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3057 Прежде всего, это переменные, представляющие из себя поля заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3058 запроса клиента, такие как <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	3059 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3060 Кроме того, есть и другие переменные:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3061 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3062
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3063 <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	3064 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3065 аргумент <value>имя</value> в строке запроса
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3066 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3067
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3068 <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	3069 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3070 аргументы в строке запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3071 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3072
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3073 <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	3074 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3075 адрес клиента в бинарном виде, длина значения всегда 4 байта
1699 6c96a644b0b3 Corrected description of $binary_remote_addr and saved state. Yaroslav Zhuravlev <yar@nginx.com> parents: 1692 diff changeset	3076 для IPv4-адресов или 16 байт для IPv6-адресов
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3077 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 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_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	3080 <tag-desc>
769 d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3081 число байт, переданное клиенту, без учёта заголовка ответа;
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3082 переменная совместима с параметром “<literal>%B</literal>” модуля Apache
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3083 <literal>mod_log_config</literal>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3084 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3085
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3086 <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	3087 <tag-desc>
1769 cc9d4e09a708 Corrected Russian language in $bytes_sent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1763 diff changeset	3088 число байт, переданных клиенту (1.3.8, 1.2.5)
769 d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3089 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3090
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3091 <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	3092 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3093 порядковый номер соединения (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	3094 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3095
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3096 <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	3097 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3098 текущее число запросов в соединении (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	3099 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3100
2707 c1d62e514b3c Documented the $connection_time variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2706 diff changeset	3101 <tag-name id="var_connection_time"><var>$connection_time</var></tag-name>
c1d62e514b3c Documented the $connection_time variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2706 diff changeset	3102 <tag-desc>
c1d62e514b3c Documented the $connection_time variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2706 diff changeset	3103 время соединения в секундах с точностью до миллисекунд (1.19.10)
c1d62e514b3c Documented the $connection_time variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2706 diff changeset	3104 </tag-desc>
c1d62e514b3c Documented the $connection_time variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2706 diff changeset	3105
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3106 <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	3107 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3108 поле <header>Content-Length</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3109 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3110
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3111 <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	3112 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3113 поле <header>Content-Type</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3114 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3115
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3116 <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	3117 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3118 cookie <value>имя</value>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3119 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3120
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3121 <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	3122 <tag-desc>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	3123 значение директивы <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	3124 для текущего запроса
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3125 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3126
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3127 <tag-name id="var_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	3128 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3129 то же, что и <var>$uri</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3130 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3131
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3132 <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	3133 <tag-desc>
940 ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	3134 в порядке приоритета:
ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	3135 имя хоста из строки запроса, или
ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	3136 имя хоста из поля <header>Host</header> заголовка запроса, или
ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	3137 имя сервера, соответствующего запросу
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3138 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3139
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3140 <tag-name id="var_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	3141 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3142 имя хоста
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3143 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3144
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3145 <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	3146 <tag-desc>
448 92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	3147 произвольное поле заголовка запроса;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	3148 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	3149 к нижнему регистру, с заменой символов тире на символы подчёркивания
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3150 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3151
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3152 <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	3153 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3154 “<literal>on</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3155 если соединение работает в режиме SSL,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3156 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3157 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3158
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3159 <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	3160 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3161 “<literal>?</literal>”, если в строке запроса есть аргументы,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3162 и пустая строка, если их нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3163 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3164
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3165 <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	3166 <tag-desc>
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	3167 установка этой переменной позволяет ограничивать скорость
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	3168 передачи ответа, см. <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	3169 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3170
771 47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	3171 <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	3172 <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	3173 текущее время в секундах с точностью до миллисекунд (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	3174 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	3175
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3176 <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	3177 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3178 версия nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3179 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3180
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3181 <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	3182 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3183 номер (PID) рабочего процесса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3184 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3185
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3186 <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	3187 <tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3188 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3189 (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	3190 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3191
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3192 <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	3193 <tag-desc>
2457 3896055c397e Fixed descriptions of $proxy_protocol_addr and $proxy_protocol_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2452 diff changeset	3194 адрес клиента, полученный из заголовка протокола PROXY (1.5.12)
1097 eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3195 <para>
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3196 Протокол PROXY должен быть предварительно включён при помощи установки
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3197 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3198 </para>
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3199 </tag-desc>
eeb690d4212b Documented the PROXY protocol support. Yaroslav Zhuravlev <yar@nginx.com> parents: 1037 diff changeset	3200
1704 792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3201 <tag-name id="var_proxy_protocol_port"><var>$proxy_protocol_port</var></tag-name>
792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3202 <tag-desc>
2457 3896055c397e Fixed descriptions of $proxy_protocol_addr and $proxy_protocol_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2452 diff changeset	3203 порт клиента, полученный из заголовка протокола PROXY (1.11.0)
1704 792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3204 <para>
792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3205 Протокол PROXY должен быть предварительно включён при помощи установки
792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3206 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3207 </para>
792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3208 </tag-desc>
792478434bb1 Documented the $proxy_protocol_port variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1699 diff changeset	3209
2458 9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3210 <tag-name id="var_proxy_protocol_server_addr"><var>$proxy_protocol_server_addr</var></tag-name>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3211 <tag-desc>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3212 адрес сервера, полученный из заголовка протокола PROXY (1.17.6)
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3213 <para>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3214 Протокол PROXY должен быть предварительно включён при помощи установки
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3215 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3216 </para>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3217 </tag-desc>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3218
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3219 <tag-name id="var_proxy_protocol_server_port"><var>$proxy_protocol_server_port</var></tag-name>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3220 <tag-desc>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3221 порт сервера, полученный из заголовка протокола PROXY (1.17.6)
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3222 <para>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3223 Протокол PROXY должен быть предварительно включён при помощи установки
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3224 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3225 </para>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3226 </tag-desc>
9cd5883ac546 Documented $proxy_protocol_server_addr, $proxy_protocol_server_port. Yaroslav Zhuravlev <yar@nginx.com> parents: 2457 diff changeset	3227
2903 44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3228 <tag-name id="var_proxy_protocol_tlv_"><var>$proxy_protocol_tlv_</var><value>имя</value></tag-name>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3229 <tag-desc>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3230 TLV, полученный из заголовка протокола PROXY (1.23.2).
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3231 <literal>Имя</literal> может быть именем типа TLV или его числовым значением.
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3232 В последнем случае значение задаётся в шестнадцатеричном виде
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3233 и должно начинаться с <literal>0x</literal>:
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3234
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3235 <example>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3236 $proxy_protocol_tlv_alpn
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3237 $proxy_protocol_tlv_0x01
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3238 </example>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3239 SSL TLV могут также быть доступны как по имени типа TLV,
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3240 так и по его числовому значению,
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3241 оба должны начинаться с <literal>ssl_</literal>:
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3242 <example>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3243 $proxy_protocol_tlv_ssl_version
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3244 $proxy_protocol_tlv_ssl_0x21
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3245 </example>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3246
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3247 <para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3248 Поддерживаются следующие имена типов TLV:
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3249 <list type="bullet">
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3250
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3251 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3252 <literal>alpn</literal> (<literal>0x01</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3253 протокол более высокого уровня, используемый поверх соединения
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3254 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3255
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3256 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3257 <literal>authority</literal> (<literal>0x02</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3258 значение имени хоста, передаваемое клиентом
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3259 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3260
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3261 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3262 <literal>unique_id</literal> (<literal>0x05</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3263 уникальный идентификатор соединения
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3264 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3265
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3266 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3267 <literal>netns</literal> (<literal>0x30</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3268 имя пространства имён
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3269 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3270
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3271 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3272 <literal>ssl</literal> (<literal>0x20</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3273 структура SSL TLV в бинарном виде
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3274 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3275
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3276 </list>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3277 </para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3278
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3279 <para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3280 Поддерживаются следующие имена типов SSL TLV:
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3281 <list type="bullet">
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3282
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3283 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3284 <literal>ssl_version</literal> (<literal>0x21</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3285 версия SSL, используемая в клиентском соединении
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3286 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3287
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3288 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3289 <literal>ssl_cn</literal> (<literal>0x22</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3290 Common Name сертификата
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3291 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3292
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3293 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3294 <literal>ssl_cipher</literal> (<literal>0x23</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3295 имя используемого шифра
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3296 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3297
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3298 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3299 <literal>ssl_sig_alg</literal> (<literal>0x24</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3300 алгоритм, используемый для подписи сертификата
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3301 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3302
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3303 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3304 <literal>ssl_key_alg</literal> (<literal>0x25</literal>)—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3305 алгоритм публичного ключа
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3306 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3307
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3308 </list>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3309 </para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3310
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3311 <para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3312 Также поддерживается следующее специальное имя типа SSL TLV:
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3313 <list type="bullet">
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3314
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3315 <listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3316 <literal>ssl_verify</literal>—
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3317 результат проверки клиентского сертификата:
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3318 <literal>0</literal>, если клиент предоставил сертификат
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3319 и он был успешно верифицирован,
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3320 либо ненулевое значение
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3321 </listitem>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3322
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3323 </list>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3324 </para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3325
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3326 <para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3327 Протокол PROXY должен быть предварительно включён при помощи установки
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3328 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3329 </para>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3330 </tag-desc>
44f3b52c0679 Documented the $proxy_protocol_tlv_ variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 2870 diff changeset	3331
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3332 <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	3333 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3334 то же, что и <var>$args</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3335 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3336
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3337 <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	3338 <tag-desc>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	3339 абсолютный путь, соответствующий
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	3340 значению директивы <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	3341 для текущего запроса,
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	3342 в котором все символические ссылки преобразованы в реальные пути
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3343 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3344
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3345 <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	3346 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3347 адрес клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3348 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3349
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3350 <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	3351 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3352 порт клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3353 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3354
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3355 <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	3356 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3357 имя пользователя, использованное в Basic аутентификации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3358 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3359
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3360 <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	3361 <tag-desc>
431 0412333658fe Consistent translation of "original". Ruslan Ermilov <ru@nginx.com> parents: 429 diff changeset	3362 первоначальная строка запроса целиком
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3363 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3364
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3365 <tag-name id="var_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	3366 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3367 тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3368 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	3369 Значение переменной появляется в location’ах, обрабатываемых
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3370 директивами
1181 b8f0362f61e5 Added links to scgi. Yaroslav Zhuravlev <yar@nginx.com> parents: 1132 diff changeset	3371 <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	3372 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
9264fdb6c833 Added links to uwsgi. Ruslan Ermilov <ru@nginx.com> parents: 1181 diff changeset	3373 <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	3374 и
1732 5eb54b170c74 Clarified cases when $request_body is not empty. Yaroslav Zhuravlev <yar@nginx.com> parents: 1721 diff changeset	3375 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
5eb54b170c74 Clarified cases when $request_body is not empty. Yaroslav Zhuravlev <yar@nginx.com> parents: 1721 diff changeset	3376 когда тело было прочитано в
5eb54b170c74 Clarified cases when $request_body is not empty. Yaroslav Zhuravlev <yar@nginx.com> parents: 1721 diff changeset	3377 <link id="client_body_buffer_size">буфер в памяти</link>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3378 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3379 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3380
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3381 <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	3382 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3383 имя временного файла, в котором хранится тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3384 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	3385 По завершении обработки файл необходимо удалить.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 958 diff changeset	3386 Для того чтобы тело запроса всегда записывалось в файл,
406 98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them. Ruslan Ermilov <ru@nginx.com> parents: 400 diff changeset	3387 следует включить <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	3388 При передаче имени временного файла в проксированном запросе
1194 9264fdb6c833 Added links to uwsgi. Ruslan Ermilov <ru@nginx.com> parents: 1181 diff changeset	3389 или в запросе к FastCGI/uwsgi/SCGI-серверу следует запретить передачу самого
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3390 тела директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3391 <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	3392 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	3393 <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	3394 fastcgi_pass_request_body off</link>,
9264fdb6c833 Added links to uwsgi. Ruslan Ermilov <ru@nginx.com> parents: 1181 diff changeset	3395 <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	3396 uwsgi_pass_request_body off</link>
1181 b8f0362f61e5 Added links to scgi. Yaroslav Zhuravlev <yar@nginx.com> parents: 1132 diff changeset	3397 или
b8f0362f61e5 Added links to scgi. Yaroslav Zhuravlev <yar@nginx.com> parents: 1132 diff changeset	3398 <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	3399 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	3400 соответственно.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3401 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3402 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3403
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3404 <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	3405 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3406 “<literal>OK</literal>” если запрос завершился,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3407 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3408 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3409
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3410 <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	3411 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3412 путь к файлу для текущего запроса, формируемый из директив
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3413 <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	3414 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3415
1692 4319f72f11f5 Documented the $request_id variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1680 diff changeset	3416 <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	3417 <tag-desc>
1721 737c86e8b316 Clarified meaning of the $request_id variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1704 diff changeset	3418 уникальный идентификатор запроса,
737c86e8b316 Clarified meaning of the $request_id variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1704 diff changeset	3419 сформированный из 16 случайных байт, в шестнадцатеричном виде (1.11.0)
1692 4319f72f11f5 Documented the $request_id variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1680 diff changeset	3420 </tag-desc>
4319f72f11f5 Documented the $request_id variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1680 diff changeset	3421
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3422 <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	3423 <tag-desc>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3424 длина запроса (включая строку запроса, заголовок и тело запроса)
9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3425 (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	3426 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3427
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3428 <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	3429 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3430 метод запроса, обычно
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3431 “<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	3432 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3433
771 47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	3434 <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	3435 <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	3436 время обработки запроса в секундах с точностью до миллисекунд
32b8498cfb40 $msec and $request_time have become generic variables in 1.2.6. Ruslan Ermilov <ru@nginx.com> parents: 771 diff changeset	3437 (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	3438 время, прошедшее с момента чтения первых байт от клиента
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	3439 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	3440
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3441 <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	3442 <tag-desc>
431 0412333658fe Consistent translation of "original". Ruslan Ermilov <ru@nginx.com> parents: 429 diff changeset	3443 первоначальный URI запроса целиком (с аргументами)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3444 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3445
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3446 <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	3447 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3448 схема запроса, “<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	3449 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3450
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3451 <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	3452 <tag-desc>
448 92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	3453 произвольное поле заголовка ответа;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	3454 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	3455 к нижнему регистру, с заменой символов тире на символы подчёркивания
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3456 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3457
2003 be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3458 <tag-name id="var_sent_trailer_"><var>$sent_trailer_</var><value>имя</value></tag-name>
be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3459 <tag-desc>
be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3460 произвольное поле, отправленное в конце ответа (1.13.2);
be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3461 последняя часть имени переменной соответствует имени поля, приведённому
be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3462 к нижнему регистру, с заменой символов тире на символы подчёркивания
be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3463 </tag-desc>
be779702663e Documented the "sent_trailer_" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1964 diff changeset	3464
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3465 <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	3466 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3467 адрес сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3468 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3469 Получение значения этой переменной обычно требует одного системного вызова.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3470 Чтобы избежать системного вызова, в директивах <link id="listen"/>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3471 следует указывать адреса и использовать параметр <literal>bind</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3472 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3473 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3474
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3475 <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	3476 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3477 имя сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3478 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3479
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3480 <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	3481 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3482 порт сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3483 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3484
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3485 <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	3486 <tag-desc>
1597 8b97ba73129b Added HTTP/2.0 to the "server_protocol" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1576 diff changeset	3487 протокол запроса, обычно
8b97ba73129b Added HTTP/2.0 to the "server_protocol" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1576 diff changeset	3488 “<literal>HTTP/1.0</literal>”,
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	3489 “<literal>HTTP/1.1</literal>”,
a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	3490 “<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	3491 или
2956 a85e4d126bc7 Updated docs for the upcoming NGINX Plus release. Yaroslav Zhuravlev <yar@nginx.com> parents: 2921 diff changeset	3492 “<link doc="ngx_http_v3_module.xml">HTTP/3.0</link>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3493 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3494
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3495 <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	3496 <tag-desc>
769 d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3497 статус ответа (1.3.2, 1.2.2)
541 a8971cf346be Documented the $status core variable. Andrey Belov <defan@nginx.com> parents: 537 diff changeset	3498 </tag-desc>
a8971cf346be Documented the $status core variable. Andrey Belov <defan@nginx.com> parents: 537 diff changeset	3499
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3500 <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	3501 <tag-desc>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3502 локальное время в формате по стандарту 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	3503 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3504
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3505 <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	3506 <tag-desc>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3507 локальное время в 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	3508 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3509
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3510 <tag-name id="var_tcpinfo_">
453 98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3511 <var>$tcpinfo_rtt</var>,
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3512 <var>$tcpinfo_rttvar</var>,
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3513 <var>$tcpinfo_snd_cwnd</var>,
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3514 <var>$tcpinfo_rcv_space</var>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3515 </tag-name>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3516 <tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3517 информация о клиентском TCP-соединении; доступна на системах,
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	3518 поддерживающих параметр сокета <c-def>TCP_INFO</c-def>
453 98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3519 </tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3520
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3521 <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	3522 <tag-desc>
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3523 текущий 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	3524 <para>
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3525 Значение <var>$uri</var> может изменяться в процессе обработки запроса,
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3526 например, при внутренних перенаправлениях
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3527 или при использовании индексных файлов.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3528 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3529 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3530
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3531 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3532 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3533
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3534 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3535
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3536 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 2976:cbd963190c15