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

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 76:4a4caa566120

Russian documentation import. Changes in module.dtd: <example> now allowed to contain <value> and <emphasis> elements (we need this to show important parts in examples), less strict checking of <directive> syntax (we don't want to fully document some directives, notably deprecated ones). Known issues: 1. <syntax> elements are preserved as is, they will require manual conversion (likely to some not-yet-existed format a la DocBook cmdsynopsis, as currently used one seems to be incomplete); 2. <value> no longer corresponds to replaceable content, and it's use in examples isn't correct; 3. <link doc="document#fragment"> doesn't work with current xslt, either should be supported or changed to <link doc="document" id="fragment">. The following files are intentionally omitted: maillists.xml (support.xml should be used instead), experimental.xml (obsolete), faq.xml (conflicts with existing one, needs discussion). Not yet linked to site.

author	Maxim Dounin <mdounin@mdounin.ru>
date	Tue, 11 Oct 2011 12:57:50 +0000
parents
children	0a45870d0160

rev	line source
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1 <?xml version="1.0" encoding="utf-8"?>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	4
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	5 <module name="Директивы модуля ngx_http_core_module"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	6 link="/ru/docs/http/ngx_http_core_module.html"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	7 lang="ru">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	9 <section name="Директивы" id="directives">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	10
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 <directive name="aio">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	12 <syntax>aio <value>[on\|off\|sendfile]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	13 <default>aio off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	15
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17 Директива (0.8.11) разрешает или запрещает использовать файловый AIO
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	18 во FreeBSD и Linux.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	19 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	20
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	21 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	22 Во FreeBSD AIO можно использовать, начиная с FreeBSD 4.3 версии.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	23 AIO можно собрать в ядре статически
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	24 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	25 options VFS_AIO
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	26 </example>
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 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	29 kldload aio
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	30 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	31 </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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	34 Во FreeBSD 5 и 6 при включении AIO статически или динамически на стадии
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	35 загрузки ядра вся сетевая подсистема будет использовать GiantLock,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	36 что может негативно сказаться на производительности системы в целом.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	37 Эта зависимость устранена во FreeBSD-6.4 STABLE от 2009 года и во FreeBSD 7.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	38 Однако, начиная с FreeBSD 5.3, есть возможность включать AIO,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	39 не связывая сетевую подсистему GiantLock'ом — для этого модуль AIO
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	40 нужно подгружать уже после загрузки ядра.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	41 В этом случае в /var/log/messages появится сообщение
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 WARNING: Network stack Giant-free, but aio requires Giant.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	44 Consider adding 'options NET_WITH_GIANT' or setting debug.mpsafenet=0
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	45 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	46 которое можно смело проигнорировать.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	47 <note>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	48 Требование использовать GiantLock в AIO связано с тем, что FreeBSD
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	49 поддерживает асинхронные вызовы aio_read()/aio_write() для работы с сокетами.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	50 Но поскольку nginx использует AIO только для работы с диском, то проблем
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	51 не возникает.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	52 </note>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	53 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	54
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	55 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	56 Для работы AIO нужно выключить sendfile:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	57 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	58 location /video/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	59 sendfile off;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	60 aio on;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	61 output_buffers 1 64k;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	62 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	63 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	64 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	65
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	66 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	67 Кроме того, начиная с FreeBSD 5.2.1 и nginx-0.8.12, AIO также можно
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	68 использовать для подгрузки данных для sendfile():
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	69 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70 location /video/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	71 sendfile on;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72 tcp_nopush on;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73 aio sendfile;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	74 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	75 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	76 В такой конфигурации используется флаг SF_NODISKIO и sendfile()
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	77 не блокируется на диске, а сообщает об отсутствии данных в памяти,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	78 после чего nginx инициирует асинхронную подгрузку данных,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	79 читая только один байт. При этом ядро FreeBSD подгружает в память
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	80 первые 128K файла, однако при последующих чтениях файл подгружается
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	81 частями только по 16K. Изменить это можно с помощью директивы
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	82 <link id="read_ahead">read_ahead</link>.
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	86 В Linux AIO можно использовать, только начиная с версии ядра 2.6.22,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	87 и, кроме того, ещё необходимо дополнительно включать
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	88 <link id="directio">directio</link>, иначе чтение будет блокирующимся:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	90 location /video/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	91 aio on;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	92 directio 512;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	93 output_buffers 1 128k;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	94 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	95 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	96 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	97
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	98 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99 Поскольку directio в Linux можно использовать только для чтения блоков,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	100 выравненных по 512 байт (или 4К для XFS), то невыравненный конец файла
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101 будет читаться блокировано. То же относится к запросам части ответа
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	102 byte-ranges и к запросам FLV не с начала файла: чтение невыровненных начала
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	103 и конца ответа будет блокирующимся. sendfile выключать не нужно, так
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	104 как при использовании directio он выключается сам.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	105 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	106
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	107 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	108
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	109
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110 <directive name="alias">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	111 <syntax>alias <value>путь</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	112 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	113 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	114
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116 Директива задаёт замену для указанного location'а.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	117 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	118 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	119 location /i/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	120 alias /data/w3/images/;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	121 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	122 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	123 на запрос "/i/top.gif" будет отдан файл "/data/w3/images/top.gif".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	124 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	125
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	126 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	127 В значении пути можно использовать переменные.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	128 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	129
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	130 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	131 Если директива alias используется внутри location'а, заданного
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	132 регулярным выражением, то регулярное выражение должно содержать выделения,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	133 а директива alias — ссылки на эти выделения (0.7.40), например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	134 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	135 location ~ ^/users/(.+\.(?:gif\|jpe?g\|png))$ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	136 alias /data/w3/images/$1;
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 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	139 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	140
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	141 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	142 Если location и последняя часть значения директивы совпадают:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	143 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	144 location /images/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	145 alias /data/w3/images/;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	146 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	147 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	148 то лучше воспользоваться директивой <link id="root"/>:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	149 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	150 location /images/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	151 root /data/w3;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	152 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	153 </example>
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	157
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	158
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	159 <directive name="client_body_in_file_only">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	160 <syntax>client_body_in_file_only <value>on\|clean\|off</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	161 <default>client_body_in_file_only off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	162 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	163
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	164 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	165 Директива определяет, сохранять ли всё тело запроса клиента в файл.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	166 Директиву можно использовать для отладки и при использовании
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	167 переменной $request_body_file или метода <link doc="ngx_http_perl_module.xml#methods">$r->request_body_file</link>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	168 модуля ngx_http_perl_module.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	169 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	170
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 При использовании параметра "on" временные файлы по окончании
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	173 обработки запроса не удаляется.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	174 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	175
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	176 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	177 Параметр "clean" разрешает удалять временные файлы, оставшиеся по окончании
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	178 обработки запроса.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	179 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	180
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	181 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	182
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	183
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	184 <directive name="client_body_in_single_buffer">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	185 <syntax>client_body_in_single_buffer <value>on\|off</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	186 <default>client_body_in_single_buffer off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	187 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	188
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	189 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	190 Директива определяет, хранить ли всё тело запроса клиента в одном буфере.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	191 Директива рекомендуется при использовании переменной $request_body
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	192 для уменьшения операций копирования.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	193 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	194
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	195 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	196
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	197
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	198 <directive name="client_body_buffer_size">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	199 <syntax>client_body_buffer_size <value>размер</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	200 <default>client_body_buffer_size 8k/16k</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	201 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	202
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	203 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	204 Директива задаёт размер буфера для чтения тела запроса клиента.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	205 Если тело запроса больше заданного буфера, то всё тело запроса или только
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	206 его часть записывается во временный файл.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	207 По умолчанию размер одного буфера равен двум размерам страницы, в зависимости
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	208 от платформы это или 8K, или 16K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	209 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	210
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	211 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	212
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	213
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	214 <directive name="client_body_temp_path">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	215 <syntax>client_body_temp_path <value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ]
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	216 </value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	217 <default>client_body_temp_path client_body_temp</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	218 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	220 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	221 Директива задаёт имя каталога для хранения временных файлов с телом запроса
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	222 клиента.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	223 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	224 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	225 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226 client_body_temp_path /spool/nginx/client_temp 1 2;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	227 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	228 имя временного будет такого вида:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	229 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	230 /spool/nginx/client_temp/7/45/00000123457
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	231 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	232 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	233
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	234 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	235
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	236
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	237 <directive name="client_body_timeout">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	238 <syntax>client_body_timeout <value>время</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	239 <default>client_body_timeout 60</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	240 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	241
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	242 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	243 Директива задаёт таймаут при чтении тела запроса клиента.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	244 Таймаут устанавливается не на всю передачу тела запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	245 а только между двумя операциями чтения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	246 Если по истечении этого времени клиент ничего не передаст,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	247 то ему возвращается ошибка "Request time out" (408).
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	251
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	252
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	253 <directive name="client_header_buffer_size">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	254 <syntax>client_header_buffer_size <value>размер</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	255 <default>client_header_buffer_size 1k</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	256 <context>http, server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	257
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 Для подавляющего большинства запросов вполне достаточно буфера размером в 1K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	261 Однако если в запросе есть большие cookies или же запрос пришёл
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	262 от wap-клиента, то он может не поместиться в 1K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263 Поэтому, если строка запроса или строка заголовка запроса не помещается
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	264 полностью в этот буфер, то выделяются большие буферы, задаваемые директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	265 <link id="large_client_header_buffers"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	266 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	267
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	268 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	271 <directive name="client_header_timeout">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	272 <syntax>client_header_timeout <value>время</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	273 <default>client_header_timeout 60</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	274 <context>http, server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	275
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	276 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	277 Директива задаёт таймаут при чтении заголовка запроса клиента.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	278 Если по истечении этого времени клиент не передаст полностью заголовок
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	279 запроса, то ему возвращается ошибка "Request time out" (408).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	280 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	281
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	282 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	283
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	284
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	285 <directive name="client_max_body_size">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	286 <syntax>client_max_body_size <value>размер</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	287 <default>client_max_body_size 1m</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	288 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	289
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	290 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	291 Директива задаёт максимально допустимый размер тела запроса клиента,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	292 указываемый в строке "Content-Length" в заголовке запроса.
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 "Request Entity Too Large" (413). Следует иметь в виду, что
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	295 <link url="http://sysoev.ru/web/upload.html">браузеры не умеют
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	296 корректно показывать эту ошибку</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	297 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	298
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	299 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	300
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	301
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	302 <directive name="default_type">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	303 <syntax>default_type <value>MIME-тип</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	304 <default>default_type text/plain</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	305 <context>http, server, location</context>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	308 Директива задаёт MIME-тип ответов по умолчанию.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	309 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	310
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	311 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	312
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 <directive name="directio">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	315 <syntax>directio <value>[размер\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	316 <default>directio off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	317 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	318
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	319 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	320 Директива (0.7.7) разрешает использовать флаги
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	321 O_DIRECT (FreeBSD, Linux), F_NOCACHE (Mac OS X) или функцию directio() (Solaris)
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 Директива автоматически запрещает (0.7.15) использование
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	324 <link id="sendfile">sendfile'а</link> для данного запроса.
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 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	327 directio 4m;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	328 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	329 или при использовании <link id="aio">aio</link> в Linux.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	330 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	331
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	332 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	333
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	334
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	335 <directive name="directio_alignment">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	336 <syntax>directio_alignment <value>размер</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	337 <default>directio_alignment 512</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	338 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	339
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	340 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	341 Директива (0.8.11) устанавливает выравнивание для
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	342 <link id="directio">directio</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	343 В большинстве случае достаточно выравнивания 512 байт, однако
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	344 при использовании XFS под Linux его нужно увеличить до 4K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	345 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	346
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	347 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	348
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	349
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	350 <directive name="error_page">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	351 <syntax>error_page <value>код [код ...] [=\|=ответ] uri</value>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	352 </syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	353 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	354 <context>http, server, location, if в location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	355
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	356 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	357 Директива задаёт URI, который будет показываться для указанных ошибок.
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 уровне не описаны свои директивы error_page.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	360 В URI можно использовать переменные.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	361 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	362
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	363 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	364 Пример использования:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	365 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	366 error_page 404 /404.html;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	367 error_page 502 503 504 /50x.html;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	368 error_page 403 http://example.com/forbidden.html;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	369 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	370 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	371
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	372 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	373 Кроме того, можно поменять код ответа на другой, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	374 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	375 error_page 404 =200 /empty.gif;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	376 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	377 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	378
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	379 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	380 Если ошибочный ответ обрабатывается проксированным сервером или
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	381 FastCGI-сервером и этот сервер может вернуть разные коды ответов,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	382 например, 200, 302, 401 или 404, то можно выдавать возвращаемый код:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	383 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	384 error_page 404 = /404.php;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	385 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	386 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	387
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	388 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	389 Если при перенаправлении не нужно менять URI, то можно перенаправить
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	390 обработку ошибки в именованный location:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	391 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	392 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	393 error_page 404 = @fallback;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	394 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	395
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	396 location @fallback {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	397 proxy_pass http://backend;
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 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	400 </para>
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	403
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	404
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	405 <directive name="if_modified_since">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	406 <syntax>if_modified_since <value>[off\|exact\|before]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	407 <default>if_modified_since exact</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	408 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	409
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	410 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	411 Директива (0.7.24) определяет, как сравнивать время модификации ответа и
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	412 время в заголовке запроса "If-Modified-Since":
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	413 <list type="bullet">
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	416 off — не проверять заголовок запроса
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	417 "If-Modified-Since" (0.7.34);
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	418 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	419
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	420 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	421 exact — точно совпадение;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	422 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	423
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	424 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	425 before — время модификации ответа меньше или равно времени, заданному
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	426 в заголовке запроса "If-Modified-Since".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	427 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	428
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	429 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	430 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	431
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	432 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	433
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	434
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	435 <directive name="internal">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	436 <syntax>internal</syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	437 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	438 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	439
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 Директива указывает, что данный location может использоваться только
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	442 для внутренних запросов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	443 Для внешних запросов будет возвращаться ошибка "Not found" (404).
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 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	446
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	447 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	448 запросы, перенаправленные директивой error_page;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	449 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	450
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	451 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	452 подзапросы, формируемые командой include virtual модуля ngx_http_ssi_module;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	453 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	454
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	455 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	456 запросы, изменённые директивой rewrite модуля ngx_http_rewrite_module.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	457 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	458
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	459 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	460 </para>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	463 Пример использования:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	464 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	465 error_page 404 /404.html;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	466
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	467 location /404.html {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	468 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	469 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	470 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	471 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	472
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	473 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	474
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	475
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	476 <directive name="keepalive_requests">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	477 <syntax>keepalive_requests <value>число</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	478 <default>keepalive_requests 100</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	479 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	480
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	481 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	482 Директива (0.8.0) задаёт максимальное число запросов, которые можно
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	483 сделать по одному keep-alive соединению.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	484 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	485
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	486 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	487
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	488
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	489 <directive name="keepalive_timeout">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	490 <syntax>keepalive_timeout <value>время [время]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	491 <default>keepalive_timeout 75</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	492 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	493
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	494 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	495 Директива задаёт таймаут, в течение которого keep-alive соединение
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	496 с клиентом не будет закрыто со стороны сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	497 Второй параметр задаёт значение в строке "Keep-Alive: timeout=время"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	498 в заголовке ответа. Параметры могут отличаться друг от друга.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	499 Строку "Keep-Alive: timeout=время" понимают Mozilla и Konqueror.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	500 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	501 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	502
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	503 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	504
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	505
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	506 <directive name="large_client_header_buffers">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	507 <syntax>large_client_header_buffers <value>число размер</value>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	508 </syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	509 <default>large_client_header_buffers 4 4k/8k</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	510 <context>http, server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	511
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	512 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	513 Директива задаёт максимальное число и размер буферов для чтения
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	514 большого заголовка запроса клиента.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	515 Строка запроса должна быть не больше размера одного буфера, иначе клиенту
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	516 возвращается ошибка "Request URI too large" (414).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	517 Длинная строка заголовка запроса также должна быть не больше размера одного
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	518 буфера, иначе клиенту возвращается ошибка "Bad request" (400).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	519 Буферы выделяются только по мере необходимости.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	520 По умолчанию размер одного буфера равен размеру страницы, в зависимости
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	521 от платформы это или 4K, или 8K.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	522 Если по окончании обработки запроса соединение переходит в состояние
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	523 keep-alive, то эти буферы освобождаются.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	524 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	525
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	526 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	527
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	528
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	529 <directive name="limit_except">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	530 <syntax>limit_except <value>методы</value> { ... }</syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	531 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	532 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	533
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	534 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	535 Директива ограничивает HTTP-методы, доступные внутри location.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	536 Метод GET также включает в себя метод HEAD.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	537 Для ограничения могут использоваться директивы модулей <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	538 и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	539 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	540 limit_except GET {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	541 allow 192.168.1.0/32;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	542 deny all;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	543 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	544 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	545 Обратите внимание, что данное ограничение будет выполняться для всех методов,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	546 <value>кроме</value> методов GET и HEAD.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	547 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	548
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	549 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	550
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	551
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	552 <directive name="limit_rate">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	553
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	554 <syntax>limit_rate <value>скорость</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	555 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	556 <context>http, server, location, if в location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	557
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	558 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	559 Директива задаёт скорость передачи ответа клиенту.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	560 Скорость задаётся в байтах в секунду.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	561
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	562 Ограничение работает только для одного соединения, то есть,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	563 если клиент откроет 2 соединения, то суммарная скорость будет в 2 раза
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	564 выше ограниченной.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	565 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	566
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	567 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	568 Если необходимо ограничить скорость для части клиентов на уровне сервера,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	569 то директива limit_rate для этого не подходит. Вместо этого следует
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	570 задать нужную скорость переменной $limit_rate:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	571 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	572 server {
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 if ($slow) {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	575 set $limit_rate 4k;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	576 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	577
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	578 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	579 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	580 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	581 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	582
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	583 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	584
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	585
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	586 <directive name="limit_rate_after">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	587 <syntax>limit_rate_after <value>размер</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	588 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	589 <context>http, server, location, if в location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	590
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	591 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	592 Директива (0.8.0) задаёт объём данных, после передачи которого
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	593 начинает ограничиваться скорость передачи ответа клиенту, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	594 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	595 location /flv/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	596 flv;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	597 limit_rate_after 500k;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	598 limit_rate 50k;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	599 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	600 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	601 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	602
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	603 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	604
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	605
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	606 <directive name="listen">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	607 <syntax>listen <value>адрес:порт
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	608 [default\|default_server\|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	609 [backlog=число \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	610 rcvbuf=размер \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	611 sndbuf=размер \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	612 accept_filter=фильтр \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	613 deferred \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	614 bind \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	615 ipv6only=[on\|off] \|
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	616 ssl]]
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	617 </value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	618 <default>listen :80 \| :8000</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	619 <context>server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	620
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	621 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	622 Директива задаёт адрес и порт, на которых сервер принимает запросы.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	623 Можно указать только адрес или только порт, кроме того, адрес может
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	624 быть именем сервера, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	625 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	626 listen 127.0.0.1:8000;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	627 listen 127.0.0.1;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	628 listen 8000;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	629 listen *:8000;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	630 listen localhost:8000;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	631 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	632 адреса IPv6 (0.7.36) задаются в квадратных скобках:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	633 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	634 listen [::]:8000;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	635 listen [fe80::1];
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	636 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	637 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	638
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	639 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	640 Если указан только адрес, то используется порт 80.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	641 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	642
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	643 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	644 Если директива не указана, то используется порт *:80, если nginx работает
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	645 с правами пользователя root, или порт *:8000.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	646 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	647
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	648 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	649 Если у директивы есть параметр default, то сервер, в котором описана
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	650 эта директива, будет сервером по умолчанию для указанной пары адрес:порт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	651 Если же директив с параметром default нет, то сервером по умолчанию
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	652 будет первый сервер, в котором описана пара адрес:порт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	653 Начиная с версии 0.8.21, можно использовать параметр default_server.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	654 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	655
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	656 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	657 В директиве listen с параметром default можно также указать несколько
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	658 параметров, специфичных для системных вызовов listen(2) и bind(2).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	659 Начиная с версии 0.8.21, эти параметры можно задать в любой директиве
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	660 listen, но только один раз для указанной пары адрес:порт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	661 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	662
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	663 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	664 backlog=число — задаёт параметр backlog в вызове listen(2).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	665 По умолчанию backlog равен -1 для FreeBSD и 511 для всех остальных
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	666 платформ.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	667 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	668
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	669 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	670 rcvbuf=размер — задаёт параметр SO_RCVBUF для слушающего сокета.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	671 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	672
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	673 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	674 sndbuf=размер — задаёт параметр SO_SNDBUF для слушающего сокета.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	675 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	676
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	677 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	678 accept_filter=фильтр — задаёт название accept-фильтра.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	679 Работает только на FreeBSD, можно использовать два фильтра — dataready
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	680 и httpready.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	681 По сигналу -HUP accept-фильтр можно менять только в последних
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	682 версиях FreeBSD, начиная с 6.0, 5.4-STABLE и 4.11-STABLE.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	683 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	684
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	685 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	686 deferred — указывает использовать отложенный accept(2) на Linux
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	687 с помощью опции TCP_DEFER_ACCEPT.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	688 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	689
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	690 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	691 bind — указывает, что для данной пары адрес:порт нужно делать bind(2)
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	692 отдельно.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	693 Дело в том, что если описаны несколько директив listen с одинаковым портом,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	694 но разными адресами и одна из директив listen слушает на всех адресах
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	695 для данного порта (:порт), то nginx сделает bind(2) только на :порт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	696 Необходимо учитывать, что в этом случае для определения адреса, на которой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	697 пришло соединение, делается системный вызов getsockname().
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	698 Если же используются параметры backlog, rcvbuf, sndbuf, accept_filter
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	699 или deferred, то для данной пары адрес:порт bind(2) всегда делается отдельно.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	700 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	701
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	702 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	703 ipv6only — параметр (0.7.42) задаёт значение параметра IPV6_V6ONLY
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 Установить этот параметр можно только один раз на старте.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	706 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	707
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	708 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	709 ssl — параметр (0.7.14) не имеет отношения к системным вызовам
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	710 listen(2) и bind(2), а позволяет указать, что все соединения,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	711 принимаемые на этом порту, должны работать в режиме SSL.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	712 Это позволяет задать компактную конфигурацию для сервера,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	713 работающего сразу в двух режимах — HTTP и HTTPS.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	714 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	715 listen 80;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	716 listen 443 default ssl;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	717 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	718 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	719
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	720 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	721 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	722
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	723 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	724 Пример использования параметров:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	725 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	726 listen 127.0.0.1 default accept_filter=dataready backlog=1024;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	727 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	728 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	729
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	730 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	731
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	732
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	733 <directive name="location">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	734 <syntax>location [<value>=\|~\|~*\|^~\|@</value>] <value>/uri/</value>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	735 { ... }</syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	736 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	737 <context>server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	738
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	739 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	740 Директива устанавливает конфигурацию в зависимости от URI запроса.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	741 location можно задать обычной строкой или регулярным выражением.
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 символов, и "~" — с учётом.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	744 Для определения соответствия location'а и запроса
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	745 сначала проверяются location'ы, заданные обычными строками.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	746 Среди них ищется максимальное совпадение.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	747 Затем проверяются регулярные выражения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	748 В отличие от обычных строк, они не сортируются, а проверяются в порядке
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	749 их следования в конфигурационном файле.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	750 Проверка регулярных выражений прекращается после первого же совпадения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	751 Если совпадение с регулярным выражением не найдено, то используется
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	752 конфигурация максимально совпавшего location'а.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	753 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	754
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	755 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	756 Для операционных систем, не чувствительных к регистру символов, таких
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	757 как Mac OS X и Cygwin, проверка обычных строк делается без учёта
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	758 регистра (0.7.7).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	759 Однако, сравнение ограничено только однобайтными locale'ями.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	760 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	761
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	762 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	763 Регулярное выражение может содержать выделения (0.7.40), которые
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 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	766
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	767 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	768 Если нужно запретить проверку регулярных выражений после проверки
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 Если у максимально совпавшего location'а есть этот префикс, то
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	771 регулярные выражения не проверяются.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	772 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	773
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	774 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	775 Кроме того, с помощью префикса "=" можно задать точное совпадение
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	776 URI и location. При совпадении поиск сразу же прекращается, так как
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	777 дальше искать не имеет смысла. Например, если запрос "/" очень частый,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	778 то указав "location = /", можно ускорить обработку этого запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	779 так как поиск location прекратится после первого же сравнения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	780 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	781
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	782 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	783 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с обычным location'ом
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	784 без префиксов "=" и "^~", то поиск тоже сразу же прекращается и
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	785 регулярные выражения также не проверяются.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	786 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	787
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	788 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	789 Проиллюстрируем вышесказанное примером:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	790 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	791 location = / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	792 [ конфигурация A ]
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	793 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	794
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	795 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	796 [ конфигурация B ]
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	797 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	798
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	799 location ^~ /images/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	800 [ конфигурация C ]
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	801 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	802
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	803 location ~* \.(gif\|jpg\|jpeg)$ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	804 [ конфигурация D ]
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	805 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	806 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	807 Для запроса "/" будет выбрана конфигурация A,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	808 для запроса "/documents/document.html" — конфигурация B,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	809 для запроса "/images/1.gif" — конфигурация C,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	810 для запроса "/documents/1.jpg" — конфигурация D.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	811 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	812
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	813 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	814 Префикс "@" задаёт именованный location. Такой location не используется
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	815 при обычной обработке запросов, а предназначен только для перенаправления
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	816 в него запросов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	817 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	818
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	819 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	820
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	821
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	822 <directive name="log_not_found">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	823 <syntax>log_not_found <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	824 <default>log_not_found on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	825 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	826
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	827 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	828 Директива разрешает или запрещает записывать в error_log
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	829 ошибки о том, что файл не найден.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	830 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	831
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	832 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	833
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	834
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	835 <directive name="log_subrequest">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	836 <syntax>log_subrequest <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	837 <default>log_subrequest off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	838 <context>http, server, location</context>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	841 Директива разрешает или запрещает записывать в <link doc="ngx_http_log_module.xml#access_log">access_log</link>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	842 подзапросы.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	843 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	844
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	845 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	846
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	847
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	848 <directive name="merge_slashes">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	849 <syntax>merge_slashes <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	850 <default>merge_slashes on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	851 <context>http, server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	852
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	853 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	854 Директива разрешает или запрещает объединять в URI два и более слэшей в один.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	855 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	856
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	857 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	858 Необходимо иметь ввиду, что это объединение необходимо для корректной
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	859 проверки location'ов и регулярных выражений.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	860 Например, запрос "//scripts/one.php" не попадает в
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	861 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	862 location /scripts/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	863 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	864 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	865 </example>
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 поэтому он приводится в "/scripts/one.php".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	868 </para>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	871 Выключение объединения может понадобиться, если в URI используются имена,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	872 закодированные методом base64, который использует символ "/".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	873 Но по соображениям безопасности лучше избегать выключения объединения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	874 </para>
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	877 Если директива указана на уровне server в сервере по умолчанию,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	878 то её значение распространяется на все виртуальные сервера, слушающие
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	879 на том же адресе и порту.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	880 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	881
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	882 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	883
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	884
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	885 <directive name="msie_padding">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	886 <syntax>msie_padding <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	887 <default>msie_padding on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	888 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	889
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	890 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	891 Директива разрешает или запрещает добавлять в ответы для MSIE
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	892 со статусом больше 400
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	893 комментарий для увеличения размера ответа до 512 байт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	894 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	895
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	896 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	897
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 <directive name="msie_refresh">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	900 <syntax>msie_refresh <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	901 <default>msie_refresh off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	902 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	903
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	904 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	905 Директива разрешает или запрещает выдавать для MSIE refresh'ы вместо
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	906 редиректов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	907 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	908
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	909 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	910
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	911
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	912 <directive name="open_file_cache">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	913 <syntax>open_file_cache <value>max=N [inactive=время]\|off</value>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	914 </syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	915 <default>open_file_cache off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	916 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	917
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	918 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	919 Директива задаёт кэш, в котором могут хранится
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	920 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	921
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	922 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	923 дескрипторы открытых файлов, информация об их размерах и времени модификации;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	924 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	925
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	926 <listitem>
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 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	929
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	930 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	931 информация об ошибках поиска файла — нет файла, нет прав на чтение
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 <link id="open_file_cache_errors"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	934 </listitem>
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 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	937 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	938
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	939 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	940 Параметры директивы:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	941 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	942
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	943 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	944 max — задаёт максимальное число элементов в кэше;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	945 при переполнении кэша удаляются наиболее давно не используемые элементы (LRU);
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	946 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	947
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	948 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	949 inactive — задаёт время, после которого элемент кэша удаляется,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	950 если к нему не было обращений в течение этого времени;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	951 по умолчанию 60 секунд;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	952 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	953
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	954 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	955 off — запрещает кэш.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	956 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	957
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	958 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	959 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	960
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	961 <para>
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 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	964 open_file_cache max=1000 inactive=20s;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	965 open_file_cache_valid 30s;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	966 open_file_cache_min_uses 2;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	967 open_file_cache_errors on;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	968 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	969 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	970
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	971 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	972
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	973
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	974 <directive name="open_file_cache_errors">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	975 <syntax>open_file_cache_errors <value>on\|off</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	976 <default>open_file_cache_errors off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	977 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	978
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	979 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	980 Директива определяет, кэшировать или нет ошибки поиска файлов в
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	981 <link id="open_file_cache"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	982 </para>
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>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	985
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	986
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	987 <directive name="open_file_cache_min_uses">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	988 <syntax>open_file_cache_min_uses <value>число</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	989 <default>open_file_cache_min_uses 1</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	990 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	991
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	992 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	993 Директива определяет минимальное число использований файла в течение
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	994 времени, заданного параметром inactive в директиве
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	995 <link id="open_file_cache"/>, после которого дескриптор файла
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	996 будет оставаться открытым в кэше.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	997 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	998
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	999 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1000
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1001
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1002 <directive name="open_file_cache_valid">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1003 <syntax>open_file_cache_valid <value>время</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1004 <default>open_file_cache_valid 60</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1005 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1006
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1007 <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 информации об элементе в <link id="open_file_cache"/>.
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 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1012
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1013 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1014
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1015
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1016 <directive name="optimize_server_names">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1017 <syntax>optimize_server_names <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1018 <default>optimize_server_names on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1019 <context>http, server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1020
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1021 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1022 Устаревшая директива.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1023 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1024
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1025 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1026 Директива разрешает или запрещает оптимизировать проверку имени хоста
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1027 в name-based виртуальных серверах.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1028 Проверка в частности влияет на имя хоста, используемого в редиректах.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1029 Если оптимизация разрешена и все name-based сервера, слушающие на одной
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1030 паре адрес:порт, имеют одинаковую конфигурацию, то во время исполнения
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1031 запроса имена не проверяются и в редиректах используется первое имя сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1032 Если в редиректе нужно использовать имя хоста, переданное клиентом,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1033 то оптимизацию нужно выключить.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1034 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1035
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1036 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1037
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1038
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1039 <directive name="port_in_redirect">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1040 <syntax>port_in_redirect <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1041 <default>port_in_redirect on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1042 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1043
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1044 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1045 Директива разрешает или запрещает указывать порт в редиректах,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1046 выдаваемых nginx'ом.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1047 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1048
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1049 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1050
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1051
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1052 <directive name="read_ahead">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1053 <syntax>read_ahead <value>размер</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1054 <default>read_ahead 0</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1055 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1056
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1057 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1058 Директива задаёт ядру размер предчтения при работе с файлами.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1059 Под Линуксом используется системный вызов
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1060 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1061 posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL);
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1062 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1063 поэтому размер игнорируется.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1064 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1065
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1066 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1067 Под FreeBSD используется fcntl(O_READAHEAD, размер), появившийся
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1068 во FreeBSD-9 CURRENT. Для FreeBSD 7 нужно установить
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1069 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1070 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1071
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1072 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1073
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1074
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1075 <directive name="recursive_error_pages">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1076 <syntax>recursive_error_pages <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1077 <default>recursive_error_pages off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1078 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1079
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1080 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1081 Директива разрешает или запрещает делать несколько перенаправлений через
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1082 директиву <link id="error_page"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1083 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1084
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1085 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1086
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1087
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1088 <directive name="reset_timedout_connection">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1089 <syntax>reset_timedout_connection <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1090 <default>reset_timedout_connection off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1091 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1092
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1093 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1094 Директива разрешает или запрещает сбрасывать соединение по таймауту.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1095 Сброс делается следующим образом — перед закрытием сокета для него
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1096 ставится опция SO_LINGER с таймаутом 0. После чего при закрытии сокета
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1097 клиенту отсылается пакет RST, а всё память, связанная с этим сокетом,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1098 освобождается. Это позволяет избежать длительного нахождения уже закрытого
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1099 сокета в состоянии FIN_WAIT1 с заполненными буферами.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1100 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1101
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1102 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1103 Необходимо отметить, что соединения, находящиеся в состоянии keepalive,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1104 по истечении таймаута закрываются обычным образом.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1105 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1106
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1107 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1108
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1109
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1110 <directive name="resolver">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1111 <syntax>resolver <value>адрес</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1112 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1113 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1114
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1115 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1116 Директива задаёт адрес name-сервера, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1117 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1118 resolver 127.0.0.1;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1119 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1120 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1121
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1122 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1123
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1124
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1125 <directive name="resolver_timeout">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1126 <syntax>resolver_timeout <value>время</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1127 <default>resolver_timeout 30s</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1128 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1129
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1130 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1131 Директива задаёт таймаут для определения имени, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1132 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1133 resolver_timeout 5s;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1134 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1135 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1136
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1137 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1138
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1139
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1140 <directive name="root">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1141 <syntax>root <value>путь</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1142 <default>root html</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1143 <context>http, server, location, if в location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1144
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1145 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1146 Директива задаёт корневой каталог для запросов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1147 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1148 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1149 location /i/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1150 root /data/w3;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1151 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1152 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1153 на запрос "/i/top.gif" будет отдан файл "/data/w3/i/top.gif".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1154 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1155
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1156 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1157 В значении пути можно использовать переменные.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1158 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1159
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1160 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1161 Путь к файлу формируется как простое добавление URI к значению директивы root.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1162 Если же необходима модификация URI, то нужно воспользоваться директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1163 <link id="alias"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1164 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1165
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1166 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1167
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 <directive name="satisfy">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1170 <syntax>satisfy <value>all\|any</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1171 <default>satisfy all</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1172 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1173
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1174 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1175 Директива разрешает доступ при хотя бы одной успешной проверке,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1176 выполненной модулями <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1177 или <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1178 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1179 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1180 satisfy any;
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 allow 192.168.1.0/32;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1183 deny all;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1184
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1185 auth_basic "closed site";
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1186 auth_basic_user_file conf/htpasswd;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1187 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1188 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1189 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1190
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1191 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1192
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1193
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1194 <directive name="satisfy_any">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1195 <syntax>satisfy_any <value>on\|off</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1196 <default>satisfy_any off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1197 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1198
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1199 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1200 Директива переименована в директиву <link id="satisfy"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1201 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1202
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1203 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1204
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1205
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1206 <directive name="send_timeout">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1207 <syntax>send_timeout <value>время</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1208 <default>send_timeout 60</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1209 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1210
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1211 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1212 Директива задаёт таймаут при передаче ответа клиенту.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1213 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1214 а только между двумя операциями записями.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1215 Если по истечении этого времени клиент ничего не примет,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1216 то nginx закрывает соединение.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1217 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1218
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1219 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1220
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1221
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1222 <directive name="sendfile">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1223 <syntax>sendfile <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1224 <default>sendfile off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1225 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1226
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1227 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1228 Директива разрешает или запрещает использовать sendfile().
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1229 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1230
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1231 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1232
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1233
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1234 <directive name="server">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1235 <syntax>server { ... }</syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1236 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1237 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1238
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1239 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1240 Директива задаёт конфигурацию для виртуального сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1241 Чёткого разделения виртуальных серверов ip-based (на основании ip-адреса)
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1242 и name-based (на основании имени, передаваемого в строке "Host"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1243 заголовка запроса), нет.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1244 Вместо этого директивами <link id="listen"/> описываются все адреса
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1245 и порты, на которых нужно принимать соединения для этого сервера,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1246 и в директиве <link id="server_name"/> указываются все имена серверов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1247 Пример конфигурации описан в <link doc="../virtual_hosts.xml">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1248 настройке виртуальных серверов</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1249 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1250
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1251 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1252
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1253
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1254 <directive name="server_name">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1255 <syntax>server_name <value>имя [...]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1256 <default>server_name hostname</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1257 <context>server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1258
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1259 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1260 Директива задаёт имена виртуального сервера, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1261 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1262 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1263 server_name example.com www.example.com;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1264 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1265 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1266 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1267
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1268 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1269 Первое имя становится основным именем сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1270 По умолчанию используется имя машины (hostname).
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1271 В именах серверов можно использовать "*" для замены первой или последней
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1272 части имени:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1273 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1274 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1275 server_name example.com .example.com www.example.;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1276 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1277 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1278 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1279
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1280 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1281 Два первых вышеприведённых имени можно объединить в одно:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1282 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1283 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1284 server_name .example.com;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1285 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1286 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1287 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1288
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1289 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1290 Кроме того, в качестве имени сервера можно использовать регулярное
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1291 выражение, указав перед ним "~":
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1292 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1293 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1294 server_name www.example.com ~^www\d+\.example\.com$;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1295 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1296 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1297 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1298
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1299 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1300 Регулярное выражение может содержать выделения (0.7.40), которые
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1301 могут затем использоваться в других директивах:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1302 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1303 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1304 server_name ~^(www\.)?(.+)$;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1305
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1306 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1307 root /sites/$2;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1308 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1309 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1310
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1311 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1312 server_name _;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1313
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1314 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1315 root /sites/default;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1316 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1317 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1318 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1319 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1320
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1321 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1322 Начиная с 0.8.25, именованные выделения в регулярном выражении создают
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1323 переменные, которые могут затем использоваться в других директивах:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1324 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1325 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1326 server_name ~^(www\.)?(<emphasis>?<domain></emphasis>.+)$;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1327
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1328 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1329 root /sites/<emphasis>$domain</emphasis>;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1330 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1331 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1332
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1333 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1334 server_name _;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1335
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1336 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1337 root /sites/default;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1338 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1339 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1340 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1341 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1342
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1343 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1344 Начиная с 0.7.11, можно использовать пустое имя "":
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1345 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1346 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1347 server_name www.example.com "";
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1348 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1349 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1350 что позволяет обрабатывать запросы без строки "Host" в заголовке запроса
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1351 в этом сервере, а не в сервере по умолчанию для данной пары адрес:порт.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1352 </para>
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 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1355 Порядок проверки имён следующий:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1356 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1357
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1358 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1359 полные имена,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1360 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1361
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1362 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1363 имена с маской в начале имени — *.example.com,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1364 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1367 имена с маской в конце имени — mail.*,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1368 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1369
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1370 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1371 регулярные выражения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1372 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1373
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1374 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1375 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1376
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1377 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1378
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1379
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1380 <directive name="server_name_in_redirect">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1381 <syntax>server_name_in_redirect <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1382 <default>server_name_in_redirect on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1383 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1384
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1385 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1386 Директива разрешает или запрещает использовать в редиректах, выдаваемых
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1387 nginx'ом, основное имя сервера, задаваемое директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1388 <link id="server_name"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1389 Если использование основного имени запрещено, то используется имя,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1390 указанного в строке "Host" в заголовке запроса.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1391 Если же этой строки нет, то используется IP-адрес сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1392 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1393
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1394 </directive>
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1397 <directive name="server_names_hash_max_size">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1398 <syntax>server_names_hash_max_size <value>число</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1399 <default>server_names_hash_max_size 512</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1400 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1401
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1402 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1403 Директива задаёт максимальный размер хэш-таблиц имён серверов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1404 Подробнее смотри в <link doc="../hash.xml">описании
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1405 настройки хэшей</link>.
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 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1409
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1410
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1411 <directive name="server_names_hash_bucket_size">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1412 <syntax>server_names_hash_bucket_size <value>число</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1413 <default>server_names_hash_bucket_size 32/64/128</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1414 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1415
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 Значение по умолчанию зависит от размера строки кэша процессора.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1419 Подробнее смотри в <link doc="../hash.xml">описании
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1420 настройки хэшей</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1421 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1422
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1423 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1424
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1425
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1426 <directive name="server_tokens">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1427 <syntax>server_tokens <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1428 <default>server_tokens on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1429 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1430
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1431 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1432 Директива разрешает или запрещает выдавать версию nginx'а
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1433 в сообщениях об ошибках и в строке заголовка ответа "Server".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1434 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1435
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1436 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1437
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 <directive name="tcp_nodelay">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1440 <syntax>tcp_nodelay <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1441 <default>tcp_nodelay on</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1442 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1443
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1444 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1445 Директива разрешает или запрещает использовать опцию TCP_NODELAY.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1446 Опция включаются только при переходе соединения в состояние keep-alive.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1447 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1448
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1449 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1450
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1451
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1452 <directive name="tcp_nopush">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1453 <syntax>tcp_nopush <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1454 <default>tcp_nopush off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1455 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1456
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1457 <para>
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 TCP_NOPUSH во FreeBSD или TCP_CORK в Linux.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1460 Опции включаются только при использовании <link id="sendfile"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1461 Включение опции позволяет
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1462 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1463
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1464 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1465 передавать заголовок ответа и начало файла в одном пакете в Linux
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1466 и во FreeBSD 4.x;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1467 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1468
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1469 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1470 передавать файл в полных пакетах.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1471 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1472
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1473 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1474 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1475
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1476 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1477
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1478
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1479 <directive name="try_files">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1480 <syntax>try_files <value>файл [файл ...] (uri\|=код)</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1481 <default>нет</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1482 <context>location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1483
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1484 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1485 Директива проверяет существование файлов в заданном порядке
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1486 и использует для обработки запроса первый найденный файл, причём
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1487 обработка делается в контексте этого же location'а.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1488 С помощью слэша в конце имени можно задать проверку существования
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1489 каталога, например, так — "$uri/".
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1490 В случае, если ни один файл не найден, то делается внутренний редирект
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1491 на последний параметр.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1492 Последний параметр может быть кодом (0.7.51):
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1493 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1494 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1495 try_files $uri $uri/index.html $uri.html =404;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1496 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1497 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1498 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1499
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1500 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1501 Пример использования при проксировании Mongrel:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1502 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1503 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1504 try_files /system/maintenance.html
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1505 $uri $uri/index.html $uri.html
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1506 @mongrel;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1507 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1508
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1509 location @mongrel {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1510 proxy_pass http://mongrel;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1511 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1512 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1513 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1514
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1515 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1516 Пример использования вместе с Drupal/FastCGI:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1517 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1518 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1519 try_files $uri $uri/ @drupal;
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 location ~ \.php$ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1523 try_files $uri @drupal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1524
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1525 fastcgi_pass ...;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1526
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1527 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1528 fastcgi_param SCRIPT_NAME $fastcgi_script_name;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1529 fastcgi_param QUERY_STRING $args;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1530
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1531 ... прочие fastcgi_param
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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1534 location @drupal {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1535 fastcgi_pass ...;
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 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1538 fastcgi_param SCRIPT_NAME /index.php;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1539 fastcgi_param QUERY_STRING q=$uri&$args;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1540
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1541 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1542 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1543 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1544 В этом примере директива try_files
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1545 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1546 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1547 try_files $uri $uri/ @drupal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1548 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1549 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1550 аналогична директивам
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1551 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1552 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1553 error_page 404 = @drupal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1554 log_not_found off;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1555 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1556 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1557 А здесь
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1558 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1559 location ~ \.php$ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1560 try_files $uri @drupal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1561
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1562 fastcgi_pass ...;
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 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1565
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1566 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1567 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1568 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1569 try_files тестирует существование PHP-файла,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1570 прежде чем передать запрос FastCGI-серверу.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1571 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1572
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1573 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1574 Пример использования вместе с Wordpress и Joomla:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1575 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1576 location / {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1577 try_files $uri $uri/ @wordpress;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1578 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1579
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1580 location ~ \.php$ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1581 try_files $uri @wordpress;
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 fastcgi_pass ...;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1584
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1585 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1586 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1587 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1588
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1589 location @wordpress {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1590 fastcgi_pass ...;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1591
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1592 fastcgi_param SCRIPT_FILENAME /path/to/index.php;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1593 ... прочие fastcgi_param
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1594 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1595 </example>
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="types">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1602 <syntax>types <value>{ ... }</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1603 <default>see below</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1604 <context>http, server, location</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1605
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1606 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1607 Директива задаёт соответствие расширения и MIME-типов ответов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1608 Одному MIME-типу может соответствовать несколько расширений.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1609 По умолчанию используется такие соответствия:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1610 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1611 types {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1612 text/html html;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1613 image/gif gif;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1614 image/jpeg jpg;
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 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1617 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1618
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1619 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1620 Достаточно полная таблица соответствий входит в дистрибутив
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1621 и находится в файле conf/mime.types.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1622 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1623
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1624 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1625 Для того, чтобы для определённого location'а для всех ответов выдавался
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1626 MIME-тип "application/octet-stream", можно использовать следующее:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1627 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1628 location /download/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1629 types { }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1630 default_type application/octet-stream;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1631 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1632 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1633 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1634
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1635 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1636
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1637
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1638 <directive name="underscores_in_headers">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1639 <syntax>underscores_in_headers <value>[on\|off]</value></syntax>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1640 <default>underscores_in_headers off</default>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1641 <context>http, server</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1642
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1643 <para>
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 в строках заголовка запроса клиента.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1646 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1647
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1648 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1649
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1650 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1651
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1652
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1653 <section name="Встроенные переменные" id="variables">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1654
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1655 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1656 Модуль ngx_http_core_module поддерживает встроенные переменные, имена
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1657 которых совпадают с именами переменных в Apache.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1658 Прежде всего, это переменные, представляющие из себя строки заголовка
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1659 запроса клиента, например, $http_user_agent, $http_cookie
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1660 и тому подобное. Кроме того, есть и другие переменные:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1661 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1662
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1663 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1664 $args, эта переменная равна аргументам в строке запроса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1665 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1666
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1667 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1668 $arg_<value>name</value>, эта переменная равна аргументу <value>name</value>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1669 в строке запроса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1670 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1671
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1672 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1673 $binary_remote_addr, эта переменная равна адресу клиента в бинарном виде,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1674 длина её значения всегда 4 байта;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1675 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1676
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1677 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1678 $content_length, эта переменная равна строке "Content-Length" в заголовке
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1679 запроса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1680 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1681
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1682 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1683 $content_type, эта переменная равна строке "Content-Type" в заголовке запроса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1684 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1685
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1686 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1687 $cookie_<value>name</value>, эта переменная равна cookie <value>name</value>;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1688 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1689
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1690 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1691 $document_root, эта переменная равна значению директивы root для
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1692 текущего запроса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1693 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1696 $document_uri, то же самое, что и $uri;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1697 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1698
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1699 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1700 $host, эта переменная равна строке "Host" в заголовке запроса
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1701 или имени сервера, на который пришёл запрос, если этой строки нет;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1702 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1703
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1704 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1705 $hostname, эта переменная равна имени хоста;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1706 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1709 $http_<value>name</value>, эта переменная равна строке <value>name</value>
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 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1712
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1713 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1714 $is_args, эта переменная равна "?", если в строке запроса есть аргументы,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1715 и пустой строке, если их нет;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1716 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1719 $limit_rate, эта переменная позволяет установить ограничение
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1720 скорости соединения;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1721 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1724 $pid, эта переменная равна номеру рабочего процесса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1725 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1726
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1727 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1728 $request_method, эта переменная равна методу запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1729 обычно это "GET" или "POST";
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1730 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1731
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1732 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1733 $remote_addr, эта переменная равна адресу клиента;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1734 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1735
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1736 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1737 $remote_port, эта переменная равна порту клиента;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1738 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1739
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1740 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1741 $remote_user, эта переменная равна имени пользователя, используемого
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1742 в Basic аутентификации;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1743 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1744
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1745 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1746 $realpath_root, эта переменная равна значению директивы root для
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1747 текущего запроса, при этом все символические ссылки преобразованы
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1748 в реальные путь;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1749 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1750
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1751 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1752 $request_filename, эта переменная равна пути к файлу для текущего
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1753 запроса, формируемому из директив root или alias и URI запроса;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1754 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1755
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1756 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1757 $request_body, эта переменная содержит тело запроса.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1758 Значение переменной появляется в location'ах, обрабатываемых директивами
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1759 <link doc="ngx_http_proxy_module.xml#proxy_pass">proxy_pass</link>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1760 и <link doc="ngx_http_fastcgi_module.xml#fastcgi_pass">fastcgi_pass</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1761 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1762
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1763 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1764 $request_body_file, эта переменная равна имени временного файла, в котором
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1765 хранится тело запроса.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1766 По завершению работы файл необходимо удалить.
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 указать <link doc="ngx_http_core_module.xml#client_body_in_file_only">client_body_in_file_only on</link>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1769 При передаче имени в проксированном запросе или в запросе к FastCGI-серверу
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1770 следует запретить передачу самого тела директивами
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1771 "proxy_pass_request_body off" или
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1772 "fastcgi_pass_request_body off" соответственно.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1773 </listitem>
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 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1776 $request_uri, эта переменная равна полному первоначальному URI вместе
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1777 с аргументами;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1778 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1779
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1780 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1781 $query_string, то же самое, что и $args;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1782 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1783
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1784 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1785 $scheme, эта переменная равна схеме запроса — "http" или "https";
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1786 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1787
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1788 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1789 $server_protocol, эта переменная равна протоколу запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1790 обычно это "HTTP/1.0" или "HTTP/1.1";
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1791 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1792
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1793 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1794 $server_addr, эта переменная равна адресу сервера, на который пришёл запрос.
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 вызов. Для того, чтобы избежать системного вызова, нужно указывать
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1797 адреса в директивах listen и использовать параметр bind;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1798 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1799
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1800 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1801 $server_name, эта переменная равна имени сервера, на который пришёл запрос;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1802 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1803
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1804 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1805 $server_port, эта переменная равна порту сервера, на который пришёл запрос;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1806 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1807
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1808 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1809 $uri, эта переменная равна текущему URI в запросе, он
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 или при использовании индексных файлов.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1812 </listitem>
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 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1815 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1816
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1817 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1818
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1819 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_core_module.xml @ 76:4a4caa566120