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

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 1035:e9c485d6cc0c

Documented that "listen setfib=" implies "bind".

author	Ruslan Ermilov <ru@nginx.com>
date	Tue, 17 Dec 2013 19:02:54 +0400
parents	f7f23f5928ef
children	5894aa46ffef

rev	line source
222 bfe3eff81d04 Removed redundant encoding specification. Ruslan Ermilov <ru@nginx.com> parents: 108 diff changeset	1 <?xml version="1.0"?>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 576 diff changeset	3 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 576 diff changeset	4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 576 diff changeset	5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 576 diff changeset	6 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 576 diff changeset	7
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	9
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	10 <module name="Модуль ngx_http_core_module"
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 link="/ru/docs/http/ngx_http_core_module.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 587 diff changeset	12 lang="ru"
1035 e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	13 rev="27">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	15 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17 <directive name="aio">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	18 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	19 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	20 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	21 <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	22 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	23 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	24 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	25 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	26 <appeared-in>0.8.11</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	27
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	28 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	29 Разрешает или запрещает использование файлового асинхронного ввода-вывода (AIO)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	30 во FreeBSD и Linux.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	31 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	32
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	33 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	34 Во 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	35 AIO можно либо собрать в ядре статически:
76 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 options VFS_AIO
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	38 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	39 либо загрузить динамически через загружаемый модуль ядра:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	40 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	41 kldload aio
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	42 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	43 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	44
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	45 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	46 В версиях FreeBSD 5 и 6 включение AIO статически или динамически
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	47 на стадии загрузки ядра приводит к тому, что вся сетевая подсистема
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	48 будет использовать блокировку Giant, что может негативно сказаться на
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	49 производительности системы в целом.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	50 Это ограничение устранено во 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	51 и во FreeBSD 7.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	52 Однако, начиная с FreeBSD 5.3 есть возможность включать AIO,
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	53 не связывая сетевую подсистему блокировкой Giant — для этого модуль
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	54 AIO нужно подгружать уже после загрузки ядра.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	55 В этом случае в <path>/var/log/messages</path> появится следующее сообщение:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	56 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	57 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	58 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	59 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	60 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	61 <note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	62 Требование использовать блокировку Giant в AIO связано с тем, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	63 FreeBSD поддерживает асинхронные вызовы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	64 <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	65 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	66 <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	67 для работы с сокетами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	68 Но поскольку nginx использует AIO только для работы с диском,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	69 то проблем не возникает.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70 </note>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	71 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	74 Для работы AIO нужно выключить
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	75 <link id="sendfile"/>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	76 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	77 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	78 sendfile off;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	79 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	80 output_buffers 1 64k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	81 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	82 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	83 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	84
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	85 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	86 Кроме того, начиная с 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	87 использовать для подгрузки данных для <c-func>sendfile</c-func>:
76 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 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	90 sendfile on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	91 tcp_nopush on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	92 aio sendfile;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	93 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	94 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	95 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	96 <c-def>SF_NODISKIO</c-def>, в результате чего она не блокируется на диске, а
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	97 сообщает об отсутствии данных в памяти.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	98 После этого nginx инициирует асинхронную подгрузку данных, читая один байт.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	99 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	100 при последующих чтениях файл подгружается частями только по 16K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	101 Изменить это можно с помощью директивы
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	102 <link id="read_ahead"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	103 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	104
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	105 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	106 В Linux AIO можно использовать только начиная с версии ядра 2.6.22.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	107 Кроме того, необходимо также дополнительно включить
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	108 <link id="directio"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	109 иначе чтение будет блокирующимся:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	111 location /video/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	112 aio on;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	113 directio 512;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	114 output_buffers 1 128k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	117 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	118
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	119 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	120 В Linux
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	121 <link id="directio"/>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	122 можно использовать только для чтения блоков, выравненных
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	123 на границу 512 байт (или 4К для XFS).
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	124 Невыравненный конец файла будет читаться блокированно.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	125 То же относится к запросам с указанием диапазона запрашиваемых байт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	126 (byte-range requests) и к запросам FLV не с начала файла: чтение
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	127 невыравненных начала и конца ответа будет блокирующимся.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	128 Явно выключать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	129 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	130 не нужно, так как при использовании
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	131 <link id="directio"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	132 он выключается автоматически.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	133 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	134
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	135 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	138 <directive name="alias">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	139 <syntax><value>путь</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	140 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	141 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	142
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	143 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	144 Задаёт замену для указанного location’а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	145 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	146 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	147 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	148 alias /data/w3/images/;
76 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 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	151 на запрос
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	152 “<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	153 <path>/data/w3/images/top.gif</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	154 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	155
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	156 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	157 В значении параметра <value>путь</value> можно использовать переменные,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	158 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	159 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	160
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	161 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	162 Если <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	163 регулярным выражением, то регулярное выражение должно содержать
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	164 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	165 (0.7.40), например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	166 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	167 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	168 alias /data/w3/images/$1;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	169 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	170 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	171 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	172
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	173 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	174 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	175 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	176 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	177 alias /data/w3/images/;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	178 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	179 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	180 то лучше воспользоваться директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	181 <link id="root"/>:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	182 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	183 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	184 root /data/w3;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	185 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	186 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	187 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	188
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	189 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	190
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	191
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	192 <directive name="chunked_transfer_encoding">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	193 <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	194 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	195 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	196 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	197 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	198
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	199 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	200 Позволяет запретить формат передачи данных частями (chunked transfer
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	201 encoding) в HTTP/1.1.
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 chunked encoding, несмотря на требования стандарта.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	204 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	205
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	206 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	207
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	208
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	209 <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	210
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	211 <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	212 <default>8k\|16k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	213 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	214 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	215 <context>location</context>
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 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	218 Задаёт размер буфера для чтения тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	219 Если тело запроса больше заданного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	220 то всё тело запроса или только его часть записывается во
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	221 <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	222 По умолчанию размер одного буфера равен двум размерам страницы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	223 На 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	224 На других 64-битных платформах это обычно 16K.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	225 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	227 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	228
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	229
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	230 <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	231 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	232 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	233 <literal>clean</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	234 <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	235 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	236 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	237 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	238 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	239
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	240 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	241 Определяет, сохранять ли всё тело запроса клиента в файл.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	242 Директиву можно использовать для отладки и при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	243 <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	244 или метода
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	245 <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	246 модуля
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	247 <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	248 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	249
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	250 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	251 При установке значения <literal>on</literal> временные файлы
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	252 по окончании обработки запроса не удаляются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	253 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	254
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	255 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	256 Значение <literal>clean</literal> разрешает удалять временные файлы,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	257 оставшиеся по окончании обработки запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	258 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	259
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	260 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	261
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	262
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263 <directive name="client_body_in_single_buffer">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	264 <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	265 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	266 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	267 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	268 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	269
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	270 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	271 Определяет, сохранять ли всё тело запроса клиента в одном буфере.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	272 Директива рекомендуется при использовании переменной
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	273 <var>$request_body</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	274 для уменьшения требуемого числа операций копирования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	275 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	276
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	277 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	278
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	279
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	280 <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	281 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	282 <value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	283 [<value>уровень1</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	284 [<value>уровень2</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	285 [<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	286 <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	287 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	288 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	289 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	290
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	291 <para>
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 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	294 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	295 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	296 client_body_temp_path /spool/nginx/client_temp 1 2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	297 </example>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	298 путь к временному файлу будет следующего вида:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	299 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	300 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	301 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	302 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	303
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	304 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	305
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	306
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	307 <directive name="client_body_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	308 <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	309 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	310 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	311 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	312 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	313
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	314 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	315 Задаёт таймаут при чтении тела запроса клиента.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	316 Таймаут устанавливается не на всю передачу тела запроса,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	317 а только между двумя последовательными операциями чтения.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	318 Если по истечении этого времени клиент ничего не передаст,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	319 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	320 <http-status code="408" text="Request Time-out"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	321 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	322
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	323 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	324
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 <directive name="client_header_buffer_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	327 <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	328 <default>1k</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	329 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	330 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	331
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	332 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	333 Задаёт размер буфера для чтения заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	334 Для большинства запросов достаточно буфера размером в 1K байт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	335 Однако если в запросе есть длинные cookies, или же запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	336 пришёл от WAP-клиента, то он может не поместиться в 1K.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	337 Поэтому, если строка запроса или поле заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	338 не помещаются полностью в этот буфер, то выделяются буферы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	339 большего размера, задаваемые директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	340 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	341 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	342
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	343 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	344
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	345
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	346 <directive name="client_header_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	347 <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	348 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	349 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	350 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	351
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	352 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	353 Задаёт таймаут при чтении заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	354 Если по истечении этого времени клиент не передаст полностью заголовок,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	355 то клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	356 <http-status code="408" text="Request Time-out"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	357 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	358
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	359 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	360
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	361
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	362 <directive name="client_max_body_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	363 <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	364 <default>1m</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	365 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	366 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	367 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	368
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	369 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	370 Задаёт максимально допустимый размер тела запроса клиента,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	371 указываемый в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	372 <header>Content-Length</header>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	373 заголовка запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	374 Если размер больше заданного, то клиенту возвращается ошибка
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	375 <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	376 Следует иметь в виду, что
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	377 <!--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	378 эту ошибку<!--/link-->.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	379 Установка параметра <value>размер</value> в 0 отключает
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	380 проверку размера тела запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	381 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	382
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	383 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	384
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 <directive name="connection_pool_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	387 <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	388 <default>256</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	389 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	390 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	391
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	392 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	393 Позволяет производить точную настройку выделения памяти
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	394 под конкретные соединения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	395 Эта директива не оказывает существенного влияния на
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	396 производительность, и её не следует использовать.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	397 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	398
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	399 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	400
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	401
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	402 <directive name="default_type">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	403 <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	404 <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	405 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	406 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	407 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	408
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	409 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	410 Задаёт MIME-тип ответов по умолчанию.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	411 Соответствие расширений имён файлов MIME-типу ответов задаётся
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	412 с помощью директивы <link id="types"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	413 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	414
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	415 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	416
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	417
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	418 <directive name="directio">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	419 <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	420 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	421 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	422 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	423 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	424 <appeared-in>0.7.7</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	425
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	426 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	427 Разрешает использовать флаги
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	428 <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	429 <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	430 или функцию <c-func>directio</c-func> (Solaris)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	431 при чтении файлов, размер которых больше либо равен указанному.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	432 Директива автоматически запрещает (0.7.15) использование
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	433 <link id="sendfile"/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	434 для данного запроса.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	435 Рекомендуется использовать для больших файлов:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	436 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	437 directio 4m;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	438 </example>
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	439 или при использовании <link id="aio"/> в Linux.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	440 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	441
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	442 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	443
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	444
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	445 <directive name="directio_alignment">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	446 <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	447 <default>512</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	448 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	449 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	450 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	451 <appeared-in>0.8.11</appeared-in>
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	454 Устанавливает выравнивание для
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	455 <link id="directio"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	456 В большинстве случаев достаточно 512-байтового выравнивания, однако
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	457 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	458 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	459
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	460 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	461
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	462
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	463 <directive name="disable_symlinks">
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	464 <syntax><literal>off</literal></syntax>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	465 <syntax>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	466 <literal>on</literal> \|
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	467 <literal>if_not_owner</literal>
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	468 [<literal>from</literal>=<value>часть</value>]</syntax>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	469 <default>off</default>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	470 <context>http</context>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	471 <context>server</context>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	472 <context>location</context>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	473 <appeared-in>1.1.15</appeared-in>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	474
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	475 <para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	476 Определяет, как следует поступать с символическими ссылками
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	477 при открытии файлов:
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	478 <list type="tag">
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	479
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	480 <tag-name><literal>off</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	481 <tag-desc>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	482 Символические ссылки в пути допускаются и не проверяются.
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	483 Это стандартное поведение.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	484 </tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	485
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	486 <tag-name><literal>on</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	487 <tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	488 Если любой компонент пути является символической ссылкой,
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	489 доступ к файлу запрещается.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	490 </tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	491
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	492 <tag-name><literal>if_not_owner</literal></tag-name>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	493 <tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	494 Доступ к файлу запрещается, если любой компонент пути
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	495 является символической ссылкой, а ссылка и объект, на
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	496 который она ссылается, имеют разных владельцев.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	497 </tag-desc>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	498
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	499 <tag-name><literal>from</literal>=<value>часть</value></tag-name>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	500 <tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	501 При проверке символических ссылок
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	502 (параметры <literal>on</literal> и <literal>if_not_owner</literal>)
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	503 обычно проверяются все компоненты пути.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	504 Можно не проверять символические ссылки в начальной части пути,
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	505 указав дополнительно параметр
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	506 <literal>from</literal>=<value>часть</value>.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	507 В этом случае символические ссылки проверяются лишь начиная
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	508 с компонента пути, который следует за заданной начальной частью.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	509 Если значение не является начальной частью проверяемого пути,
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	510 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	511 Если значение целиком совпадает с именем файла,
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	512 символические ссылки не проверяются.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	513 В значении параметра можно использовать переменные.
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	514 </tag-desc>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	515
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	516 </list>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	517 </para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	518
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	519 <para>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	520 Пример:
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	521 <example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	522 disable_symlinks on from=$document_root;
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	523 </example>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	524 </para>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	525
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	526 <para>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	527 Эта директива доступна только на системах, в которых есть
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	528 интерфейсы <c-func>openat</c-func> и <c-func>fstatat</c-func>.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	529 К таким системам относятся современные версии FreeBSD, Linux и Solaris.
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	530 </para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	531
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	532 <para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	533 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	534 требуют дополнительных затрат на обработку.
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	535 <note>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	536 На системах, не поддерживающих операцию открытия каталогов только для поиска,
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	537 для использования этих параметров требуется, чтобы рабочие процессы
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	538 имели право читать все проверяемые каталоги.
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	539 </note>
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	540 </para>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	541
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	542 <para>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	543 <note>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	544 Модули
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	545 <link doc="ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link>,
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	546 <link doc="ngx_http_random_index_module.xml">ngx_http_random_index_module</link>
477 c5680571ec09 Unnecessary extensions removed from links. Andrey Belov <defan@nginx.com> parents: 476 diff changeset	547 и <link doc="ngx_http_dav_module.xml">ngx_http_dav_module</link>
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	548 в настоящий момент игнорируют эту директиву.
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	549 </note>
418 2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	550 </para>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	551
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	552 </directive>
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	553
2638f67205ee Documented the disable_symlinks directive. Ruslan Ermilov <ru@nginx.com> parents: 406 diff changeset	554
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	555 <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	556 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	557 <value>код</value> ...
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	558 [<literal>=</literal>[<value>ответ</value>]]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	559 <value>uri</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	560 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	561 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	562 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	563 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	564 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	565
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	566 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	567 Задаёт URI, который будет показываться для указанных ошибок.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	568 Директивы <literal>error_page</literal> наследуются с предыдущего уровня
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	569 при условии, что на данном уровне не заданы свои директивы
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	570 <literal>error_page</literal>.
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	571 В значении <literal>uri</literal> можно использовать переменные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	572 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	573
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	574 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	575 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	576 <example>
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	577 error_page 404 /404.html;
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	578 error_page 500 502 503 504 /50x.html;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	579 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	580 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	581
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	582 <para>
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	583 Кроме того, можно поменять код ответа на другой,
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	584 используя синтаксис вида “<literal>=</literal><value>ответ</value>”, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	585 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	586 error_page 404 =200 /empty.gif;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	587 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	588 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	589
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	590 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	591 Если ошибочный ответ обрабатывается проксированным сервером или
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	592 FastCGI-сервером, и этот сервер может вернуть разные коды ответов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	593 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	594 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	595 error_page 404 = /404.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	596 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	597 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	598
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	599 <para>
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	600 Также существует возможность использовать перенаправления для обработки
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	601 ошибок:
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	602 <example>
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	603 error_page 403 http://example.com/forbidden.html;
1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	604 error_page 404 =301 http://example.com/notfound.html;
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	605 </example>
871 96839d165b8a Clarify the description of error_page example. Sergey Kandaurov <pluknet@nginx.com> parents: 869 diff changeset	606 В этом случае по умолчанию клиенту возвращается код ответа 302.
948 2b0731e3adc9 Slightly fixed wording. Ruslan Ermilov <ru@nginx.com> parents: 941 diff changeset	607 Его можно изменить только на один из кодов ответа, относящихся к
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	608 перенаправлениям (301, 302, 303 и 307).
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	609 </para>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	610
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	611 <para>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	612 Если при внутреннем перенаправлении не нужно менять URI, то можно передать
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	613 обработку ошибки в именованный location:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	614 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	615 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	616 error_page 404 = @fallback;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	617 }
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 location @fallback {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	620 proxy_pass http://backend;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	621 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	622 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	623 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	624
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	625 <para>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	626 <note>
711 1f383a8bccdb Minor improvements over the recent additions to the "error_page" directive. Ruslan Ermilov <ru@nginx.com> parents: 709 diff changeset	627 Если при обработке <literal>uri</literal> происходит ошибка,
948 2b0731e3adc9 Slightly fixed wording. Ruslan Ermilov <ru@nginx.com> parents: 941 diff changeset	628 клиенту возвращается ответ с кодом последней случившейся ошибки.
679 9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	629 </note>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	630 </para>
9888364847b7 Documented status codes in the error_page directive. Vladimir Homutov <vl@nginx.com> parents: 674 diff changeset	631
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	632 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	633
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	634
576 cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	635 <directive name="etag">
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	636 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	637 <default>on</default>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	638 <context>http</context>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	639 <context>server</context>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	640 <context>location</context>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	641 <appeared-in>1.3.3</appeared-in>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	642
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	643 <para>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	644 Разрешает или запрещает автоматическую генерацию поля <header>ETag</header>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	645 заголовка ответа для статических ресурсов.
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	646 </para>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	647
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	648 </directive>
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	649
cac22cc79afd Documented the "etag" directive. Ruslan Ermilov <ru@nginx.com> parents: 566 diff changeset	650
651 eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	651 <directive name="http">
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	652 <syntax block="yes"/>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	653 <default/>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	654 <context>main</context>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	655
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	656 <para>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	657 Предоставляет контекст конфигурационного файла, в котором указываются
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	658 директивы HTTP-сервера.
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	659 </para>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	660
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	661 </directive>
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	662
eba81bfb6aaf Documented the "http" directive. Vladimir Homutov <vl@nginx.com> parents: 646 diff changeset	663
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	664 <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	665 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	666 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	667 <literal>exact</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	668 <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	669 <default>exact</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	670 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	671 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	672 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	673 <appeared-in>0.7.24</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	674
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	675 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	676 Определяет, как сравнивать время модификации ответа с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	677 временем в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	678 <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	679 заголовка запроса:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	680
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	681 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	682
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	683 <tag-name><literal>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	684 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	685 не проверять поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	686 <header>If-Modified-Since</header> заголовка запроса (0.7.34);
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	687 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	688
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	689 <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	690 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	691 точное совпадение;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	692 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	693
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	694 <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	695 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	696 время модификации ответа меньше или равно времени, заданному в поле
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	697 <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	698 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	699
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	700 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	701 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	702
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	703 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	704
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 <directive name="ignore_invalid_headers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	707 <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	708 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	709 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	710 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	711
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	712 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	713 Если включено, nginx игнорирует поля заголовка с недопустимыми именами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	714 Допустимыми считаются имена, состоящие из английских букв, цифр, дефисов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	715 и возможно знаков подчёркивания (последнее контролируется директивой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	716 <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	717 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	718
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	719 <para>
1023 375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	720 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	721 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	722 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	723 Указанное значение распространяется на все виртуальные серверы,
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	724 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	725 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	726
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	727 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	728
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	729
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	730 <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	731 <syntax/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	732 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	733 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	734
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	735 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	736 Указывает, что location может использоваться только для внутренних запросов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	737 Для внешних запросов клиенту будет возвращаться ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	738 <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	739 Внутренними запросами являются:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	740
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	741 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	742
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	743 <listitem>
429 2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	744 запросы, перенаправленные директивами
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	745 <link id="error_page"/>,
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	746 <link doc="ngx_http_index_module.xml" id="index"/>,
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	747 <link doc="ngx_http_random_index_module.xml" id="random_index"/> и
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	748 <link id="try_files"/>;
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	749 </listitem>
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	750
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	751 <listitem>
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	752 запросы, перенаправленные с помощью поля
2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	753 <header>X-Accel-Redirect</header> заголовка ответа вышестоящего сервера;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	754 </listitem>
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 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	757 подзапросы, формируемые командой
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	758 “<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	759 модуля
438 b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	760 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	761 и директивами модуля
b27974b92a58 - corrected the description of the from= parameter of the Ruslan Ermilov <ru@nginx.com> parents: 436 diff changeset	762 <link doc="ngx_http_addition_module.xml">ngx_http_addition_module</link>;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	763 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	764
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	765 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	766 запросы, изменённые директивой
429 2b9507b2cdf3 List all sources of internal requests. Ruslan Ermilov <ru@nginx.com> parents: 426 diff changeset	767 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	768 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	769
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	770 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	771 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	772
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	773 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	774 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	775 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	776 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	777
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	778 location /404.html {
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	779 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	780 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	781 </example>
674 c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	782 <note>
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	783 Для предотвращения зацикливания, которое может возникнуть при
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	784 использовании некорректных конфигураций, количество внутренних
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	785 перенаправлений ограничено десятью.
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	786 По достижении этого ограничения будет возвращена ошибка
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	787 <http-status code="500" text="Internal Server Error"/>.
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	788 В таком случае в лог-файле ошибок можно увидеть сообщение
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	789 “rewrite or internal redirection cycle”.
c48c0936b4df Documented internal redirections limit. Vladimir Homutov <vl@nginx.com> parents: 659 diff changeset	790 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	791 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	792
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	793 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	794
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	795
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	796 <directive name="keepalive_disable">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	797 <syntax><literal>none</literal> \| <value>браузер</value> ...</syntax>
467 c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	798 <default>msie6</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	799 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	800 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	801 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	802
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	803 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	804 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	805 Параметры <value>браузер</value> указывают, на какие браузеры это
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	806 распространяется.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	807 Значение <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	808 со старыми версиями MSIE после получения запроса POST.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	809 Значение <literal>safari</literal> запрещает keep-alive соединения
467 c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	810 с Safari и подобными им браузерами на Mac OS X и подобных ей ОС.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	811 Значение <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	812 со всеми браузерами.
467 c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	813 <note>
c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	814 До версии 1.1.18 под значение <literal>safari</literal> подпадали
549 ab1449e0573b Typo fixed. Andrey Belov <defan@nginx.com> parents: 541 diff changeset	815 все Safari и подобные им браузеры на всех ОС, и keep-alive
467 c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	816 соединения с ними были по умолчанию запрещены.
c505c92c8658 Documented recent changes to the "keepalive_disable" directive. Ruslan Ermilov <ru@nginx.com> parents: 454 diff changeset	817 </note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	818 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	819
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	820 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	821
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	822
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	823 <directive name="keepalive_requests">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	824 <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	825 <default>100</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	826 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	827 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	828 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	829 <appeared-in>0.8.0</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	830
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	831 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	832 Задаёт максимальное число запросов, которые можно
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	833 сделать по одному keep-alive соединению.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	834 После того, как сделано максимальное число запросов,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	835 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	836 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	837
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	838 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	839
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	840
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	841 <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	842 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	843 <value>таймаут</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	844 [<value>заголовок_таймаута</value>]</syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	845 <default>75s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	846 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	847 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	848 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	849
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	850 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	851 Первый параметр задаёт таймаут, в течение которого keep-alive
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	852 соединение с клиентом не будет закрыто со стороны сервера.
835 e0263d44a59b Http core: documented "keepalive_timeout 0". Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	853 Значение 0 запрещает keep-alive соединения с клиентами.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	854 Второй необязательный параметр задаёт значение в поле
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	855 <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	856 заголовка ответа.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	857 Два параметра могут отличаться друг от друга.
253 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 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	861 Поле
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	862 <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	863 заголовка понимают Mozilla и Konqueror.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	864 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	865 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	866
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	867 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	868
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	869
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	870 <directive name="large_client_header_buffers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	871 <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	872 <default>4 8k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	873 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	874 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	875
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	876 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	877 Задаёт максимальное <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	878 буферов для чтения большого заголовка запроса клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	879 Строка запроса не должна превышать размера одного буфера, иначе клиенту
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 <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	882 Поле заголовка запроса также не должно превышать размера одного буфера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	883 иначе клиенту возвращается ошибка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	884 <http-status code="400" text="Bad Request"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	885 Буферы выделяются только по мере необходимости.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	886 По умолчанию размер одного буфера равен 8K байт.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	887 Если по окончании обработки запроса соединение переходит в состояние
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	888 keep-alive, эти буферы освобождаются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	889 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	890
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	891 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	892
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	893
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	894 <directive name="limit_except">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	895 <syntax block="yes"><value>метод</value> ...</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	896 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	897 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	898
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	899 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	900 Ограничивает HTTP-методы, доступные внутри location.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	901 Параметр <value>метод</value> может быть одним из
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	902 <literal>GET</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	903 <literal>HEAD</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	904 <literal>POST</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	905 <literal>PUT</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	906 <literal>DELETE</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	907 <literal>MKCOL</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	908 <literal>COPY</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	909 <literal>MOVE</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	910 <literal>OPTIONS</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	911 <literal>PROPFIND</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	912 <literal>PROPPATCH</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	913 <literal>LOCK</literal>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	914 <literal>UNLOCK</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	915 или
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	916 <literal>PATCH</literal>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	917 Если разрешён метод <literal>GET</literal>, то метод
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	918 <literal>HEAD</literal> также будет разрешён.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	919 Доступ к остальным методам может быть ограничен при помощи директив модулей
79 0a45870d0160 Fixed cross-document links to use doc and id. Maxim Dounin <mdounin@mdounin.ru> parents: 76 diff changeset	920 <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	921 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	922 <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	923 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	924 limit_except GET {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	925 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	926 deny all;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	927 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	928 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	929 Обратите внимание, что данное ограничение действует для всех методов,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	930 <emphasis>кроме</emphasis> GET и HEAD.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	931 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	932
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	933 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	934
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	935
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	936 <directive name="limit_rate">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	937 <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	938 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	939 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	940 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	941 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	942 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	943
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	944 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	945 Ограничивает скорость передачи ответа клиенту.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	946 Скорость задаётся в байтах в секунду.
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	947 Значение 0 отключает ограничение скорости.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	948 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	949 Чем меньше скорость, тем более аккуратным будет ограничение.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	950 -->
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	951 Ограничение устанавливается на запрос, поэтому, если клиент одновременно
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	952 откроет два соединения, суммарная скорость будет вдвое выше
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	953 заданного ограничения.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	954 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	955
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	956 <para>
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	957 Ограничение скорости можно также задать в переменной <var>$limit_rate</var>.
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	958 Это может быть полезно в случаях, когда скорость нужно ограничивать
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	959 в зависимости от какого-либо условия:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	960 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	961 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	962
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	963 if ($slow) {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	964 set $limit_rate 4k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	965 }
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 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	968 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	969 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	970 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	971
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	972 <para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	973 Кроме того, ограничение скорости может быть задано в поле
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	974 <header>X-Accel-Limit-Rate</header> заголовка ответа проксированного сервера.
506 657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	975 Эту возможность можно запретить с помощью директив
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	976 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	977 и
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	978 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>.
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	979 </para>
657848837328 Documented how nginx processes proxied server's response header fields Ruslan Ermilov <ru@nginx.com> parents: 503 diff changeset	980
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	981 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	982
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	983
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	984 <directive name="limit_rate_after">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	985 <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	986 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	987 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	988 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	989 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	990 <context>if в location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	991 <appeared-in>0.8.0</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	992
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	993 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	994 Задаёт начальный объём данных, после передачи которого начинает
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	995 ограничиваться скорость передачи ответа клиенту.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	996 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	997
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	998 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	999 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1000 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1001 location /flv/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1002 flv;
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1003 limit_rate_after 500k;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1004 limit_rate 50k;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1005 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1006 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1007 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1008
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1009 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1010
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1011
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1012 <directive name="lingering_close">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1013 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1014 <literal>off</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1015 <literal>on</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1016 <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	1017 <default>on</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1018 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1019 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1020 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1021 <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	1022 <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	1023
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1024 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1025 Управляет закрытием соединений с клиентами.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1026 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1027
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1028 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1029 Со значением по умолчанию “<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	1030 <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	1031 <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	1032 поступающие от клиента, перед полным закрытием соединения, но только
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1033 если эвристика указывает на то, что клиент может ещё послать данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1034 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1035
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1036 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1037 Со значением “<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	1038 ждать и обрабатывать дополнительные данные, поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1039 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1040
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1041 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1042 Со значением “<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	1043 дополнительных данных и сразу же закроет соединение.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1044 Это поведение нарушает протокол и поэтому не должно использоваться без
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1045 необходимости.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1046 </para>
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 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1049
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1050
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1051 <directive name="lingering_time">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1052 <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	1053 <default>30s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1054 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1055 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1056 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1057
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1058 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1059 Если действует <link id="lingering_close"/>,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1060 эта директива задаёт максимальное время, в течение которого nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1061 будет обрабатывать (читать и игнорировать) дополнительные данные,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1062 поступающие от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1063 По прошествии этого времени соединение будет закрыто, даже если
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1064 будут ещё данные.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1065 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1066
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1067 </directive>
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1070 <directive name="lingering_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1071 <syntax><value>время</value></syntax>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1072 <default>5s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1073 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1074 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1075 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1076
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1077 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1078 Если действует <link id="lingering_close"/>, эта директива задаёт
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1079 максимальное время ожидания поступления дополнительных данных от клиента.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1080 Если в течение этого времени данные не были получены, соединение закрывается.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1081 В противном случае данные читаются и игнорируются, и nginx снова
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1082 ждёт поступления данных.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1083 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1084 директивой <link id="lingering_time"/>.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1085 </para>
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 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1088
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1089
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1090 <directive name="listen">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1091 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1092 <value>адрес</value>[:<value>порт</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1093 [<literal>default_server</literal>]
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1094 [<literal>ssl</literal>]
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1095 [<literal>spdy</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1096 [<literal>setfib</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1097 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1098 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1099 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1100 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1101 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1102 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1103 [<literal>ipv6only</literal>=<literal>on</literal>\|<literal>off</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1104 [<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	1105 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1106 <value>порт</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1107 [<literal>default_server</literal>]
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1108 [<literal>ssl</literal>]
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1109 [<literal>spdy</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1110 [<literal>setfib</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1111 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1112 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1113 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1114 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1115 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1116 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1117 [<literal>ipv6only</literal>=<literal>on</literal>\|<literal>off</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1118 [<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	1119 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1120 <literal>unix:</literal><value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1121 [<literal>default_server</literal>]
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1122 [<literal>ssl</literal>]
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1123 [<literal>spdy</literal>]
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1124 [<literal>backlog</literal>=<value>число</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1125 [<literal>rcvbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1126 [<literal>sndbuf</literal>=<value>размер</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1127 [<literal>accept_filter</literal>=<value>фильтр</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1128 [<literal>deferred</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1129 [<literal>bind</literal>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1130 [<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	1131 <default>:80 \| :8000</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1132 <context>server</context>
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 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1135 Задаёт <value>адрес</value> и <value>порт</value> для IP
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1136 или <value>путь</value> для UNIX-сокета,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1137 на которых сервер будет принимать запросы.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1138 Можно указать <value>адрес</value> и <value>порт</value>,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1139 либо только <value>адрес</value> или только <value>порт</value>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1140 Кроме того, <value>адрес</value> может быть именем хоста, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1141 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1142 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	1143 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	1144 listen 8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1145 listen *:8000;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1146 listen localhost:8000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1147 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1148 IPv6-адреса (0.7.36) задаются в квадратных скобках:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1149 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1150 listen [::]:8000;
941 7d1d53d4d293 Removed link-scoped IPv6 addresses from examples. Ruslan Ermilov <ru@nginx.com> parents: 940 diff changeset	1151 listen [::1];
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1152 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1153 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	1154 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1155 listen unix:/var/run/nginx.sock;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1156 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1157 </para>
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>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1160 Если указан только <value>адрес</value>, то используется порт 80.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1161 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1162
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1163 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1164 Если директива не указана, то используется либо <literal>*:80</literal>,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1165 если nginx работает с привилегиями суперпользователя,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1166 либо <literal>*:8000</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1167 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1168
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1169 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1170 Если у директивы есть параметр <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	1171 в котором описана эта директива, будет сервером по умолчанию для указанной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1172 <value>адрес</value>:<value>порт</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1173 Если же директив с параметром <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	1174 сервером по умолчанию будет первый сервер, в котором описана пара
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1175 <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	1176 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1177 До версии 0.8.21 этот параметр назывался просто
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1178 <literal>default</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1179 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1180 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1181
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1182 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1183 Параметр <literal>ssl</literal> (0.7.14) указывает на то, что все соединения,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1184 принимаемые на данном порту, должны работать в режиме SSL.
869 ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1185 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1186 id="single_http_https_server">конфигурацию</link> для сервера,
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1187 работающего сразу в двух режимах — HTTP и HTTPS.
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1188 </para>
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1189
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1190 <para>
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1191 Параметр <literal>spdy</literal> (1.3.15) позволяет принимать на этом порту
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1192 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения.
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1193 Обычно, чтобы это работало, следует также указать параметр
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1194 <literal>ssl</literal>, однако nginx можно также настроить и на приём
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1195 SPDY-соединений без SSL.
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1196 </para>
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1197
ade81792bdaa Documented SPDY support. Homutov Vladimir <vl@nginx.com> parents: 840 diff changeset	1198 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1199 В директиве <literal>listen</literal> можно также указать несколько
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1200 дополнительных параметров, специфичных для связанных с сокетами
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1201 системных вызовов.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1202 Эти параметры можно задать в любой директиве <literal>listen</literal>,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1203 но только один раз для указанной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1204 <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	1205 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1206 До версии 0.8.21 их можно было указывать лишь в директиве
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1207 <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	1208 </note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1209 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1210
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1211 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1212 <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	1213 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1214 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1215 этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1216 (параметр <c-def>SO_SETFIB</c-def>) для слушающего сокета.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1217 В настоящий момент это работает только на FreeBSD.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1218 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1219
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1220 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1221 <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	1222 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1223 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1224 задаёт параметр <literal>backlog</literal> в вызове
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1225 <c-func>listen</c-func>, который ограничивает
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1226 максимальный размер очереди ожидающих приёма соединений.
741 082a725038db Fixed default backlog value description for Mac OS X Sergey Budnevitch <sb@waeme.net> parents: 738 diff changeset	1227 По умолчанию <literal>backlog</literal> устанавливается равным -1 для
082a725038db Fixed default backlog value description for Mac OS X Sergey Budnevitch <sb@waeme.net> parents: 738 diff changeset	1228 FreeBSD и Mac OS X, и 511 для других платформ.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1229 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1230
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1231 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1232 <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	1233 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1234 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1235 задаёт размер буфера приёма
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1236 (параметр <c-def>SO_RCVBUF</c-def>) для слушающего сокета.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1237 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1238
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1239 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1240 <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	1241 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1242 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1243 задаёт размер буфера передачи
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1244 (параметр <c-def>SO_SNDBUF</c-def>) для слушающего сокета.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1245 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1246
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1247 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1248 <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	1249 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1250 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1251 задаёт название accept-фильтра
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1252 (параметр <c-def>SO_ACCEPTFILTER</c-def>) для слушающего сокета,
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1253 который включается для фильтрации входящих соединений
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1254 перед передачей их в <c-func>accept</c-func>.
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1255 Работает только на FreeBSD и NetBSD 5.0+.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1256 Можно использовать два фильтра:
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1257 <link url="http://man.freebsd.org/accf_data">dataready</link>
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1258 и
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1259 <link url="http://man.freebsd.org/accf_http">httpready</link>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1260 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1261
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1262 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1263 <literal>deferred</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1264 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1265 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1266 указывает использовать отложенный <c-func>accept</c-func>
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1267 (параметр <c-def>TCP_DEFER_ACCEPT</c-def> сокета) на Linux.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1268 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1269
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1270 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1271 <literal>bind</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1272 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1273 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1274 указывает, что для данной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1275 <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	1276 <c-func>bind</c-func> отдельно.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1277 Это нужно потому, что если описаны несколько директив <literal>listen</literal>
629 7e4805858796 Fixed punctuation. Ruslan Ermilov <ru@nginx.com> parents: 625 diff changeset	1278 с одинаковым портом, но разными адресами, и одна из директив
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1279 <literal>listen</literal> слушает на всех адресах для данного порта
629 7e4805858796 Fixed punctuation. Ruslan Ermilov <ru@nginx.com> parents: 625 diff changeset	1280 (<literal>*:</literal><value>порт</value>), то nginx сделает
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1281 <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	1282 Необходимо заметить, что в этом случае для определения адреса, на которой
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1283 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
1035 e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1284 Если же используются параметры <literal>setfib</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1285 <literal>backlog</literal>, <literal>rcvbuf</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1286 <literal>sndbuf</literal>, <literal>accept_filter</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1287 <literal>deferred</literal> или <literal>so_keepalive</literal>,
e9c485d6cc0c Documented that "listen setfib=" implies "bind". Ruslan Ermilov <ru@nginx.com> parents: 1031 diff changeset	1288 то для данной пары
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1289 <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	1290 отдельный вызов <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	1291 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1292
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1293 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1294 <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	1295 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1296 <tag-desc>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1297 этот параметр (0.7.42) определяет
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1298 (через параметр сокета <c-def>IPV6_V6ONLY</c-def>),
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1299 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1300 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения.
615 f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1301 По умолчанию параметр включён.
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1302 Установить его можно только один раз на старте.
615 f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1303 <note>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1304 До версии 1.3.4,
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1305 если этот параметр не был задан явно, то для сокета действовали
615 f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1306 настройки операционной системы.
f3ef5b77d22a Documented that "ipv6only" is now turned on by default for Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	1307 </note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1308 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1309
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1310 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1311 <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	1312 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1313 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1314 этот параметр (1.1.11) конфигурирует для слушающего сокета
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1315 поведение “TCP keepalive”.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1316 Если этот параметр опущен, то для сокета будут действовать
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1317 настройки операционной системы.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1318 Если он установлен в значение “<literal>on</literal>”, то для сокета
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1319 включается параметр <c-def>SO_KEEPALIVE</c-def>.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1320 Если он установлен в значение “<literal>off</literal>”, то для сокета
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1321 параметр <c-def>SO_KEEPALIVE</c-def> выключается.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1322 Некоторые операционные системы поддерживают настройку параметров
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1323 “TCP keepalive” на уровне сокета посредством параметров
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1324 <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	1325 <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	1326 На таких системах (в настоящий момент это Linux 2.4+, NetBSD 5+ и
454 daafc5600fc4 FreeBSD 9.0-STABLE supports the TCP_KEEPIDLE, TCP_KEEPINTVL, and Ruslan Ermilov <ru@nginx.com> parents: 453 diff changeset	1327 FreeBSD 9.0-STABLE)
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1328 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1329 <value>keepintvl</value> и <value>keepcnt</value>.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1330 Один или два параметра могут быть опущены, в таком случае для
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1331 соответствующего параметра сокета будут действовать стандартные
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1332 системные настройки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1333 Например,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1334 <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	1335 установит таймаут бездействия (<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	1336 для интервала проб (<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	1337 стандартная системная настройка, а счётчик проб (<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	1338 будет равен 10.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1339 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1340
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1341 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1342 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1343
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1344 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1345 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1346 <example>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	1347 listen 127.0.0.1 default_server accept_filter=dataready backlog=1024;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1348 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1349 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1350
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1351 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1352
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1353
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1354 <directive name="location">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1355 <syntax block="yes">[
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1356 <literal>=</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1357 <literal>~</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1358 <literal>~*</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1359 <literal>^~</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1360 ] <value>uri</value></syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1361 <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	1362 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1363 <context>server</context>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1364 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1365
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1366 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1367 Устанавливает конфигурацию в зависимости от URI запроса.
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1368 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1369
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1370 <para>
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1371 Для сопоставления используется URI запроса в нормализованном виде,
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1372 после декодирования текста, заданного в виде “<literal>%XX</literal>”,
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1373 преобразования относительных элементов пути “<literal>.</literal>” и
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1374 “<literal>..</literal>” в реальные и возможной
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1375 <link id="merge_slashes">замены</link> двух и более подряд идущих
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1376 слэшей на один.
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1377 </para>
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1378
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1379 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1380 location можно задать префиксной строкой или регулярным выражением.
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1381 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1382 (для поиска совпадения без учёта регистра символов),
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1383 либо с модификатором “<literal>~</literal>” (с учётом регистра).
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1384 Чтобы найти location, соответствующий запросу, вначале проверяются
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1385 location’ы, заданные префиксными строками (префиксные location’ы).
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1386 Среди них ищется location с совпадающим префиксом
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1387 максимальной длины и запоминается.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1388 Затем проверяются регулярные выражения, в порядке их следования
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1389 в конфигурационном файле.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1390 Проверка регулярных выражений прекращается после первого же совпадения,
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 Если совпадение с регулярным выражением не найдено, то используется
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1393 конфигурация запомненного ранее префиксного location’а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1394 </para>
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 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1397 Блоки <literal>location</literal> могут быть вложенными,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1398 с некоторыми исключениями, о которых говорится ниже.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1399 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1400
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1401 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1402 Для операционных систем, нечувствительных к регистру символов, таких
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1403 как Mac OS X и Cygwin, сравнение с префиксными строками производится
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1404 без учёта регистра (0.7.7).
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1405 Однако сравнение ограничено только однобайтными locale’ями.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1406 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1407
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1408 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1409 Регулярные выражения могут содержать выделения (0.7.40), которые могут
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1410 затем использоваться в других директивах.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1411 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1412
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1413 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1414 Если у совпавшего префиксного location’а максимальной длины указан модификатор
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1415 “<literal>^~</literal>”, то регулярные выражения не проверяются.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1416 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1417
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1418 <para>
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1419 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1420 совпадение URI и location.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1421 При точном совпадении поиск сразу же прекращается.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1422 Например, если запрос “<literal>/</literal>” случается часто, то
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1423 указав “<literal>location = /</literal>”, можно ускорить обработку
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1424 этих запросов, так как поиск прекратится после первого же сравнения.
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1425 Очевидно, что такой location не может иметь вложенные location’ы.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1426 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1427
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1428 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1429 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1430 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
810 7c72c3e67e77 The "location" directive: improved wording. Ruslan Ermilov <ru@nginx.com> parents: 779 diff changeset	1431 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	1432 то поиск тоже сразу же прекращается и регулярные выражения также
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 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1435 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1436
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1437 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1438 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1439 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1440 location = / {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1441 [ конфигурация А ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1442 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1443
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1444 location / {
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 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1447
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1448 location /documents/ {
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1449 [ конфигурация В ]
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1450 }
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1451
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1452 location ^~ /images/ {
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1453 [ конфигурация Г ]
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1454 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1455
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1456 location ~* \.(gif\|jpg\|jpeg)$ {
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1457 [ конфигурация Д ]
76 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 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1460 Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
738 0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1461 для запроса “<literal>/index.html</literal>” — конфигурация Б,
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1462 для запроса “<literal>/documents/document.html</literal>” — конфигурация В,
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1463 для запроса “<literal>/images/1.gif</literal>” — конфигурация Г,
0914bbb59fd2 Expanded "location" examples with another prefix location. Ruslan Ermilov <ru@nginx.com> parents: 711 diff changeset	1464 а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Д.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1465 </para>
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>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1468 Префикс “<literal>@</literal>” задаёт именованный location.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1469 Такой location не используется при обычной обработке запросов, а
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1470 предназначен только для перенаправления в него запросов.
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1471 Такие location’ы не могут быть вложенными и не могут содержать
af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1472 вложенные location’ы.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1473 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1474
914 474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1475 <para>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1476 Если location задан префиксной строкой со слэшом в конце
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1477 и запросы обрабатываются при помощи
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1478 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>,
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1479 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1480 <link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1481 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/> или
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1482 <link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>,
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1483 а в ответ на запрос с URI равным этой строке, но без завершающего слэша,
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1484 будет возвращено постоянное перенаправление с кодом 301
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1485 на URI с добавленным в конец слэшом.
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1486 Если такое поведение нежелательно, можно задать точное совпадение
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1487 URI и location, например:
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1488 <example>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1489 location /user/ {
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1490 proxy_pass http://user.example.com;
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1491 }
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1492
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1493 location = /user {
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1494 proxy_pass http://login.example.com;
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1495 }
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1496 </example>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1497 </para>
474a21f26a2a Documented location behavior with proxying directives. Vladimir Homutov <vl@nginx.com> parents: 871 diff changeset	1498
253 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 <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	1501 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1502
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1503 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1504
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1505
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1506 <directive name="log_not_found">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1507 <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	1508 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1509 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1510 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1511 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1512
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1513 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1514 Разрешает или запрещает записывать в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1515 <link doc="../ngx_core_module.xml" id="error_log"/>
76 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 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1518
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1519 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1520
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1521
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1522 <directive name="log_subrequest">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1523 <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	1524 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1525 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1526 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1527 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1528
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1529 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1530 Разрешает или запрещает записывать в
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	1531 <link doc="ngx_http_log_module.xml" id="access_log"/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1532 подзапросы.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1533 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1534
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1535 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1536
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1537
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1538 <directive name="max_ranges">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1539 <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	1540 <default/>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1541 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1542 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1543 <context>location</context>
499 76a8eca844d0 Documented that "max_ranges" appeared in 1.1.2. Ruslan Ermilov <ru@nginx.com> parents: 477 diff changeset	1544 <appeared-in>1.1.2</appeared-in>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1545
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1546 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1547 Ограничивает максимальное допустимое число диапазонов в запросах с
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1548 указанием диапазона запрашиваемых байт (byte-range requests).
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 если бы они не содержали указания диапазонов.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1551 По умолчанию число диапазонов не ограничено.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1552 Значение 0 полностью запрещает поддержку диапазонов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1553 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1554
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1555 </directive>
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
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1558 <directive name="merge_slashes">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1559 <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	1560 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1561 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1562 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1563
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1564 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1565 Разрешает или запрещает преобразование URI путём замены двух и более подряд
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	1566 идущих слэшей (“<literal>/</literal>”) на один.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1567 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1568
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1569 <para>
280 cbb789d3ce5e Fixed grammar error. Ruslan Ermilov <ru@nginx.com> parents: 274 diff changeset	1570 Необходимо иметь в виду, что это преобразование необходимо для корректной
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1571 проверки префиксных строк и регулярных выражений.
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1572 Если его не делать, то запрос “<literal>//scripts/one.php</literal>”
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1573 не попадёт в
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1574 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1575 location /scripts/ {
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 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1578 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1579 и может быть обслужен как статический файл.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1580 Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1581 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1582
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1583 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1584 Запрет преобразования может понадобиться, если в URI используются имена,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1585 закодированные методом base64, в котором задействован символ
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1586 “<literal>/</literal>”.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1587 Однако из соображений безопасности лучше избегать отключения преобразования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1588 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1589
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1590 <para>
1023 375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	1591 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	1592 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	1593 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	1594 Указанное значение распространяется на все виртуальные серверы,
442 b423d725a932 Try to emphasize that "underscores_in_headers" and "merge_slashes", Ruslan Ermilov <ru@nginx.com> parents: 438 diff changeset	1595 слушающие на том же адресе и порту.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1596 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1597
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1598 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1601 <directive name="msie_padding">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1602 <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	1603 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1604 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1605 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1606 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1607
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1608 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1609 Разрешает или запрещает добавлять в ответы для MSIE со статусом больше 400
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1610 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1611 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1612
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1613 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1614
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1615
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1616 <directive name="msie_refresh">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1617 <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	1618 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1619 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1620 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1621 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1622
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1623 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1624 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1625 перенаправлений.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1626 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1629
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1630
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1631 <directive name="open_file_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1632 <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	1633 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1634 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1635 [<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	1636 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1637 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1638 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1639 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1640
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1641 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1642 Задаёт кэш, в котором могут храниться:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1643 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1644
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1645 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1646 дескрипторы открытых файлов, информация об их размерах и времени модификации;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1647 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1648
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1649 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1650 информация о существовании каталогов;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1651 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1652
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1653 <listitem>
367 f4033b9bc4ec - Removed unnecessary instances of unbreakable space. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	1654 информация об ошибках поиска файла — “нет файла”, “нет прав на чтение”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1655 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1656 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1657 Кэширование ошибок нужно разрешить отдельно директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1658 <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	1659 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1660 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1661
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1662 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1663 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1664
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1665 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1666 У директивы есть следующие параметры:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1667 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1668
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1669 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1670 <literal>max</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1671 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1672 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1673 задаёт максимальное число элементов в кэше;
507 d00a4f9b1c5d Better translation of "LRU". Ruslan Ermilov <ru@nginx.com> parents: 506 diff changeset	1674 при переполнении кэша удаляются наименее востребованные элементы (LRU);
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1675 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1676
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1677 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1678 <literal>inactive</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1679 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1680 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1681 задаёт время, после которого элемент кэша удаляется, если к нему
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1682 не было обращений в течение этого времени; по умолчанию 60 секунд;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1683 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1684
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1685 <tag-name>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1686 <literal>off</literal>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1687 </tag-name>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1688 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1689 запрещает кэш.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1690 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1691
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1692 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1693 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1694
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1695 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1696 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1697 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1698 open_file_cache max=1000 inactive=20s;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1699 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1700 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1701 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	1702 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1703 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	1704 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1705 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1706 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1707
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1708 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1709
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1710
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1711 <directive name="open_file_cache_errors">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1712 <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	1713 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1714 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1715 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1716 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1717
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1718 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1719 Разрешает или запрещает кэширование ошибок поиска файлов в
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1720 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1721 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1724
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1725
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1726 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1727
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1728 <directive name="open_file_cache_events">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1729 <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	1730 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1731 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1732 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1733 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1734
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1735 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1736 Разрешает использование событий ядра для проверки актуальности элементов
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1737 <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	1738 Эта директива работает только совместно с методом
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1739 <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	1740 Заметьте, что только 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	1741 поддерживают события для файловых систем произвольного типа.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1742 Другие операционные системы поддерживают события только для
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1743 основных файловых систем, таких как UFS или FFS.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1744 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1745
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1746 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1747
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1748 -->
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1749
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1750
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1751 <directive name="open_file_cache_min_uses">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1752 <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	1753 <default>1</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1754 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1755 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1756 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1757
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1758 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1759 Задаёт минимальное <value>число</value> обращений к файлу
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1760 в течение времени, заданного параметром <literal>inactive</literal>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1761 директивы <link id="open_file_cache"/>, необходимых для того, чтобы дескриптор
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1762 файла оставался открытым в кэше.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1763 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1764
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1765 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1766
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1767
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1768 <directive name="open_file_cache_valid">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1769 <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	1770 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1771 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1772 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1773 <context>location</context>
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1776 Определяет время, через которое следует проверять актуальность информации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1777 об элементе в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1778 <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	1779 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1780 При включенном
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1781 <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	1782 открытые дескрипторы файлов проверяются лишь единожды, а затем обновляются
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1783 по факту их изменения.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1784 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1785 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1786
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1787 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1788
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1789
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1790 <directive name="optimize_server_names">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1791 <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	1792 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1793 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1794 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1795
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1796 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1797 Директива устарела.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1798 Вместо неё следует использовать директиву <link id="server_name_in_redirect"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1799 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1800
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1801 <!--
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1802 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1803 Разрешает или запрещает оптимизировать проверку имени хоста в name-based
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1804 виртуальных серверах.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1805 Проверка в частности влияет на имя хоста, используемого в перенаправлениях.
381 8ad9df891e23 Fixed grammar. Ruslan Ermilov <ru@nginx.com> parents: 367 diff changeset	1806 Если оптимизация разрешена и все name-based серверы, слушающие на одной
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1807 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1808 имена не проверяются и в перенаправлениях используется первое имя сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1809 Если в перенаправлении нужно использовать имя хоста, переданное клиентом,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1810 то оптимизацию нужно выключить.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1811 </para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1812 -->
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1813
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1814 </directive>
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
1024 e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1817 <directive name="output_buffers">
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1818 <syntax><value>number</value> <value>size</value></syntax>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1819 <default>1 32k</default>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1820 <context>http</context>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1821 <context>server</context>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1822 <context>location</context>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1823
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1824 <para>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1825 Задаёт <value>число</value> и <value>размер</value> буферов,
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1826 используемых при чтении ответа с диска.
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1827 </para>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1828
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1829 </directive>
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1830
e47971bf6619 Documented output_buffers directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1023 diff changeset	1831
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1832 <directive name="port_in_redirect">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1833 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	1834 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1835 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1836 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1837 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1838
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1839 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	1840 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx’ом.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1841 </para>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1842
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1843 <para>
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	1844 Использование в перенаправлениях основного имени сервера управляется
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	1845 директивой <link id="server_name_in_redirect"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1846 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1847
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1848 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1849
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1850
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1851 <directive name="postpone_output">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1852 <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	1853 <default>1460</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1854 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1855 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1856 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1857
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1858 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1859 Если это возможно, то отправка данных клиенту будет отложена пока nginx не
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1860 накопит по крайней мере указанное количество байт для отправки.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1861 Значение 0 запрещает отложенную отправку данных.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1862 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1865
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1866
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1867 <directive name="read_ahead">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1868 <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	1869 <default>0</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1870 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1871 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1872 <context>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 Задаёт ядру размер предчтения при работе с файлами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1876 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1877
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1878 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1879 На Linux используется системный вызов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1880 <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	1881 поэтому параметр <value>размер</value> там игнорируется.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1882 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1883
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1884 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1885 На FreeBSD используется системный вызов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1886 <literal>fcntl(O_READAHEAD,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1887 </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	1888 появившийся во FreeBSD 9.0-CURRENT.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1889 Для FreeBSD 7 необходимо установить
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1890 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1891 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1892
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1893 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1894
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1895
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1896 <directive name="recursive_error_pages">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1897 <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	1898 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1899 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1900 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1901 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1902
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1903 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1904 Разрешает или запрещает делать несколько перенаправлений через директиву
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1905 <link id="error_page"/>.
709 a4648185190a Fixed the link internal to the module. Ruslan Ermilov <ru@nginx.com> parents: 679 diff changeset	1906 Число таких перенаправлений <link id="internal">ограничено</link>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1907 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1908
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1909 </directive>
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1912 <directive name="request_pool_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1913 <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	1914 <default>4k</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1915 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1916 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1917
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1918 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1919 Позволяет производить точную настройку выделений памяти
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1920 под конкретные запросы.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1921 Эта директива не оказывает существенного влияния на
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1922 производительность, и её не следует использовать.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1923 </para>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1926
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1927
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1928 <directive name="reset_timedout_connection">
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	1929 <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	1930 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1931 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1932 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1933 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1934
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1935 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1936 Разрешает или запрещает сброс соединений по таймауту.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1937 Сброс делается следующим образом.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1938 Перед закрытием сокета для него задаётся параметр
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1939 <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	1940 с таймаутом 0.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	1941 После этого при закрытии сокета клиенту отсылается TCP RST, а вся память,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1942 связанная с этим сокетом, освобождается.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1943 Это позволяет избежать длительного нахождения уже закрытого сокета в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1944 состоянии FIN_WAIT1 с заполненными буферами.
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1948 Необходимо отметить, что keep-alive соединения по истечении таймаута
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1949 закрываются обычным образом.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1950 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1951
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1952 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1953
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1954
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1955 <directive name="resolver">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1956 <syntax>
1031 f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1957 <value>адрес</value> ...
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1958 [<literal>valid</literal>=<value>время</value>]
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1959 [<literal>ipv6</literal>=<literal>on</literal>\|<literal>off</literal>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	1960 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1961 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1962 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1963 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1964
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1965 <para>
318 4a0fe9283dc7 Word polishing in the description of the "server" directive. Ruslan Ermilov <ru@nginx.com> parents: 280 diff changeset	1966 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1967 в адреса, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1968 <example>
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	1969 resolver 127.0.0.1 [::1]:5353;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1970 </example>
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	1971 Адрес может быть указан в виде доменного имени или IP-адреса,
566 f8148fc88224 Documented 1.2.2 changes. Ruslan Ermilov <ru@nginx.com> parents: 549 diff changeset	1972 и необязательного порта (1.3.1, 1.2.2).
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	1973 Если порт не указан, используется порт 53.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1974 Серверы DNS опрашиваются циклически.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1975 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1976 До версии 1.1.7 можно было задать лишь один DNS-сервер.
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	1977 Задание DNS-серверов с помощью IPv6-адресов поддерживается
566 f8148fc88224 Documented 1.2.2 changes. Ruslan Ermilov <ru@nginx.com> parents: 549 diff changeset	1978 начиная с версий 1.3.1 и 1.2.2.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1979 </note>
1031 f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1980 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1981 при преобразовании имён в адреса.
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1982 Если поиск IPv6-адресов нежелателен,
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1983 можно указать параметр <literal>ipv6=off</literal>.
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1984 <note>
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1985 Преобразование имён в IPv6-адреса поддерживается
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1986 начиная с версии 1.5.8.
f7f23f5928ef Documented "resolver ipv6=" parameter. Ruslan Ermilov <ru@nginx.com> parents: 1024 diff changeset	1987 </note>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1988 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	1989 Необязательный параметр <literal>valid</literal> позволяет это
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1990 переопределить:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1991 <example>
527 58d79f8c412d Documented 1.3.1 changes in "resolver". Ruslan Ermilov <ru@nginx.com> parents: 522 diff changeset	1992 resolver 127.0.0.1 [::1]:5353 valid=30s;
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1993 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1994 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1995 До версии 1.1.9 настройка времени кэширования была невозможна
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1996 и nginx всегда кэшировал ответы на срок в 5 минут.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	1997 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1998 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1999
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2000 </directive>
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 <directive name="resolver_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2004 <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	2005 <default>30s</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2006 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2007 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2008 <context>location</context>
76 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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2011 Задаёт таймаут для преобразования имени в адрес, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2012 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2013 resolver_timeout 5s;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2014 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2015 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2016
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2017 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2020 <directive name="root">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2021 <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	2022 <default>html</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2023 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2024 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2025 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2026 <context>if в location</context>
76 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>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2029 Задаёт корневой каталог для запросов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2030 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2031 <example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2032 location /i/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2033 root /data/w3;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2034 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2035 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2036 в ответ на запрос “<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	2037 <path>/data/w3/i/top.gif</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2038 </para>
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 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2041 В значении параметра <value>путь</value> можно использовать переменные,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2042 кроме <var>$document_root</var> и <var>$realpath_root</var>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2043 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2044
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2045 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2046 Путь к файлу формируется путём простого добавления URI к значению директивы
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2047 <literal>root</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2048 Если же URI необходимо поменять, следует воспользоваться директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2049 <link id="alias"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2050 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2051
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2052 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2055 <directive name="satisfy">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2056 <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	2057 <default>all</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2058 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2059 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2060 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2061
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2062 <para>
971 6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2063 Разрешает доступ, если все (<literal>all</literal>)
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2064 или хотя бы один (<literal>any</literal>) из модулей
971 6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2065 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>,
6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2066 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> или
6316a7579448 Documented the "ngx_http_auth_request" module. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	2067 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2068 разрешают доступ.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2069 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2070
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2071 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2072 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2073 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2074 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2075 satisfy any;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2076
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2077 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	2078 deny all;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2079
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2080 auth_basic "closed site";
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2081 auth_basic_user_file conf/htpasswd;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2082 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2083 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2084 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2085
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2086 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2087
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2088
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2089 <directive name="satisfy_any">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2090 <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	2091 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2092 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2093 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2094 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2095
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2096 <para>
406 98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them. Ruslan Ermilov <ru@nginx.com> parents: 400 diff changeset	2097 Эта директива была заменена параметром <literal>any</literal>
98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them. Ruslan Ermilov <ru@nginx.com> parents: 400 diff changeset	2098 директивы <link id="satisfy"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2099 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2100
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2101 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2102
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2103
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2104 <directive name="send_lowat">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2105 <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	2106 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2107 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2108 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2109 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2110
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2111 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2112 При установке этой директивы в ненулевое значение nginx будет пытаться
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2113 минимизировать число операций отправки на клиентских сокетах либо при
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2114 помощи флага <c-def>NOTE_LOWAT</c-def> метода
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2115 <link doc="../events.xml" id="kqueue"/>,
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2116 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>.
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2117 В обоих случаях будет использован указанный <value>размер</value>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2118 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2119
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2120 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2121 Эта директива игнорируется на Linux, Solaris и Windows.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2122 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2123
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2124 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2125
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2126
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2127 <directive name="send_timeout">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2128 <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	2129 <default>60s</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2130 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2131 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2132 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2133
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2134 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2135 Задаёт таймаут при передаче ответа клиенту.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2136 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2137 а только между двумя операциями записями.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2138 Если по истечении этого времени клиент ничего не примет,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2139 соединение будет закрыто.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2140 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2141
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2142 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2143
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2144
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2145 <directive name="sendfile">
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2146
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2147 <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	2148 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2149 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2150 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2151 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2152 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2153
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2154 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2155 Разрешает или запрещает использовать
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2156 <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	2157 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2158
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2159 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2160
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2161
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2162 <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	2163
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2164 <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	2165 <default>0</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2166 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2167 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2168 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2169
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2170 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2171 При установке в ненулевое значение ограничивает объём данных,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2172 который может передан за один вызов <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	2173 Без этого ограничения одно быстрое соединение может целиком
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2174 захватить рабочий процесс.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2175 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2176
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2177 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2178
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2179
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2180 <directive name="server">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	2181 <syntax block="yes"/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	2182 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2183 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2184
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2185 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2186 Задаёт конфигурацию для виртуального сервера.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2187 Чёткого разделения виртуальных серверов на IP-based (на основании IP-адреса)
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2188 и 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	2189 Вместо этого директивами <link id="listen"/> описываются все
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2190 адреса и порты, на которых нужно принимать соединения для этого сервера,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2191 а в директиве <link id="server_name"/> указываются все имена серверов.
522 ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts" Ruslan Ermilov <ru@nginx.com> parents: 507 diff changeset	2192 Примеры конфигураций описаны в документе
ef11546f75ee Translated "request_processing" into Russian, removed "virtual_hosts" Ruslan Ermilov <ru@nginx.com> parents: 507 diff changeset	2193 “<link doc="request_processing.xml"/>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2194 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2195
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2196 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2197
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2198
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2199 <directive name="server_name">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2200 <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	2201 <default>""</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2202 <context>server</context>
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>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2205 Задаёт имена виртуального сервера, например:
76 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 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2208 server_name example.com www.example.com;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2209 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2210 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2211 </para>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2214 Первое имя становится основным именем сервера.
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2215 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2216
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2217 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2218 В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2219 для замены первой или последней части имени:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2220 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2221 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2222 server_name example.com .example.com www.example.;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2223 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2224 </example>
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2225 Такие имена называются именами с маской.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2226 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2227
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2228 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2229 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2230 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2231 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2232 server_name .example.com;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2233 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2234 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2235 </para>
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 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2238 В качестве имени сервера можно также использовать регулярное выражение,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2239 указав перед ним тильду (“<literal>~</literal>”):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2240 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2241 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2242 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	2243 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2244 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2245 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2246
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2247 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2248 Регулярное выражение может содержать выделения (0.7.40),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2249 которые могут затем использоваться в других директивах:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2250 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2251 server {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2252 server_name ~^(www\.)?(.+)$;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2253
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2254 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2255 root /sites/$2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2256 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2257 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2258
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2259 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2260 server_name _;
76 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 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2263 root /sites/default;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2264 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2265 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2266 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2267 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2268
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2269 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2270 Именованные выделения в регулярном выражении создают переменные (0.8.25),
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2271 которые могут затем использоваться в других директивах:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2272 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2273 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2274 server_name ~^(www\.)?(?<domain>.+)$;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2275
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2276 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2277 root /sites/$domain;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2278 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2279 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2280
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2281 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2282 server_name _;
76 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 / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2285 root /sites/default;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2286 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2287 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2288 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2289 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2290
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2291 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2292 Если параметр директивы установлен в “<var>$hostname</var>” (0.9.4), то
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2293 подставляется имя хоста (hostname) машины.
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2294 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2295
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2296 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2297 Возможно также указать пустое имя сервера (0.7.11):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2298 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2299 server {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2300 server_name www.example.com "";
76 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 </example>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2303 Это позволяет обрабатывать запросы без поля <header>Host</header> заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2304 запроса в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2305 Это настройка по умолчанию.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2306 <note>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2307 До 0.8.48 по умолчанию использовалось имя хоста (hostname) машины.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2308 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2309 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2310
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2311 <para>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2312 При поиске виртуального сервера по имени,
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2313 если имени соответствует несколько из указанных вариантов,
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2314 например, одновременно подходят и имя с маской, и регулярное выражение,
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2315 будет выбран первый подходящий вариант в следующем порядке приоритета:
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2316 <list type="enum">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2317
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2318 <listitem>
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2319 точное имя
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2320 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2321
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2322 <listitem>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2323 самое длинное имя с маской в начале,
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2324 например “<literal>*.example.com</literal>”
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2325 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2326
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2327 <listitem>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2328 самое длинное имя с маской в конце,
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2329 например “<literal>mail.*</literal>”
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2330 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2331
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2332 <listitem>
587 5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2333 первое подходящее регулярное выражение
5bb7716cae7e Documented in more depth how server names are matched. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	2334 (в порядке следования в конфигурационном файле)
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2335 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2336
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2337 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2338 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2339
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2340 <para>
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2341 Подробнее имена серверов обсуждаются в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2342 <link doc="server_names.xml">документе</link>.
646 2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2343 </para>
2577ab264d1e Updated the Russian version of the "server_name" directive. Vladimir Homutov <vl@nginx.com> parents: 629 diff changeset	2344
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2345 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2346
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2347
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2348 <directive name="server_name_in_redirect">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2349 <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	2350 <default>off</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2351 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2352 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2353 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2354
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2355 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	2356 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2357 основное имя сервера, задаваемое директивой
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2358 <link id="server_name"/>.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2359 Если использование основного имени сервера запрещено, то используется имя,
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2360 указанное в поле <header>Host</header> заголовка запроса.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2361 Если же этого поля нет, то используется IP-адрес сервера.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2362 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2363
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2364 <para>
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2365 Использование в перенаправлениях порта управляется
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2366 директивой <link id="port_in_redirect"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2367 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2368
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2369 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2370
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2371
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2372 <directive name="server_names_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2373 <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	2374 <default>32\|64\|128</default>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2375 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2376
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2377 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2378 Задаёт размер корзины в хэш-таблицах имён серверов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2379 Значение по умолчанию зависит от размера строки кэша процессора.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2380 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2381 <link doc="../hash.xml">документе</link>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2382 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2383
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2384 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2385
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2386
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2387 <directive name="server_names_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2388 <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	2389 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2390 <context>http</context>
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 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2393 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2394 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2395 <link doc="../hash.xml">документе</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2396 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2397
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2398 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2399
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2400
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2401 <directive name="server_tokens">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2402 <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	2403 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2404 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2405 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2406 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2407
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2408 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	2409 Разрешает или запрещает выдавать версию nginx’а в сообщениях об ошибках и
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2410 в поле <header>Server</header> заголовка ответа.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2411 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2412
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2413 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2414
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2415
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2416 <directive name="tcp_nodelay">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2417 <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	2418 <default>on</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2419 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2420 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2421 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2422
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2423 <para>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2424 Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>.
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2425 Параметр включаются только при переходе соединения в состояние keep-alive.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2426 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2427
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2428 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2429
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 <directive name="tcp_nopush">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2432 <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	2433 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2434 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2435 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2436 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2437
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2438 <para>
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2439 Разрешает или запрещает использование параметра сокета
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2440 <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	2441 <c-def>TCP_CORK</c-def> в Linux.
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2442 Параметр включаются только при использовании <link id="sendfile"/>.
368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	2443 Включение параметра позволяет
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2444 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2445
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2446 <listitem>
253 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 в Linux и во FreeBSD 4.*;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2449 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2450
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2451 <listitem>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2452 передавать файл полными пакетами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2453 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2454
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2455 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2456 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2457
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2458 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2459
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2460
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2461 <directive name="try_files">
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2462 <syntax><value>файл</value> ... <value>uri</value></syntax>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2463 <syntax><value>файл</value> ... =<value>код</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	2464 <default/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2465 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2466 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2467
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2468 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2469 Проверяет существование файлов в заданном порядке и использует
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2470 для обработки запроса первый найденный файл, причём обработка
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	2471 делается в контексте этого же location’а.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2472 Путь к файлу строится из параметра <value>файл</value>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2473 в соответствии с директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2474 <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	2475 С помощью слэша в конце имени можно проверить существование каталога,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2476 например, “<literal>$uri/</literal>”.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2477 В случае, если ни один файл не найден, то делается внутреннее
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2478 перенаправление на <value>uri</value>, заданный последним параметром.
253 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 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2481 location /images/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2482 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	2483 }
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 location = /images/default.gif {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2486 expires 30s;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2487 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2488 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2489 Последний параметр может также указывать на именованный location,
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2490 как в примерах ниже.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2491 С версии 0.7.51 последний параметр может также быть <value>кодом</value>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2492 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2493 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2494 try_files $uri $uri/index.html $uri.html =404;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2495 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2496 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2497 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2498
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2499 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2500 Пример использования при проксировании Mongrel:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2501 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2502 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2503 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	2504 $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	2505 @mongrel;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2506 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2507
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2508 location @mongrel {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2509 proxy_pass http://mongrel;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2510 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2511 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2512 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2513
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2514 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2515 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2516 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2517 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2518 try_files $uri $uri/ @drupal;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2519 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2520
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2521 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2522 try_files $uri @drupal;
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 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2525
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2526 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	2527 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	2528 fastcgi_param QUERY_STRING $args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2529
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2530 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2531 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2532
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2533 location @drupal {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2534 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2535
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2536 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	2537 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	2538 fastcgi_param QUERY_STRING q=$uri&$args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2539
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2540 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2541 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2542 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2543 В следующем примере директива <literal>try_files</literal>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2544 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2545 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2546 try_files $uri $uri/ @drupal;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2547 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2548 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2549 аналогична директивам
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2550 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2551 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2552 error_page 404 = @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2553 log_not_found off;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2554 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2555 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2556 А здесь
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2557 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2558 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2559 try_files $uri @drupal;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2560
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2561 fastcgi_pass ...;
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 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2564
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2565 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2566 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2567 </example>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2568 <literal>try_files</literal> проверяет существование PHP-файла,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2569 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2570 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2571
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2572 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2573 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2574 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2575 location / {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2576 try_files $uri $uri/ @wordpress;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2577 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2578
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2579 location ~ \.php$ {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2580 try_files $uri @wordpress;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2581
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2582 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2583
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2584 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2585 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2586 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2587
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2588 location @wordpress {
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2589 fastcgi_pass ...;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2590
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2591 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2592 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2593 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2594 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2595 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2596
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2597 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2598
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2599
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2600 <directive name="types">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	2601 <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	2602 <default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2603 text/html html;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2604 image/gif gif;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2605 image/jpeg jpg;
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	2606 </default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2607 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2608 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2609 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2610
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2611 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2612 Задаёт соответствие расширений имён файлов и MIME-типов ответов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2613 Расширения нечувствительны к регистру символов.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2614 Одному MIME-типу может соответствовать несколько расширений, например:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2615 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2616 types {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2617 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	2618 application/octet-stream deb;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2619 application/octet-stream dmg;
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2620 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2621 </example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2622 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2623
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2624 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2625 Достаточно полная таблица соответствий входит в дистрибутив nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2626 и находится в файле <path>conf/mime.types</path>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2627 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2628
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2629 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 958 diff changeset	2630 Для того чтобы для определённого location’а для всех ответов
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2631 выдавался 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	2632 можно использовать следующее:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2633 <example>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2634 location /download/ {
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2635 types { }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2636 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	2637 }
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2638 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2639 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2640
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2641 </directive>
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
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2644 <directive name="types_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2645 <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	2646 <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	2647 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2648 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2649 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2650
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2651 <para>
253 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 Значение по умолчанию зависит от размера строки кэша процессора.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2654 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2655 <link doc="../hash.xml">документе</link>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	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 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2659
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2660
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2661 <directive name="types_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2662 <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	2663 <default>1024</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2664 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2665 <context>server</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2666 <context>location</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2667
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2668 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2669 Задаёт максимальный <value>размер</value> хэш-таблиц типов.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2670 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2671 <link doc="../hash.xml">документе</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2672 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2673
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2674 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2675
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2676
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2677 <directive name="underscores_in_headers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2678 <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	2679 <default>off</default>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2680 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2681 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2682
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2683 <para>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2684 Разрешает или запрещает использование символов подчёркивания в
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2685 полях заголовка запроса клиента.
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2686 Если использование символов подчёркивания запрещено, поля заголовка запроса, в
fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2687 именах которых есть подчёркивания,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2688 помечаются как недопустимые и подпадают под действие директивы
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2689 <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	2690 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2691
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	2692 <para>
1023 375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	2693 Если директива указана на уровне <link id="server"/>,
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	2694 её значение используется только в том случае,
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	2695 если сервер является сервером по умолчанию.
375055da60fa Improved wording of merge_slashes etc. (ticket #448). Maxim Dounin <mdounin@mdounin.ru> parents: 971 diff changeset	2696 Указанное значение распространяется на все виртуальные серверы,
426 1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	2697 слушающие на том же адресе и порту.
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	2698 </para>
1d6dc85ed324 Specifying "ignore_invalid_headers" or "underscores_in_headers" on the Ruslan Ermilov <ru@nginx.com> parents: 419 diff changeset	2699
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2700 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2701
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2702
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2703 <directive name="variables_hash_bucket_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2704 <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	2705 <default>64</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2706 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2707
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2708 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2709 Задаёт размер корзины в хэш-таблице переменных.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2710 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2711 <link doc="../hash.xml">документе</link>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2712 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2713
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2714 </directive>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2715
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2716
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2717 <directive name="variables_hash_max_size">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2718 <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	2719 <default>512</default>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2720 <context>http</context>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2721
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2722 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2723 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
659 77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2724 Подробнее настройка хэш-таблиц обсуждается в отдельном
77a3314c74a7 Avoid the uses of second person. Ruslan Ermilov <ru@nginx.com> parents: 651 diff changeset	2725 <link doc="../hash.xml">документе</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2726 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2727
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2728 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2729
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2730 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2731
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2732
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2733 <section id="variables" name="Встроенные переменные">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2734
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2735 <para>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2736 Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 318 diff changeset	2737 переменные, имена которых совпадают с именами переменных веб-сервера Apache.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2738 Прежде всего, это переменные, представляющие из себя поля заголовка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2739 запроса клиента, такие как <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	2740 и тому подобное.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2741 Кроме того, есть и другие переменные:
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2742 <list type="tag">
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2743
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2744 <tag-name id="var_arg_"><var>$arg_</var><value>имя</value></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2745 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2746 аргумент <value>имя</value> в строке запроса
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2747 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2748
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2749 <tag-name id="var_args"><var>$args</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2750 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2751 аргументы в строке запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2752 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2753
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2754 <tag-name id="var_binary_remote_addr"><var>$binary_remote_addr</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2755 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2756 адрес клиента в бинарном виде, длина значения всегда 4 байта
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2757 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2758
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2759 <tag-name id="var_body_bytes_sent"><var>$body_bytes_sent</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2760 <tag-desc>
769 d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2761 число байт, переданное клиенту, без учёта заголовка ответа;
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2762 переменная совместима с параметром “<literal>%B</literal>” модуля Apache
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2763 <literal>mod_log_config</literal>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2764 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2765
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2766 <tag-name id="var_bytes_sent"><var>$bytes_sent</var></tag-name>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2767 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2768 число байт, переданное клиенту (1.3.8, 1.2.5)
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2769 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2770
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2771 <tag-name id="var_connection"><var>$connection</var></tag-name>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2772 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2773 порядковый номер соединения (1.3.8, 1.2.5)
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2774 </tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2775
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2776 <tag-name id="var_connection_requests"><var>$connection_requests</var></tag-name>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2777 <tag-desc>
d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	2778 текущее число запросов в соединении (1.3.8, 1.2.5)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2779 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2780
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2781 <tag-name id="var_content_length"><var>$content_length</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2782 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2783 поле <header>Content-Length</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2784 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2785
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2786 <tag-name id="var_content_type"><var>$content_type</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2787 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2788 поле <header>Content-Type</header> заголовка запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2789 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2790
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2791 <tag-name id="var_cookie_"><var>$cookie_</var><value>имя</value></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2792 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2793 cookie <value>имя</value>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2794 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2795
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2796 <tag-name id="var_document_root"><var>$document_root</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2797 <tag-desc>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	2798 значение директивы <link id="root"/> или <link id="alias"/>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	2799 для текущего запроса
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2800 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2801
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2802 <tag-name id="var_document_uri"><var>$document_uri</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2803 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2804 то же, что и <var>$uri</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2805 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2806
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2807 <tag-name id="var_host"><var>$host</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2808 <tag-desc>
940 ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	2809 в порядке приоритета:
ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	2810 имя хоста из строки запроса, или
ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	2811 имя хоста из поля <header>Host</header> заголовка запроса, или
ded8f4a5de28 Corrected description of the $host variable. Ruslan Ermilov <ru@nginx.com> parents: 914 diff changeset	2812 имя сервера, соответствующего запросу
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2813 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2814
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2815 <tag-name id="var_hostname"><var>$hostname</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2816 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2817 имя хоста
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2818 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2819
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2820 <tag-name id="var_http_"><var>$http_</var><value>имя</value></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2821 <tag-desc>
448 92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	2822 произвольное поле заголовка запроса;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	2823 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	2824 к нижнему регистру, с заменой символов тире на символы подчёркивания
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2825 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2826
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2827 <tag-name id="var_https"><var>$https</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2828 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2829 “<literal>on</literal>”
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2830 если соединение работает в режиме SSL,
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2831 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2832 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2833
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2834 <tag-name id="var_is_args"><var>$is_args</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2835 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2836 “<literal>?</literal>”, если в строке запроса есть аргументы,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2837 и пустая строка, если их нет
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2838 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2839
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2840 <tag-name id="var_limit_rate"><var>$limit_rate</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2841 <tag-desc>
767 1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	2842 установка этой переменной позволяет ограничивать скорость
1bb8b733416a Clarified the description of the limit_rate directive Ruslan Ermilov <ru@nginx.com> parents: 741 diff changeset	2843 передачи ответа, см. <link id="limit_rate"/>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2844 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2845
771 47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2846 <tag-name id="var_msec"><var>$msec</var></tag-name>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2847 <tag-desc>
779 32b8498cfb40 $msec and $request_time have become generic variables in 1.2.6. Ruslan Ermilov <ru@nginx.com> parents: 771 diff changeset	2848 текущее время в секундах с точностью до миллисекунд (1.3.9, 1.2.6)
771 47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2849 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2850
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2851 <tag-name id="var_nginx_version"><var>$nginx_version</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2852 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2853 версия nginx
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2854 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2855
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2856 <tag-name id="var_pid"><var>$pid</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2857 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2858 номер (PID) рабочего процесса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2859 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2860
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2861 <tag-name id="var_pipe"><var>$pipe</var></tag-name>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2862 <tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2863 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	2864 (1.3.12, 1.2.7)
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2865 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2866
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2867 <tag-name id="var_query_string"><var>$query_string</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2868 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2869 то же, что и <var>$args</var>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2870 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2871
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2872 <tag-name id="var_realpath_root"><var>$realpath_root</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2873 <tag-desc>
436 3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	2874 абсолютный путь, соответствующий
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	2875 значению директивы <link id="root"/> или <link id="alias"/>
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	2876 для текущего запроса,
3a9f39341c7c - Documented the "from" parameter of the "disable_symlinks" directive, Ruslan Ermilov <ru@nginx.com> parents: 431 diff changeset	2877 в котором все символические ссылки преобразованы в реальные пути
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2878 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2879
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2880 <tag-name id="var_remote_addr"><var>$remote_addr</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2881 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2882 адрес клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2883 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2884
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2885 <tag-name id="var_remote_port"><var>$remote_port</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2886 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2887 порт клиента
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2888 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2889
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2890 <tag-name id="var_remote_user"><var>$remote_user</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2891 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2892 имя пользователя, использованное в Basic аутентификации
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2893 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2894
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2895 <tag-name id="var_request"><var>$request</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2896 <tag-desc>
431 0412333658fe Consistent translation of "original". Ruslan Ermilov <ru@nginx.com> parents: 429 diff changeset	2897 первоначальная строка запроса целиком
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2898 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2899
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2900 <tag-name id="var_request_body"><var>$request_body</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2901 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2902 тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2903 <para>
625 af3f38e349eb Removed terminal whitespace and fixed apostrophes used. Ruslan Ermilov <ru@nginx.com> parents: 617 diff changeset	2904 Значение переменной появляется в location’ах, обрабатываемых
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2905 директивами
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	2906 <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	2907 и
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2908 <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	2909 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2910 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2911
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2912 <tag-name id="var_request_body_file"><var>$request_body_file</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2913 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2914 имя временного файла, в котором хранится тело запроса
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2915 <para>
958 fd1f8e0a405e Text review of ngx_http_core_module. Egor Nikitin <yegor.nikitin@gmail.com> parents: 948 diff changeset	2916 По завершении обработки файл необходимо удалить.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 958 diff changeset	2917 Для того чтобы тело запроса всегда записывалось в файл,
406 98dac2bd7598 Links with mixed underscores and spaces were hard to read, eliminated them. Ruslan Ermilov <ru@nginx.com> parents: 400 diff changeset	2918 следует включить <link id="client_body_in_file_only"/>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2919 При передаче имени временного файла в проксированном запросе
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2920 или в запросе к FastCGI-серверу следует запретить передачу самого
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2921 тела директивами
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2922 <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	2923 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	2924 или
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2925 <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	2926 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	2927 соответственно.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2928 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2929 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2930
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2931 <tag-name id="var_request_completion"><var>$request_completion</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2932 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2933 “<literal>OK</literal>” если запрос завершился,
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2934 либо пустая строка
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2935 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2936
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2937 <tag-name id="var_request_filename"><var>$request_filename</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2938 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2939 путь к файлу для текущего запроса, формируемый из директив
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2940 <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	2941 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2942
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2943 <tag-name id="var_request_length"><var>$request_length</var></tag-name>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2944 <tag-desc>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	2945 длина запроса (включая строку запроса, заголовок и тело запроса)
9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	2946 (1.3.12, 1.2.7)
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2947 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	2948
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2949 <tag-name id="var_request_method"><var>$request_method</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2950 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2951 метод запроса, обычно
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2952 “<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	2953 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2954
771 47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2955 <tag-name id="var_request_time"><var>$request_time</var></tag-name>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2956 <tag-desc>
779 32b8498cfb40 $msec and $request_time have become generic variables in 1.2.6. Ruslan Ermilov <ru@nginx.com> parents: 771 diff changeset	2957 время обработки запроса в секундах с точностью до миллисекунд
32b8498cfb40 $msec and $request_time have become generic variables in 1.2.6. Ruslan Ermilov <ru@nginx.com> parents: 771 diff changeset	2958 (1.3.9, 1.2.6);
771 47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2959 время, прошедшее с момента чтения первых байт от клиента
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2960 </tag-desc>
47ad88faaa3f $msec and $request_time have become generic variables in 1.3.9. Ruslan Ermilov <ru@nginx.com> parents: 769 diff changeset	2961
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2962 <tag-name id="var_request_uri"><var>$request_uri</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2963 <tag-desc>
431 0412333658fe Consistent translation of "original". Ruslan Ermilov <ru@nginx.com> parents: 429 diff changeset	2964 первоначальный URI запроса целиком (с аргументами)
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2965 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2966
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2967 <tag-name id="var_scheme"><var>$scheme</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2968 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2969 схема запроса, “<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	2970 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2971
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2972 <tag-name id="var_sent_http_"><var>$sent_http_</var><value>имя</value></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2973 <tag-desc>
448 92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	2974 произвольное поле заголовка ответа;
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	2975 последняя часть имени переменной соответствует имени поля, приведённому
92672f6f0ee1 Elaborated on $http_* and $sent_http_* syntax. Ruslan Ermilov <ru@nginx.com> parents: 442 diff changeset	2976 к нижнему регистру, с заменой символов тире на символы подчёркивания
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2977 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2978
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2979 <tag-name id="var_server_addr"><var>$server_addr</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2980 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2981 адрес сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2982 <para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2983 Получение значения этой переменной обычно требует одного системного вызова.
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2984 Чтобы избежать системного вызова, в директивах <link id="listen"/>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	2985 следует указывать адреса и использовать параметр <literal>bind</literal>.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2986 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2987 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2988
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2989 <tag-name id="var_server_name"><var>$server_name</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2990 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2991 имя сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2992 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2993
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2994 <tag-name id="var_server_port"><var>$server_port</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2995 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2996 порт сервера, принявшего запрос
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2997 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	2998
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	2999 <tag-name id="var_server_protocol"><var>$server_protocol</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3000 <tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3001 протокол сервера, обычно
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3002 “<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	3003 или
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	3004 “<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	3005 </tag-desc>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3006
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3007 <tag-name id="var_status"><var>$status</var></tag-name>
541 a8971cf346be Documented the $status core variable. Andrey Belov <defan@nginx.com> parents: 537 diff changeset	3008 <tag-desc>
769 d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 768 diff changeset	3009 статус ответа (1.3.2, 1.2.2)
541 a8971cf346be Documented the $status core variable. Andrey Belov <defan@nginx.com> parents: 537 diff changeset	3010 </tag-desc>
a8971cf346be Documented the $status core variable. Andrey Belov <defan@nginx.com> parents: 537 diff changeset	3011
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3012 <tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3013 <tag-desc>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3014 локальное время в формате по стандарту ISO 8601 (1.3.12, 1.2.7)
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3015 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3016
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3017 <tag-name id="var_time_local"><var>$time_local</var></tag-name>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3018 <tag-desc>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 835 diff changeset	3019 локальное время в Common Log Format (1.3.12, 1.2.7)
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3020 </tag-desc>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 810 diff changeset	3021
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3022 <tag-name id="var_tcpinfo_">
453 98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3023 <var>$tcpinfo_rtt</var>,
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3024 <var>$tcpinfo_rttvar</var>,
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3025 <var>$tcpinfo_snd_cwnd</var>,
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3026 <var>$tcpinfo_rcv_space</var>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3027 </tag-name>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3028 <tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3029 информация о клиентском TCP-соединении; доступна на системах,
617 368a449e85b8 Expanded documentation of what various parameters of the "listen" Ruslan Ermilov <ru@nginx.com> parents: 615 diff changeset	3030 поддерживающих параметр сокета <c-def>TCP_INFO</c-def>
453 98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3031 </tag-desc>
98ee97a382d3 Documented the $tcpinfo_* variables. Ruslan Ermilov <ru@nginx.com> parents: 448 diff changeset	3032
768 f63b7fa3bf17 Added "id" attributes to http core module variables. Vladimir Homutov <vl@nginx.com> parents: 767 diff changeset	3033 <tag-name id="var_uri"><var>$uri</var></tag-name>
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3034 <tag-desc>
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3035 текущий URI запроса в <link id="location">нормализованном</link> виде
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3036 <para>
503 aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3037 Значение <var>$uri</var> может изменяться в процессе обработки запроса,
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3038 например, при внутренних перенаправлениях
aed015c3dedd Documented URI normalization rules, including %-decoding. Ruslan Ermilov <ru@nginx.com> parents: 499 diff changeset	3039 или при использовании индексных файлов.
253 ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3040 </para>
ff1e139a8c98 Bring the ngx_http_core_module documentation up to date. Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	3041 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3042
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3043 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3044 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3045
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3046 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3047
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3048 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 1035:e9c485d6cc0c