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

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 397:f1c0ae9c1c48

FreeBSD 10.0-CURRENT supports the TCP_KEEPIDLE, TCP_KEEPINTVL, and TCP_KEEPCNT socket options.

author	Ruslan Ermilov <ru@nginx.com>
date	Tue, 07 Feb 2012 09:31:45 +0000
parents	8ad9df891e23
children	eb993ee8c230

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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	4
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	5 <module name="Модуль ngx_http_core_module"
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	6 link="/ru/docs/http/ngx_http_core_module.html"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	7 lang="ru">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	9 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	10
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 <directive name="aio">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	12 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	13 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	14 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	15 <literal>sendfile</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	16 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	17 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	18 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	19 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	20 <appeared-in>0.8.11</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	21
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	22 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	23 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	24 во FreeBSD и Linux.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	25 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	26
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	27 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	28 Во FreeBSD AIO можно использовать, начиная с FreeBSD 4.3.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	29 AIO можно либо собрать в ядре статически:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	30 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	31 options VFS_AIO
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	32 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	33 либо загрузить динамически через загружаемый модуль ядра:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	34 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	35 kldload aio
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	36 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	37 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	38
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	39 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	40 В версиях FreeBSD 5 и 6 включение AIO статически или динамически
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	41 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	42 будет использовать блокировку Giant, что может негативно сказаться на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	43 производительности системы в целом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	44 Это ограничение устранено во 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	45 и во FreeBSD 7.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	46 Однако, начиная с FreeBSD 5.3 есть возможность включать AIO,
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	47 не связывая сетевую подсистему блокировкой Giant — для этого модуль
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	48 AIO нужно подгружать уже после загрузки ядра.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	49 В этом случае в <path>/var/log/messages</path> появится следующее сообщение:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	50 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	51 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	52 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	53 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	54 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	55 <note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	56 Требование использовать блокировку Giant в AIO связано с тем, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	57 FreeBSD поддерживает асинхронные вызовы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	58 <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	59 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	60 <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	61 для работы с сокетами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	62 Но поскольку nginx использует AIO только для работы с диском,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	63 то проблем не возникает.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	64 </note>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	65 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	66
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	67 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	68 Для работы AIO нужно выключить
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	69 <link id="sendfile"/>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	71 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	72 sendfile off;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	73 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	74 output_buffers 1 64k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	75 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	76 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	77 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	78
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	79 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	80 Кроме того, начиная с FreeBSD 5.2.1 и nginx 0.8.12, AIO также можно
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	81 использовать для подгрузки данных для <c-func>sendfile</c-func>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	82 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	83 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	84 sendfile on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	85 tcp_nopush on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	86 aio sendfile;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	87 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	88 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	89 В такой конфигурации функция <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	90 <c-def>SF_NODISKIO</c-def>, в результате она не блокируется на диске, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	91 сообщает об отсутствии данных в памяти, после чего nginx инициирует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	92 асинхронную подгрузку данных, читая только один байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	93 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	94 при последующих чтениях файл подгружается частями только по 16K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	95 Изменить это можно с помощью директивы
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	96 <link id="read_ahead"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	97 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	98
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	100 В Linux AIO можно использовать только начиная с версии ядра 2.6.22, и,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	101 кроме того, ещё необходимо дополнительно включать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	102 <link id="directio"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	103 иначе чтение будет блокирующимся:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	104 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	105 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	106 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	107 directio 512;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	108 output_buffers 1 128k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	109 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	111 </para>
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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	114 Поскольку
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	115 <link id="directio"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	116 в Linux можно использовать только для чтения блоков, выравненных
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	117 на границу 512 байт (или 4К для XFS), то невыравненный конец файла
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	118 будет читаться блокированно.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	119 То же относится к запросам с указанием диапазона запрашиваемых байт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	120 (byte-range requests) и к запросам FLV не с начала файла: чтение
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	121 невыравненных начала и конца ответа будет блокирующимся.
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 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	124 не нужно, так как при использовании
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	125 <link id="directio"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	126 он выключается автоматически.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	127 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	128
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	129 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	130
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	131
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	132 <directive name="alias">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	133 <syntax><value>путь</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	134 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	135 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	136
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	137 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	138 Задаёт замену для указанного location'а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	139 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	140 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	141 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	142 alias /data/w3/images/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	143 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	144 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	145 на запрос
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	146 “<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	147 <path>/data/w3/images/top.gif</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	148 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	149
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	150 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	151 В значении параметра <value>путь</value> можно использовать переменные,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	152 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	153 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	154
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	155 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	156 Если <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	157 регулярным выражением, то регулярное выражение должно содержать
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	158 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	159 (0.7.40), например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	160 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	161 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	162 alias /data/w3/images/$1;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	163 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	164 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	165 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	166
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	167 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	168 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	169 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	170 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	171 alias /data/w3/images/;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	172 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	173 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	174 то лучше воспользоваться директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	175 <link id="root"/>:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	176 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	177 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	178 root /data/w3;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	179 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	180 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	181 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	182
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	183 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	184
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	185
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	186 <directive name="chunked_transfer_encoding">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	187 <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	188 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	189 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	190 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	191 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	192
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	193 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	194 Позволяет запретить формат передачи данных частями (chunked transfer
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	195 encoding) в HTTP/1.1.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	196 Это может понадобиться при использовании программ, не поддерживающих
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	197 chunked encoding, несмотря на требования стандарта.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	198 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	199
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	200 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	201
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	202
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	203 <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	204
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	205 <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	206 <default>8k\|16k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	207 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	208 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	209 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	210
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	211 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	212 Задаёт размер буфера для чтения тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	213 Если тело запроса больше заданного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	214 то всё тело запроса или только его часть записывается во
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	215 <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	216 По умолчанию размер одного буфера равен двум размерам страницы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	217 На 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	218 На других 64-битных платформах это обычно 16K.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	220
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	221 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	222
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	223
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	224 <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	225 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	226 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	227 <literal>clean</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	228 <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	229 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	230 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	231 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	232 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	233
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	234 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	235 Определяет, сохранять ли всё тело запроса клиента в файл.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	236 Директиву можно использовать для отладки и при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	237 <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	238 или метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	239 <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	240 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	241 <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	242 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	243
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	244 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	245 При установке значения <literal>on</literal> временные файлы
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	246 по окончании обработки запроса не удаляются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	247 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	248
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	249 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	250 Значение <literal>clean</literal> разрешает удалять временные файлы,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	251 оставшиеся по окончании обработки запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	252 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	253
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	254 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	255
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	256
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	257 <directive name="client_body_in_single_buffer">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	258 <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	259 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	260 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	261 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	262 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	264 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	265 Определяет, сохранять ли всё тело запроса клиента в одном буфере.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	266 Директива рекомендуется при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	267 <var>$request_body</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	268 для уменьшения требуемого числа операций копирования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	269 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	270
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	271 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	272
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	273
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	274 <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	275 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	276 <value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	277 [<value>уровень1</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	278 [<value>уровень2</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	279 [<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	280 <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	281 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	282 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	283 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	284
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	285 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	286 Задаёт каталог для хранения временных файлов с телами запросов клиентов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	287 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	288 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	289 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	290 client_body_temp_path /spool/nginx/client_temp 1 2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	291 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	292 временный файл будет следующего вида:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	293 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	294 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	295 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	296 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	297
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	298 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	299
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	300
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	301 <directive name="client_body_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	302 <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	303 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	304 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	305 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	306 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	307
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	308 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	309 Задаёт таймаут при чтении тела запроса клиента.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	310 Таймаут устанавливается не на всю передачу тела запроса,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	311 а только между двумя последовательными операциями чтения.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	312 Если по истечении этого времени клиент ничего не передаст,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	313 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	314 <http-status code="408" text="Request Time-out"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	315 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	316
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	317 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	318
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	319
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	320 <directive name="client_header_buffer_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	321 <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	322 <default>1k</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	323 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	324 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	325
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	326 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	327 Задаёт размер буфера для чтения заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	328 Для большинства запросов достаточно буфера размером в 1K байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	329 Однако если в запросе есть длинные cookies, или же запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	330 пришёл от WAP-клиента, то он может не поместиться в 1K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	331 Поэтому, если строка запроса или поле заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	332 не помещаются полностью в этот буфер, то выделяются буферы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	333 большего размера, задаваемые директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	334 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	335 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	336
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	337 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	338
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 <directive name="client_header_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	341 <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	342 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	343 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	344 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	345
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	346 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	347 Задаёт таймаут при чтении заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	348 Если по истечении этого времени клиент не передаст полностью заголовок,
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 <http-status code="408" text="Request Time-out"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	351 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	352
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	353 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	356 <directive name="client_max_body_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	357 <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	358 <default>1m</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	359 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	360 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	361 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	362
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	363 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	364 Задаёт максимально допустимый размер тела запроса клиента,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	365 указываемый в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	366 <header>Content-Length</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	367 заголовка запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	368 Если размер больше заданного, то клиенту возвращается ошибка
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	369 <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	370 Следует иметь в виду, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	371 <!--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	372 эту ошибку<!--/link-->.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	373 Установка параметра <value>размер</value> в 0 отключает
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	374 проверку размера тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	375 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	376
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	377 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	378
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	379
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	380 <directive name="connection_pool_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	381 <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	382 <default>256</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	383 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	384 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	385
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	386 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	387 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	388 под конкретные соединения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	389 Эта директива не оказывает существенного влияния на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	390 производительность и её не следует использовать.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	391 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	392
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	393 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	394
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	395
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	396 <directive name="default_type">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	397 <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	398 <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	399 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	400 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	401 <context>location</context>
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	404 Задаёт MIME-тип ответов по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	405 См. также директиву <link id="types"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	406 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	407
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	408 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	411 <directive name="directio">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	412 <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	413 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	414 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	415 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	416 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	417 <appeared-in>0.7.7</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	418
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	419 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	420 Разрешает использовать флаги
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	421 <c-def>O_DIRECT</c-def> (FreeBSD, Linux),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	422 <c-def>F_NOCACHE</c-def> (Mac OS X)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	423 или функцию <c-func>directio</c-func> (Solaris)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	424 при чтении файлов, размер которых больше либо равен указанному.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	425 Директива автоматически запрещает (0.7.15) использование
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	426 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	427 для данного запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	428 Рекомендуется использовать для больших файлов:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	429 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	430 directio 4m;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	431 </example>
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	432 или при использовании <link id="aio"/> в Linux.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	433 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	434
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	435 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	436
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	437
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	438 <directive name="directio_alignment">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	439 <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	440 <default>512</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	441 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	442 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	443 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	444 <appeared-in>0.8.11</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	445
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	446 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	447 Устанавливает выравнивание для
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	448 <link id="directio"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	449 В большинстве случаев достаточно 512-байтового выравнивания, однако
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	450 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	451 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	452
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	453 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	456 <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	457 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	458 <value>код</value> ...
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	459 [<literal>=</literal>[<value>ответ</value>]]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	460 <value>uri</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	461 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	462 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	463 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	464 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	465 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	466
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	467 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	468 Задаёт URI, который будет показываться для указанных ошибок.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	469 Директивы <literal>error_page</literal> наследуются с предыдущего уровня
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	470 при условии, что на данном уровне не описаны свои директивы
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	471 <literal>error_page</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	472 В значении URI можно использовать переменные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	473 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	474
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	475 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	476 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	477 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	478 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	479 error_page 502 503 504 /50x.html;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	480 error_page 403 http://example.com/forbidden.html;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	481 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	482 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	483
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	484 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	485 Кроме того, можно поменять код ответа на другой, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	486 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	487 error_page 404 =200 /empty.gif;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	488 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	489 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	490
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	491 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	492 Если ошибочный ответ обрабатывается проксированным сервером или
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	493 FastCGI-сервером, и этот сервер может вернуть разные коды ответов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	494 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	495 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	496 error_page 404 = /404.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	497 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	498 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	499
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	500 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	501 Если при перенаправлении не нужно менять URI, то можно перенаправить
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	502 обработку ошибки в именованный location:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	503 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	504 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	505 error_page 404 = @fallback;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	506 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	507
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	508 location @fallback {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	509 proxy_pass http://backend;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	510 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	511 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	512 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	515
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	516
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	517 <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	518 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	519 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	520 <literal>exact</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	521 <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	522 <default>exact</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	523 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	524 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	525 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	526 <appeared-in>0.7.24</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	527
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	528 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	529 Определяет, как сравнивать время модификации ответа с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	530 временем в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	531 <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	532 заголовка запроса:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	533
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	534 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	535
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	536 <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	537 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	538 не проверять поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	539 <header>If-Modified-Since</header> заголовка запроса (0.7.34);
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	540 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	541
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	542 <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	543 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	544 точное совпадение;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	545 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	546
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	547 <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	548 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	549 время модификации ответа меньше или равно времени, заданному в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	550 <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	551 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	552
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	553 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	554 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	555
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	556 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	557
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	558
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	559 <directive name="ignore_invalid_headers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	560 <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	561 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	562 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	563 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	564
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	565 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	566 Если включено, nginx игнорирует поля заголовка с недопустимыми именами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	567 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	568 и возможно знаков подчёркивания (последнее контролируется директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	569 <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	570 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	571
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	572 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	573
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	574
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	575 <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	576 <syntax/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	577 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	578 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	579
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	580 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	581 Указывает, что location может использоваться только для внутренних запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	582 Для внешних запросов клиенту будет возвращаться ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	583 <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	584 Внутренними запросами являются:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	585
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	586 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	587
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	588 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	589 запросы, перенаправленные директивой <link id="error_page"/>;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	590 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	591
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	592 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	593 подзапросы, формируемые командой
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	594 “<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	595 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	596 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	597 ngx_http_ssi_module;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	598 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	599
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	600 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	601 запросы, изменённые директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	602 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	603 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	604
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	605 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	606 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	607
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	608 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	609 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	610 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	611 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	612
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	613 location /404.html {
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	614 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	615 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	616 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	617 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	618
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	619 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	620
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	621
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	622 <directive name="keepalive_disable">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	623 <syntax><literal>none</literal> \| <value>браузер</value> ...</syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	624 <default>msie6 safari</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	625 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	626 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	627 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	628
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	629 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	630 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	631 Параметры <value>браузер</value> указывают, на какие браузеры это
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	632 распространяется.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	633 Значение <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	634 со старыми версиями MSIE после получения запроса POST.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	635 Значение <literal>safari</literal> запрещает keep-alive соединения
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	636 с браузерами Safari.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	637 Значение <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	638 со всеми браузерами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	639 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	640
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	641 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	642
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	643
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	644 <directive name="keepalive_requests">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	645 <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	646 <default>100</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	647 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	648 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	649 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	650 <appeared-in>0.8.0</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	651
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	652 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	653 Задаёт максимальное число запросов, которые можно
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	654 сделать по одному keep-alive соединению.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	655 После того, как будет сделано максимальное число запросов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	656 соединение закрывается.
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	660
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	661
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	662 <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	663 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	664 <value>таймаут</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	665 [<value>заголовок_таймаута</value>]</syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	666 <default>75s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	667 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	668 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	669 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	670
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	671 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	672 Первый параметр задаёт таймаут, в течение которого keep-alive
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	673 соединение с клиентом не будет закрыто со стороны сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	674 Второй необязательный параметр задаёт значение в поле
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	675 <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	676 заголовка ответа.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	677 Два параметра могут отличаться друг от друга.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	678 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	679
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	680 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	681 Поле
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	682 <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	683 заголовка понимают Mozilla и Konqueror.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	684 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	685 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	686
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	687 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	688
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	689
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	690 <directive name="large_client_header_buffers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	691 <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	692 <default>4 8k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	693 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	694 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	695
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	696 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	697 Задаёт максимальное <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	698 буферов для чтения большого заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	699 Строка запроса не должна превышать размера одного буфера, иначе клиенту
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	700 возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	701 <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	702 Поле заголовка запроса также не должно превышать размера одного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	703 иначе клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	704 <http-status code="400" text="Bad Request"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	705 Буферы выделяются только по мере необходимости.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	706 По умолчанию размер одного буфера равен 8K байт.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	707 Если по окончании обработки запроса соединение переходит в состояние
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	708 keep-alive, эти буферы освобождаются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	709 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	710
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	711 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	712
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	713
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	714 <directive name="limit_except">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	715 <syntax block="yes"><value>метод</value> ...</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	716 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	717 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	718
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	719 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	720 Ограничивает HTTP-методы, доступные внутри location.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	721 Параметр <value>метод</value> может быть одним из
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	722 <literal>GET</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	723 <literal>HEAD</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	724 <literal>POST</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	725 <literal>PUT</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	726 <literal>DELETE</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	727 <literal>MKCOL</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	728 <literal>COPY</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	729 <literal>MOVE</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	730 <literal>OPTIONS</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	731 <literal>PROPFIND</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	732 <literal>PROPPATCH</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	733 <literal>LOCK</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	734 <literal>UNLOCK</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	735 или
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	736 <literal>PATCH</literal>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	737 Если разрешён метод <literal>GET</literal>, то метод
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	738 <literal>HEAD</literal> также будет разрешён.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	739 Доступ к остальным методам может быть ограничен при помощи директив модулей
79 0a45870d0160 Fixed cross-document links to use doc and id. Maxim Dounin <mdounin@mdounin.ru> parents: 76 diff changeset	740 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	741 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	742 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	743 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	744 limit_except GET {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	745 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	746 deny all;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	747 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	748 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	749 Обратите внимание, что данное ограничение действует для всех методов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	750 <emphasis>кроме</emphasis> GET и HEAD.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	751 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	752
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	753 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	754
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	755
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	756 <directive name="limit_rate">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	757 <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	758 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	759 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	760 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	761 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	762 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	763
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	764 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	765 Ограничивает скорость передачи ответа клиенту.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	766 Скорость задаётся в байтах в секунду.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	767 Значение 0 (установка по умолчанию) отключает ограничение скорости.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	768 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	769 Чем меньше скорость, тем более аккуратным будет ограничение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	770 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	771 Ограничение срабатывает только для одного соединения, то есть если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	772 клиент откроет 2 соединения, то суммарная скорость будет в 2 раза
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	773 выше заданного ограничения.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	774 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	775
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	776 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	777 Если необходимо ограничить скорость для части клиентов на уровне
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	778 <link id="server">сервера</link>, то директива <literal>limit_rate</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	779 для этого не подходит.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	780 Вместо этого следует задать желаемое ограничение скорости в переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	781 <var>$limit_rate</var>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	782 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	783 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	784
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	785 if ($slow) {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	786 set $limit_rate 4k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	787 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	788
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	789 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	790 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	791 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	792 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	793
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	794 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	795
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	796
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	797 <directive name="limit_rate_after">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	798 <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	799 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	800 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	801 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	802 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	803 <context>if в location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	804 <appeared-in>0.8.0</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	805
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	806 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	807 Задаёт начальный объём данных, после передачи которого начинает
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	808 ограничиваться скорость передачи ответа клиенту.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	809 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	810
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	811 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	812 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	813 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	814 location /flv/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	815 flv;
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	816 limit_rate_after 500k;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	817 limit_rate 50k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	818 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	819 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	820 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	821
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	822 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	823
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	824
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	825 <directive name="lingering_close">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	826 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	827 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	828 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	829 <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	830 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	831 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	832 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	833 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	834 <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	835 <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	836
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	837 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	838 Управляет закрытием соединений с клиентами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	839 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	840
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	841 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	842 Со значением по умолчанию “<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	843 <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	844 <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	845 поступающие от клиента, перед полным закрытием соединения, но только
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	846 если эвристика указывает на то, что клиент может ещё послать данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	847 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	848
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	849 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	850 Со значением “<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	851 ждать и обрабатывать дополнительные данные, поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	852 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	853
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	854 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	855 Со значением “<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	856 дополнительных данных и сразу же закроет соединение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	857 Это нарушает протокол, поэтому не следует это использовать без нужды.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	858 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	859
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	860 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	861
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	862
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	863 <directive name="lingering_time">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	864 <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	865 <default>30s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	866 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	867 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	868 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	869
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	870 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	871 Если действует <link id="lingering_close"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	872 эта директива задаёт максимальное время, в течение которого nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	873 будет обрабатывать (читать и игнорировать) дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	874 поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	875 По прошествии этого времени соединение будет закрыто, даже если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	876 будут ещё данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	877 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	878
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	879 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	880
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	881
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	882 <directive name="lingering_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	883 <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	884 <default>5s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	885 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	886 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	887 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	888
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	889 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	890 Если действует <link id="lingering_close"/>, эта директива задаёт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	891 максимальное время ожидания поступления дополнительных данных от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	892 Если в течение этого времени данные не были получены, соединение закрывается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	893 Иначе данные читаются и игнорируются, затем nginx снова ждёт поступления данных.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	894 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	895 директивой <link id="lingering_time"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	896 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	897
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	898 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	899
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	900
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	901 <directive name="listen">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	902 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	903 <value>адрес</value>[:<value>порт</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	904 [<literal>default_server</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	905 [<literal>setfib</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	906 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	907 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	908 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	909 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	910 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	911 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	912 [<literal>ipv6only</literal>=<literal>on</literal>\|<literal>off</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	913 [<literal>ssl</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	914 [<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	915 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	916 <value>порт</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	917 [<literal>default_server</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	918 [<literal>setfib</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	919 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	920 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	921 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	922 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	923 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	924 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	925 [<literal>ipv6only</literal>=<literal>on</literal>\|<literal>off</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	926 [<literal>ssl</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	927 [<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	928 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	929 <literal>unix:</literal><value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	930 [<literal>default_server</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	931 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	932 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	933 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	934 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	935 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	936 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	937 [<literal>ssl</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	938 [<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	939 <default>:80 \| :8000</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	940 <context>server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	941
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	942 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	943 Задаёт <value>адрес</value> и <value>порт</value> для IP
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	944 или <value>путь</value> для UNIX-сокета,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	945 на которых сервер будет принимать запросы.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	946 Можно указать только <value>адрес</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	947 или только <value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	948 Кроме того, <value>адрес</value> может быть именем хоста, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	949 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	950 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	951 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	952 listen 8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	953 listen *:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	954 listen localhost:8000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	955 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	956 IPv6-адреса (0.7.36) задаются в квадратных скобках:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	957 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	958 listen [::]:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	959 listen [fe80::1];
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	960 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	961 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	962 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	963 listen unix:/var/run/nginx.sock;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	964 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	965 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	966
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	967 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	968 Если указан только <value>адрес</value>, то используется порт 80.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	969 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	970
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	971 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	972 Если директива не указана, то используется либо <literal>*:80</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	973 (если nginx работает с привилегиями суперпользователя),
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	974 либо <literal>*:8000</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	975 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	976
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	977 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	978 Если у директивы есть параметр <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	979 в котором описана эта директива, будет сервером по умолчанию для указанной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	980 <value>адрес</value>:<value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	981 Если же директив с параметром <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	982 сервером по умолчанию будет первый сервер, в котором описана пара
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	983 <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	984 адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	985 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	986 До версии 0.8.21 этот параметр назывался просто
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	987 <literal>default</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	988 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	989 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	990
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	991 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	992 В директиве <literal>listen</literal> можно также указать несколько
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	993 дополнительных параметров, специфичных для системных вызовов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	994 <c-func>listen</c-func> и <c-func>bind</c-func>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	995 Эти параметры можно задать в любой директиве <literal>listen</literal>,
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 <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	998 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	999 До версии 0.8.21 их можно было указывать лишь в директиве
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1000 <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	1001 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1002 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1003
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1004 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1005 <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	1006 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1007 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1008 этот параметр (0.8.44) задаёт для слушающего сокета соответствующую
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1009 таблицу маршрутизации (FIB).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1010 В настоящий момент это работает только на FreeBSD.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1011 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1012
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1013 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1014 <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	1015 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1016 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1017 задаёт параметр <literal>backlog</literal> в вызове
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1018 <c-func>listen</c-func>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1019 По умолчанию <literal>backlog</literal> равен -1 для FreeBSD
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1020 и 511 для других платформ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1021 </tag-desc>
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 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1024 <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	1025 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1026 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1027 задаёт параметр <c-def>SO_RCVBUF</c-def> для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1028 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1029
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1030 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1031 <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	1032 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1033 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1034 задаёт параметр <c-def>SO_SNDBUF</c-def> для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1035 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1036
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1037 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1038 <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	1039 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1040 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1041 задаёт название accept-фильтра.
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1042 Работает только на FreeBSD, можно использовать два фильтра —
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1043 <literal>dataready</literal> и <literal>httpready</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1044 По сигналу <c-def>SIGHUP</c-def> accept-фильтр можно менять только в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1045 последних версиях FreeBSD, начиная с 6.0, 5.4-STABLE и 4.11-STABLE.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1046 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1047
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1048 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1049 <literal>deferred</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1050 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1051 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1052 указывает использовать отложенный <c-func>accept</c-func> на Linux
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1053 с помощью опции <c-def>TCP_DEFER_ACCEPT</c-def>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1054 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1055
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1056 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1057 <literal>bind</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1058 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1059 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1060 указывает, что для данной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1061 <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	1062 <c-func>bind</c-func> отдельно.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1063 Дело в том, что если описаны несколько директив <literal>listen</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1064 с одинаковым портом, но разными адресами и одна из директив
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1065 <literal>listen</literal> слушает на всех адресах для данного порта
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1066 (<literal>*:</literal><value>порт</value>, то nginx сделает
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1067 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1068 Необходимо заметить, что в этом случае для определения адреса, на которой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1069 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1070 Если же используются параметры <literal>backlog</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1071 <literal>rcvbuf</literal>, <literal>sndbuf</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1072 <literal>accept_filter</literal>, <literal>deferred</literal>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1073 или <literal>so_keepalive</literal>, то для данной пары
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1074 <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	1075 отдельный вызов <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	1076 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1077
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1078 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1079 <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	1080 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1081 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1082 параметр (0.7.42) задаёт значение параметра <c-def>IPV6_V6ONLY</c-def>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1083 для слушающего сокета.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1084 Установить этот параметр можно только один раз на старте.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1085 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1086
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1087 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1088 <literal>ssl</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1089 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1090 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1091 этот параметр (0.7.14) не имеет отношения к системным вызовам
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1092 <c-func>listen</c-func> и <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	1093 что все соединения, принимаемые на этом порту, должны работать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1094 в режиме SSL.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1095 Это позволяет задать компактную конфигурацию для сервера,
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1096 работающего сразу в двух режимах — HTTP и HTTPS.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1097 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1098 listen 80;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1099 listen 443 default ssl;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1100 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1101 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1102
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1103 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1104 <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	1105 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1106 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1107 этот параметр (1.1.11) конфигурирует для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1108 поведение “TCP keepalive”.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1109 Если этот параметр опущен, то для сокета будут действовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1110 стандартные системные настройки.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1111 Если он установлен в значение “<literal>on</literal>”, то для сокета
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1112 включается опция <c-def>SO_KEEPALIVE</c-def>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1113 Если он установлен в значение “<literal>off</literal>”, то для сокета
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1114 опция <c-def>SO_KEEPALIVE</c-def> выключается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1115 Некоторые операционные системы поддерживают настройку параметров
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1116 “TCP keepalive” на уровне сокета посредством опций
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1117 <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	1118 <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	1119 На таких системах (в настоящий момент это Linux 2.4+, NetBSD 5+ и
f1c0ae9c1c48 FreeBSD 10.0-CURRENT supports the TCP_KEEPIDLE, TCP_KEEPINTVL, and Ruslan Ermilov <ru@nginx.com> parents: 381 diff changeset	1120 FreeBSD 10.0-CURRENT)
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1121 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1122 <value>keepintvl</value> и <value>keepcnt</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1123 Один или два параметра могут быть опущены, в таком случае для
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1124 соответствующей опции сокета будут действовать стандартные
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1125 системные настройки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1126 Например,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1127 <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	1128 установит таймаут бездействия (<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	1129 для интервала проб (<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	1130 стандартная системная настройка, а счётчик проб (<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	1131 будет равен 10.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1132 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1133
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1134 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1135 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1136
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1137 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1138 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1139 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1140 listen 127.0.0.1 default accept_filter=dataready backlog=1024;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1141 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1142 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1143
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1144 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1145
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1146
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1147 <directive name="location">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1148 <syntax block="yes">[
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1149 <literal>=</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1150 <literal>~</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1151 <literal>~*</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1152 <literal>^~</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1153 ] <value>uri</value></syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1154 <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	1155 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1156 <context>server</context>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1157 <context>location</context>
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 Устанавливает конфигурацию в зависимости от URI запроса.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1161 location можно задать префиксной строкой или регулярным выражением.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1162 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1163 (для поиска совпадения без учёта регистра символов),
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1164 либо с префиксом “<literal>~</literal>” (с учётом регистра).
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1165 Чтобы найти location, соответствующий запросу, вначале проверяются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1166 location'ы, заданные префиксными строками (префиксные location'ы).
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1167 Среди них ищется максимальное совпадение.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1168 Затем проверяются регулярные выражения, в порядке их следования
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1169 в конфигурационном файле.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1170 Проверка регулярных выражений прекращается после первого же совпадения,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1171 и используется соответствующая конфигурация.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1172 Если совпадение с регулярным выражением не найдено, то используется
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1173 конфигурация максимально совпавшего префиксного location'а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1174 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1175
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1176 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1177 location'ы могут быть вложенными, с некоторыми исключениями,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1178 о которых говорится ниже.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1179 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1180
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1181 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1182 Для операционных систем, нечувствительных к регистру символов, таких
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1183 как Mac OS X и Cygwin, сравнение с префиксными строками производится
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1184 без учёта регистра (0.7.7).
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1185 Однако, сравнение ограничено только однобайтными locale'ями.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1186 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1187
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1188 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1189 Регулярные выражения могут содержать выделения (0.7.40), которые могут
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1190 затем использоваться в других директивах.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1191 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1192
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1193 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1194 Если у максимального совпавшего префиксного location'а указан префикс
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1195 “<literal>^~</literal>”, то регулярные выражения не проверяются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1196 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1197
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1198 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1199 Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1200 совпадение URI и location.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1201 При точном совпадении поиск сразу же прекращается.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1202 Например, если запрос “<literal>/</literal>” случается часто, то
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1203 указав “<literal>location = /</literal>”, можно ускорить обработку
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1204 этих запросов, так как поиск прекратится после первого же сравнения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1205 Очевидно, что такой location не может иметь вложенные location'ы.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1206 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1207
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1208 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1209 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1210 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1211 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	1212 то поиск тоже сразу же прекращается и регулярные выражения также
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1213 не проверяются.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1214 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1215 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1216
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1217 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1218 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1219 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1220 location = / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1221 [ конфигурация А ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1222 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1223
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1224 location / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1225 [ конфигурация Б ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1226 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1227
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1228 location ^~ /images/ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1229 [ конфигурация В ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1230 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1231
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1232 location ~* \.(gif\|jpg\|jpeg)$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1233 [ конфигурация Г ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1234 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1235 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1236 Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1237 для запроса “<literal>/documents/document.html</literal>” — конфигурация Б,
f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1238 для запроса “<literal>/images/1.gif</literal>” — конфигурация В,
f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1239 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Г.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1240 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1241
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1242 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1243 Префикс “<literal>@</literal>” задаёт именованный location.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1244 Такой location не используется при обычной обработке запросов, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1245 предназначен только для перенаправления в него запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1246 Такие location'ы не могут быть вложенными и не могут содержать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1247 вложенные location'ы.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1248 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1249
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1250 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1251 <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	1252 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1253
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1254 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1255
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1256
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1257 <directive name="log_not_found">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1258 <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	1259 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1260 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1261 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1262 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1263
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1264 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1265 Разрешает или запрещает записывать в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1266 <link doc="../ngx_core_module.xml" id="error_log"/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1267 ошибки о том, что файл не найден.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1268 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1269
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1270 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1271
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1272
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1273 <directive name="log_subrequest">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1274 <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	1275 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1276 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1277 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1278 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1279
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1280 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1281 Разрешает или запрещает записывать в
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	1282 <link doc="ngx_http_log_module.xml" id="access_log"/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1283 подзапросы.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1284 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1285
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1286 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1287
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1288
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1289 <directive name="max_ranges">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1290 <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	1291 <default/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1292 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1293 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1294 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1295
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1296 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1297 Ограничивает максимальное допустимое число диапазонов в запросах с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1298 указанием диапазона запрашиваемых байт (byte-range requests).
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1299 Запросы, превышающие указанное ограничение, обрабатываются как
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1300 если бы они не содержали указания диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1301 По умолчанию ограничения нет.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1302 Значение 0 полностью запрещает поддержку диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1303 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1304
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1305 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1306
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1307
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1308 <directive name="merge_slashes">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1309 <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	1310 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1311 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1312 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1313
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1314 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1315 Разрешает или запрещает преобразование URI путём замены двух и более подряд
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1316 идущих слэшей (“<literal>/</literal>”) в один.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1317 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1318
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1319 <para>
280 cbb789d3ce5e Fixed grammar error. Ruslan Ermilov <ru@nginx.com> parents: 274 diff changeset	1320 Необходимо иметь в виду, что это преобразование необходимо для корректной
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1321 проверки префиксных строк и регулярных выражений.
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1322 Если его не делать, то запрос “<literal>//scripts/one.php</literal>”
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1323 не попадёт в
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1324 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1325 location /scripts/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1326 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1327 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1328 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1329 и может быть обслужен как статический файл.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1330 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1331 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1332
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1333 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1334 Запрет преобразования может понадобиться, если в URI используются имена,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1335 закодированные методом base64, в котором задействован символ
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1336 “<literal>/</literal>”.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1337 Однако по соображениям безопасности лучше избегать отключения преобразования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1338 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1339
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1340 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1341 Если директива указана на уровне
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1342 <link id="server"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1343 в сервере по умолчанию, то её значение распространяется на
381 8ad9df891e23 Fixed grammar. Ruslan Ermilov <ru@nginx.com> parents: 367 diff changeset	1344 все виртуальные серверы, слушающие на том же адресе и порту.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1345 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1346
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1347 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1348
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1349
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1350 <directive name="msie_padding">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1351 <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	1352 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1353 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1354 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1355 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1356
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1357 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1358 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1359 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1360 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1361
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1362 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1363
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1364
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1365 <directive name="msie_refresh">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1366 <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	1367 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1368 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1369 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1370 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1371
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1372 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1373 Разрешает или запрещает выдавать для MSIE клиентов refresh'ы вместо
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1374 перенаправлений.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1375 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1376
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1377 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1378
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1379
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1380 <directive name="open_file_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1381 <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	1382 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1383 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1384 [<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	1385 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1386 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1387 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1388 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1389
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1390 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1391 Задаёт кэш, в котором могут храниться:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1392 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1393
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1394 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1395 дескрипторы открытых файлов, информация об их размерах и времени модификации;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1396 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1397
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1398 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1399 информация о существовании каталогов;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1400 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1401
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1402 <listitem>
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1403 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1404 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1405 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1406 Кэширование ошибок нужно разрешить отдельно директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1407 <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	1408 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1409 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1410
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1411 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1412 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1413
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1414 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1415 У директивы есть следующие параметры:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1416 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1417
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1418 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1419 <literal>max</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1420 </tag-name>
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 задаёт максимальное число элементов в кэше;
274 457c54242cfa Stole translation of LRU from ngx_http_proxy_module. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1423 при переполнении кэша удаляются самые невостребованные элементы (LRU);
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1424 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1425
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1426 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1427 <literal>inactive</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1428 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1429 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1430 задаёт время, после которого элемент кэша удаляется, если к нему
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1431 не было обращений в течение этого времени; по умолчанию 60 секунд;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1432 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1433
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1434 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1435 <literal>off</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1436 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1437 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1438 запрещает кэш.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1439 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1440
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1441 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1442 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1443
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1444 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1445 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1446 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1447 open_file_cache max=1000 inactive=20s;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1448 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1449 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1450 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	1451 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1452 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	1453 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1454 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1455 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1456
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1457 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1458
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1459
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1460 <directive name="open_file_cache_errors">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1461 <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	1462 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1463 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1464 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1465 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1466
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1467 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1468 Разрешает или запрещает кэширование ошибок поиска файлов в
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1469 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1470 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1471
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1472 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1473
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1474
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1475 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1476
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1477 <directive name="open_file_cache_events">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1478 <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	1479 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1480 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1481 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1482 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1483
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1484 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1485 Разрешает использование событий ядра для проверки актуальности элементов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1486 <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	1487 Эта директива работает только совместно с методом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1488 <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	1489 Заметьте, что только 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	1490 поддерживают события для файловых систем произвольного типа.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1491 Другие операционные системы поддерживают события только для
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1492 основных файловых систем, таких как UFS или FFS.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1493 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1494
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1495 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1496
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1497 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1498
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1499
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1500 <directive name="open_file_cache_min_uses">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1501 <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	1502 <default>1</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1503 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1504 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1505 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1506
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1507 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1508 Задаёт минимальное <value>число</value> обращений к файлу
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1509 в течение времени, заданного параметром <literal>inactive</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1510 директивы <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	1511 файла будет оставаться открытым в кэше.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1512 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1513
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1514 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1515
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1516
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1517 <directive name="open_file_cache_valid">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1518 <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	1519 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1520 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1521 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1522 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1523
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1524 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1525 Определяет время, через которое следует проверять актуальность информации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1526 об элементе в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1527 <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	1528 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1529 При включенном
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1530 <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	1531 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1532 по факту их изменения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1533 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1534 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1535
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1536 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1537
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1538
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1539 <directive name="optimize_server_names">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1540 <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	1541 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1542 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1543 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1544
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1545 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1546 Директива устарела, вместо неё следует использовать директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1547 <link id="server_name_in_redirect"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1548 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1549
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1550 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1551 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1552 Разрешает или запрещает оптимизировать проверку имени хоста в name-based
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1553 виртуальных серверах.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1554 Проверка в частности влияет на имя хоста, используемого в перенаправлениях.
381 8ad9df891e23 Fixed grammar. Ruslan Ermilov <ru@nginx.com> parents: 367 diff changeset	1555 Если оптимизация разрешена и все name-based серверы, слушающие на одной
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1556 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1557 имена не проверяются и в перенаправлениях используется первое имя сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1558 Если в перенаправлении нужно использовать имя хоста, переданное клиентом,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1559 то оптимизацию нужно выключить.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1560 </para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1561 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1562
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1563 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1564
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1565
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1566 <directive name="port_in_redirect">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1567 <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	1568 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1569 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1570 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1571 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1572
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1573 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1574 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx'ом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1575 </para>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1576
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1577 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1578 См. также директиву <link id="server_name_in_redirect"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1579 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1580
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1581 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1582
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1583
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1584 <directive name="postpone_output">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1585 <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	1586 <default>1460</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1587 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1588 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1589 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1590
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1591 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1592 Если это возможно, то отправка данных клиенту будет отложена пока nginx не
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1593 накопит по крайней мере указанное количество байт для отправки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1594 Значение 0 запрещает отложенную отправку данных.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1595 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1596
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1597 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1598
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1599
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1600 <directive name="read_ahead">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1601 <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	1602 <default>0</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1603 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1604 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1605 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1606
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1607 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1608 Задаёт ядру размер предчтения при работе с файлами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1609 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1610
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1611 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1612 На Linux используется системный вызов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1613 <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	1614 поэтому параметр <value>размер</value> там игнорируется.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1615 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1616
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1617 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1618 На FreeBSD используется системный вызов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1619 <literal>fcntl(O_READAHEAD,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1620 </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	1621 появившийся во FreeBSD 9.0-CURRENT.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1622 Для FreeBSD 7 необходимо установить
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1623 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1624 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1625
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1626 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1627
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1628
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1629 <directive name="recursive_error_pages">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1630 <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	1631 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1632 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1633 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1634 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1635
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1636 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1637 Разрешает или запрещает делать несколько перенаправлений через директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1638 <link id="error_page"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1639 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1640
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1641 </directive>
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1644 <directive name="request_pool_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1645 <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	1646 <default>4k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1647 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1648 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1649
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1650 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1651 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1652 под конкретные запросы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1653 Эта директива не оказывает существенного влияния на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1654 производительность и её не следует использовать.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1655 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1656
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1657 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1658
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1659
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1660 <directive name="reset_timedout_connection">
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1661 <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	1662 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1663 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1664 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1665 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1666
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1667 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1668 Разрешает или запрещает сброс соединений по таймауту.
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1669 Сброс делается следующим образом — перед закрытием сокета для него
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1670 ставится опция
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1671 <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	1672 с таймаутом 0.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1673 После чего при закрытии сокета клиенту отсылается TCP RST, а вся память,
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 состоянии FIN_WAIT1 с заполненными буферами.
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>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1680 Необходимо отметить, что keep-alive соединения по истечении таймаута
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1681 закрываются обычным образом.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1682 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1683
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1684 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1685
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1686
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1687 <directive name="resolver">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1688 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1689 <value>адрес</value> ...
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1690 [<literal>valid</literal>=<value>время</value>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	1691 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1692 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1693 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1694 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1695
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1696 <para>
318 4a0fe9283dc7 Word polishing in the description of the "server" directive. Ruslan Ermilov <ru@nginx.com> parents: 280 diff changeset	1697 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1698 в адреса, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1699 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1700 resolver 127.0.0.1 192.0.2.1;
76 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 Параметр <value>адрес</value> может быть задан либо
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1703 IPv4-адресом, либо именем хоста;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1704 во втором случае используется первый полученный IPv4-адрес.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1705 Серверы DNS опрашиваются циклически.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1706 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1707 До версии 1.1.7 можно было задать лишь один DNS-сервер.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1708 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1709 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1710 Необязательный параметр <literal>valid</literal> позволяет это
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1711 переопределить:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1712 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1713 resolver 127.0.0.1 192.0.2.1 valid=30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1714 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1715 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1716 До версии 1.1.9 настройка времени кэширования была невозможна
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1717 и nginx всегда кэшировал ответы на срок в 5 минут.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1718 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1719 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1720
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1721 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1722
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1723
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1724 <directive name="resolver_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1725 <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	1726 <default>30s</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1727 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1728 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1729 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1730
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1731 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1732 Задаёт таймаут для преобразования имени в адрес, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1733 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1734 resolver_timeout 5s;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1735 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1736 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1737
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1738 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1739
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1740
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1741 <directive name="root">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1742 <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	1743 <default>html</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1744 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1745 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1746 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1747 <context>if в location</context>
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1750 Задаёт корневой каталог для запросов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1751 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1752 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1753 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1754 root /data/w3;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1755 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1756 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1757 в ответ на запрос “<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	1758 <path>/data/w3/i/top.gif</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1759 </para>
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>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1762 В значении параметра <value>путь</value> можно использовать переменные,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1763 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1764 </para>
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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1767 Путь к файлу формируется путём простого добавления URI к значению директивы
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1768 <literal>root</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1769 Если же URI необходимо поменять, следует воспользоваться директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1770 <link id="alias"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1771 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1774
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1775
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1776 <directive name="satisfy">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1777 <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	1778 <default>all</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1779 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1780 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1781 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1782
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1783 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1784 Разрешает доступ, если оба (<literal>all</literal>)
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1785 или хотя бы один (<literal>any</literal>) из модулей
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1786 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1787 и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1788 разрешают доступ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1789 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1790
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1791 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1792 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1793 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1794 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1795 satisfy any;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1796
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1797 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	1798 deny all;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1799
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1800 auth_basic "closed site";
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1801 auth_basic_user_file conf/htpasswd;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1802 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1803 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1804 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1805
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1806 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1809 <directive name="satisfy_any">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1810 <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	1811 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1812 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1813 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1814 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1815
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1816 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1817 Эта директива была переименована в директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1818 <link id="satisfy">satisfy any</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1819 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1820
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1821 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1822
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1823
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1824 <directive name="send_lowat">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1825 <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	1826 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1827 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1828 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1829 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1830
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1831 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1832 При установке в ненулевое значение nginx будет пытаться минимизировать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1833 число операций отправки на клиентских сокетах либо при помощи флага
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1834 <c-def>NOTE_LOWAT</c-def> метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1835 <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	1836 либо при помощи опции сокета <c-def>SO_SNDLOWAT</c-def>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1837 с указанным размером.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1838 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1839
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1840 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1841 Эта директива игнорируется на Linux, Solaris и Windows.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1842 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1843
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1844 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1845
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1846
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1847 <directive name="send_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1848 <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	1849 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1850 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1851 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1852 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1853
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1854 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1855 Задаёт таймаут при передаче ответа клиенту.
76 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 а только между двумя операциями записями.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1858 Если по истечении этого времени клиент ничего не примет,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1859 соединение будет закрыто.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1860 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1861
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1862 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1863
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1864
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1865 <directive name="sendfile">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1866
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1867 <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	1868 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1869 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1870 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1871 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1872 <context>if в location</context>
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1875 Разрешает или запрещает использовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1876 <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	1877 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1878
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1879 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1880
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1881
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1882 <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	1883
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1884 <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	1885 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1886 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1887 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1888 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1889
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1890 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1891 При установке в ненулевое значение ограничивает объём данных,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1892 который может передан за один вызов <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	1893 Без этого ограничения одно быстрое соединение может целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1894 захватить рабочий процесс.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1895 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1898
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1899
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1900 <directive name="server">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	1901 <syntax block="yes"/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	1902 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1903 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1904
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1905 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1906 Задаёт конфигурацию для виртуального сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1907 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1908 и 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	1909 Вместо этого директивами <link id="listen"/> описываются все
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 а в директиве <link id="server_name"/> указываются все имена серверов.
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 <link doc="../virtual_hosts.xml">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1914 настройке виртуальных серверов</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1915 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1916
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1917 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1918
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1919
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1920 <directive name="server_name">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1921 <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	1922 <default>""</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1923 <context>server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1924
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1925 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1926 Задаёт имена виртуального сервера, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1927 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1928 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1929 server_name example.com www.example.com;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1930 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1931 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1932 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1933
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1934 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1935 Первое имя становится основным именем сервера.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1936 В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1937 для замены первой или последней части имени:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1938 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1939 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1940 server_name example.com .example.com www.example.;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1941 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1942 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1943 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1944
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1945 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1946 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1947 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1948 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1949 server_name .example.com;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1950 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1951 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1952 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1953
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1954 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1955 Если параметр равен “<var>$hostname</var>” (0.9.4), то
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1956 подставляется имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1957 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1958
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1959 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1960 В качестве имени сервера можно также использовать регулярное выражение,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1961 указав перед ним тильду (“<literal>~</literal>”):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1962 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1963 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1964 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	1965 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1966 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1967 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1968
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1969 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1970 Регулярное выражение может содержать выделения (0.7.40),
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 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1973 server {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1974 server_name ~^(www\.)?(.+)$;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1975
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1976 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1977 root /sites/$2;
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 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1980
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1981 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1982 server_name _;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1983
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1984 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1985 root /sites/default;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1986 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1987 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1988 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1989 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1990
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1991 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1992 Именованные выделения в регулярном выражении создают переменные (0.8.25),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1993 которые могут затем использоваться в других директивах:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1994 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1995 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1996 server_name ~^(www\.)?(?<domain>.+)$;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1997
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1998 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1999 root /sites/$domain;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2000 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2001 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2002
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2003 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2004 server_name _;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2005
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2006 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2007 root /sites/default;
76 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 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2010 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2011 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2012
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2013 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2014 Возможно также указать пустое имя сервера (0.7.11):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2015 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2016 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2017 server_name www.example.com "";
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 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2020 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка
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 Это настройка по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2023 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2024 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2025 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2026 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2027
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2028 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2029 Порядок проверки имён следующий:
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2030 <list type="enum">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2031
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2032 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2033 полные имена
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2034 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2035
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2036 <listitem>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2037 имена с маской в начале имени, например “<literal>*.example.com</literal>”
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2038 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2039
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2040 <listitem>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2041 имена с маской в конце имени, например “<literal>mail.*</literal>”
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2042 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2043
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2044 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2045 регулярные выражения
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2046 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2047
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2048 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2049 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2050
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2051 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2052
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2053
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2054 <directive name="server_name_in_redirect">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2055 <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	2056 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2057 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2058 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2059 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2060
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2061 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2062 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx'ом,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2063 основное имя сервера, задаваемое директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2064 <link id="server_name"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2065 Если запрещено, то используется имя, указанное в поле <header>Host</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2066 заголовка запроса.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2067 Если же этого поля нет, то используется IP-адрес сервера.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2068 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2069
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2070 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2071 См. также директиву <link id="port_in_redirect"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2072 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2073
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2074 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2075
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2076
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2077 <directive name="server_names_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2078 <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	2079 <default>32\|64\|128</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2080 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2081
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2082 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2083 Задаёт размер корзины в хэш-таблицах имён серверов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2084 Значение по умолчанию зависит от размера строки кэша процессора.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2085 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2086 <link doc="../hash.xml">настройке хэшей</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2087 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2088
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2089 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2090
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2091
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2092 <directive name="server_names_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2093 <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	2094 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2095 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2096
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2097 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2098 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2099 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2100 <link doc="../hash.xml">настройке хэшей</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2101 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2102
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2103 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2104
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2105
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2106 <directive name="server_tokens">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2107 <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	2108 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2109 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2110 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2111 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2112
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2113 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2114 Разрешает или запрещает выдавать версию nginx'а в сообщениях об ошибках и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2115 в поле <header>Server</header> заголовка ответа.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2116 </para>
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2119
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2120
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2121 <directive name="tcp_nodelay">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2122 <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	2123 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2124 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2125 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2126 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2127
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2128 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2129 Разрешает или запрещает использование опции <c-def>TCP_NODELAY</c-def>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2130 Опция включаются только при переходе соединения в состояние keep-alive.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2131 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2132
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2133 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2134
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2135
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2136 <directive name="tcp_nopush">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2137 <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	2138 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2139 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2140 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2141 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2142
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2143 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2144 Разрешает или запрещает использование опции сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2145 <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	2146 <c-def>TCP_CORK</c-def> в Linux.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2147 Опции включаются только при использовании <link id="sendfile"/>.
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 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2150
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2151 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2152 передавать заголовок ответа и начало файла в одном пакете
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2153 в Linux и во FreeBSD 4.*;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2154 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2155
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2156 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2157 передавать файл полными пакетами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2158 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2159
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2160 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2161 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2162
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2163 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2164
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2165
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2166 <directive name="try_files">
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2167 <syntax><value>файл</value> ... <value>uri</value></syntax>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2168 <syntax><value>файл</value> ... =<value>код</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	2169 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2170 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2171 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2172
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2173 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2174 Проверяет существование файлов в заданном порядке и использует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2175 для обработки запроса первый найденный файл, причём обработка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2176 делается в контексте этого же location'а.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2177 Путь к файлу строится из параметра <value>файл</value>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2178 в соответствии с директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2179 <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	2180 С помощью слэша в конце имени можно проверить существование каталога,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2181 например, “<literal>$uri/</literal>”.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2182 В случае, если ни один файл не найден, то делается внутреннее
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2183 перенаправление на <value>uri</value>, заданный последним параметром.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2184 Например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2185 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2186 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2187 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	2188 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2189
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2190 location = /images/default.gif {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2191 expires 30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2192 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2193 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2194 Последний параметр может также указывать на именованный location,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2195 смотрите примеры ниже.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2196 С версии 0.7.51 последний параметр может также быть кодом:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2197 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2198 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2199 try_files $uri $uri/index.html $uri.html =404;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2200 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2201 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2202 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2203
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2204 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2205 Пример использования при проксировании Mongrel:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2206 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2207 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2208 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	2209 $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	2210 @mongrel;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2211 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2212
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2213 location @mongrel {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2214 proxy_pass http://mongrel;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2215 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2216 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2217 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2218
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2219 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2220 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2221 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2222 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2223 try_files $uri $uri/ @drupal;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2224 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2225
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2226 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2227 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2228
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2229 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2230
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2231 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	2232 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	2233 fastcgi_param QUERY_STRING $args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2234
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2235 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2236 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2237
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2238 location @drupal {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2239 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2240
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2241 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	2242 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	2243 fastcgi_param QUERY_STRING q=$uri&$args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2244
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2245 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2246 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2247 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2248 В следующем примере директива <literal>try_files</literal>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2249 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2250 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2251 try_files $uri $uri/ @drupal;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2252 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2253 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2254 аналогична директивам
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2255 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2256 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2257 error_page 404 = @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2258 log_not_found off;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2259 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2260 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2261 А здесь
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2262 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2263 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2264 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2265
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2266 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2267
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2268 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2269
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2270 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2271 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2272 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2273 <literal>try_files</literal> проверяет существование PHP-файла,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2274 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2275 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2276
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2277 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2278 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2279 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2280 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2281 try_files $uri $uri/ @wordpress;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2282 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2283
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2284 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2285 try_files $uri @wordpress;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2286
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2287 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2288
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2289 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2290 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2291 }
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 location @wordpress {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2294 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2295
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2296 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2297 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2298 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2299 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2300 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2301
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2302 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2303
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2304
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2305 <directive name="types">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	2306 <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	2307 <default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2308 text/html html;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2309 image/gif gif;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2310 image/jpeg jpg;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2311 </default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2312 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2313 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2314 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2315
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2316 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2317 Задаёт соответствие расширений имён файлов и MIME-типов ответов.
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 Одному MIME-типу может соответствовать несколько расширений, например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2320 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2321 types {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2322 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	2323 application/octet-stream deb;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2324 application/octet-stream dmg;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2325 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2326 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2327 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2328
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2329 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2330 Достаточно полная таблица соответствий входит в дистрибутив nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2331 и находится в файле <path>conf/mime.types</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2332 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2333
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2334 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2335 Для того, чтобы для определённого location'а для всех ответов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2336 выдавался 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	2337 можно использовать следующее:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2338 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2339 location /download/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2340 types { }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2341 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	2342 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2343 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2344 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2345
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2346 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2347
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2348
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2349 <directive name="types_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2350 <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	2351 <default>32\|64\|128</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2352 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2353 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2354 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2355
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2356 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2357 Задаёт размер корзины в хэш-таблицах типов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2358 Значение по умолчанию зависит от размера строки кэша процессора.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2359 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2360 <link doc="../hash.xml">настройке хэшей</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2361 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2362
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2363 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2364
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2365
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2366 <directive name="types_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2367 <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	2368 <default>1024</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2369 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2370 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2371 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2372
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2373 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2374 Задаёт максимальный <value>размер</value> хэш-таблиц типов.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2375 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2376 <link doc="../hash.xml">настройке хэшей</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2377 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2380
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2381
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2382 <directive name="underscores_in_headers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2383 <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	2384 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2385 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2386 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2387
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2388 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2389 Разрешает или запрещает использование символов подчёркивания в
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 Если запрещено, поля заголовка запроса, в чьих именах есть подчёркивания,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2392 помечаются как недопустимые и подпадают под действие директивы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2393 <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	2394 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2395
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2396 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2397
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2398
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2399 <directive name="variables_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2400 <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	2401 <default>64</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2402 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2403
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2404 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2405 Задаёт размер корзины в хэш-таблице переменных.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2406 Подробнее смотрите в документе по
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2407 <link doc="../hash.xml">настройке хэшей</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2408 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2409
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2410 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2411
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2412
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2413 <directive name="variables_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2414 <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	2415 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2416 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2417
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2418 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2419 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
253 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 <link doc="../hash.xml">настройке хэшей</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2422 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2423
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2424 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2425
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2426 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2427
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2428
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2429 <section id="variables" name="Встроенные переменные">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2430
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2431 <para>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2432 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2433 переменные, имена которых совпадают с именами переменных веб-сервера Apache.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2434 Прежде всего, это переменные, представляющие из себя поля заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2435 запроса клиента, такие как <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	2436 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2437 Кроме того, есть и другие переменные:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2438 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2439
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2440 <tag-name><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	2441 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2442 аргумент <value>имя</value> в строке запроса
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2443 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2444
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2445 <tag-name><var>$args</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2446 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2447 аргументы в строке запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2448 </tag-desc>
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 <tag-name><var>$binary_remote_addr</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2451 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2452 адрес клиента в бинарном виде, длина значения всегда 4 байта
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2453 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2454
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2455 <tag-name><var>$body_bytes_sent</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2456 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2457 число байт, переданное клиенту, без учёта заголовка ответа
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2458 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2459
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2460 <tag-name><var>$content_length</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2461 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2462 поле <header>Content-Length</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2463 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2464
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2465 <tag-name><var>$content_type</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2466 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2467 поле <header>Content-Type</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2468 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2469
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2470 <tag-name><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	2471 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2472 cookie <value>имя</value>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2473 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2474
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2475 <tag-name><var>$document_root</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2476 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2477 значение директивы <link id="root"/> для текущего запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2478 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2479
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2480 <tag-name><var>$document_uri</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2481 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2482 то же, что и <var>$uri</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2483 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2484
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2485 <tag-name><var>$host</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2486 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2487 поле <header>Host</header> заголовка запроса,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2488 или имя сервера, соответствующего запросу, если этого поля нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2489 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2490
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2491 <tag-name><var>$hostname</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2492 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2493 имя хоста
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2494 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2495
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2496 <tag-name><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	2497 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2498 поле <value>имя</value> заголовка запроса
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2499 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2500
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2501 <tag-name><var>$https</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2502 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2503 “<literal>on</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2504 если соединение работает в режиме SSL,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2505 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2506 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2507
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2508 <tag-name><var>$is_args</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2509 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2510 “<literal>?</literal>”, если в строке запроса есть аргументы,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2511 и пустая строка, если их нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2512 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2513
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2514 <tag-name><var>$limit_rate</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2515 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2516 позволяет ограничивать скорость соединения
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2517 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2518
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2519 <tag-name><var>$nginx_version</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2520 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2521 версия nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2522 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2523
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2524 <tag-name><var>$pid</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2525 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2526 номер (PID) рабочего процесса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2527 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2528
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2529 <tag-name><var>$query_string</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2530 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2531 то же, что и <var>$args</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2532 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2533
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2534 <tag-name><var>$realpath_root</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2535 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2536 значение директивы <link id="root"/> для текущего запроса,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2537 при этом все символические ссылки преобразованы в реальные путь
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2538 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2539
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2540 <tag-name><var>$remote_addr</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2541 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2542 адрес клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2543 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2544
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2545 <tag-name><var>$remote_port</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2546 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2547 порт клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2548 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2549
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2550 <tag-name><var>$remote_user</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2551 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2552 имя пользователя, использованное в Basic аутентификации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2553 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2554
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2555 <tag-name><var>$request</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2556 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2557 оригинальная строка запроса целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2558 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2559
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2560 <tag-name><var>$request_body</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2561 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2562 тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2563 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2564 Значение переменной появляется в location'ах, обрабатываемых
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2565 директивами
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	2566 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2567 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2568 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2569 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2570 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2571
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2572 <tag-name><var>$request_body_file</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2573 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2574 имя временного файла, в котором хранится тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2575 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2576 По завершению обработки файл необходимо удалить.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2577 Для того, чтобы тело запроса всегда записывалось в файл,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2578 следует указать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2579 <link id="client_body_in_file_only">client_body_in_file_only on</link>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2580 При передаче имени временного файла в проксированном запросе
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2581 или в запросе к FastCGI-серверу следует запретить передачу самого
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2582 тела директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2583 <link doc="ngx_http_proxy_module.xml" id="proxy_pass_request_body">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2584 proxy_pass_request_body off</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2585 или
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2586 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass_request_body">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2587 fastcgi_pass_request_body off</link>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2588 соответственно.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2589 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2590 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2591
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2592 <tag-name><var>$request_completion</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2593 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2594 “<literal>OK</literal>” если запрос завершился,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2595 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2596 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2597
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2598 <tag-name><var>$request_filename</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2599 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2600 путь к файлу для текущего запроса, формируемый из директив
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2601 <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	2602 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2603
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2604 <tag-name><var>$request_method</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2605 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2606 метод запроса, обычно
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2607 “<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	2608 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2609
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2610 <tag-name><var>$request_uri</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2611 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2612 оригинальный URI запроса целиком (с аргументами)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2613 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2614
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2615 <tag-name><var>$scheme</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2616 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2617 схема запроса, “<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	2618 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2619
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2620 <tag-name><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	2621 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2622 поле <value>имя</value> заголовка ответа
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2623 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2624
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2625 <tag-name><var>$server_addr</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2626 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2627 адрес сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2628 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2629 Получение значения этой переменной обычно требует одного системного вызова.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2630 Чтобы избежать системного вызова, в директивах <link id="listen"/>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2631 следует указывать адреса и использовать параметр <literal>bind</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2632 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2633 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2634
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2635 <tag-name><var>$server_name</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2636 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2637 имя сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2638 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2639
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2640 <tag-name><var>$server_port</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2641 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2642 порт сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2643 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2644
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2645 <tag-name><var>$server_protocol</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2646 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2647 протокол сервера, обычно
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2648 “<literal>HTTP/1.0</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2649 или
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2650 “<literal>HTTP/1.1</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2651 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2652
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2653 <tag-name><var>$uri</var></tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2654 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2655 текущий URI запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2656 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2657 Он может отличаться от первоначального, например, при внутренних
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2658 перенаправлениях или при использовании индексных файлов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2659 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2660 </tag-desc>
76 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 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2663 </para>
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 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2666
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2667 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 397:f1c0ae9c1c48