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

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 958:fd1f8e0a405e

Text review of ngx_http_core_module.

author	Egor Nikitin <yegor.nikitin@gmail.com>
date	Tue, 06 Aug 2013 17:03:33 +0400
parents	2b0731e3adc9
children	95c3c3bbf1ce

comparison

equal deleted inserted replaced

-:6d9d4bb571a9
+:fd1f8e0a405e
 tcp_nopush     on;
 aio            sendfile;
 }
 </example>
 В такой конфигурации функция <c-func>sendfile</c-func> вызывается с флагом
-<c-def>SF_NODISKIO</c-def>, в результате она не блокируется на диске, а
+<c-def>SF_NODISKIO</c-def>, в результате чего она не блокируется на диске, а
-сообщает об отсутствии данных в памяти, после чего nginx инициирует
+сообщает об отсутствии данных в памяти.
-асинхронную подгрузку данных, читая только один байт.
+После этого nginx инициирует асинхронную подгрузку данных, читая один байт.
 При этом ядро FreeBSD подгружает в память первые 128K байт файла, однако
 при последующих чтениях файл подгружается частями только по 16K.
 Изменить это можно с помощью директивы
 <link id="read_ahead"/>.
 </para>
 <para>
-В Linux AIO можно использовать только начиная с версии ядра 2.6.22, и,
+В Linux AIO можно использовать только начиная с версии ядра 2.6.22.
-кроме того, ещё необходимо дополнительно включать
+Кроме того, необходимо также дополнительно включить
 <link id="directio"/>,
 иначе чтение будет блокирующимся:
 <example>
 location /video/ {
 aio            on;
 }
 </example>
 </para>
 <para>
-Поскольку
+В Linux
 <link id="directio"/>
-в Linux можно использовать только для чтения блоков, выравненных
+можно использовать только для чтения блоков, выравненных
-на границу 512 байт (или 4К для XFS), то невыравненный конец файла
+на границу 512 байт (или 4К для XFS).
-будет читаться блокированно.
+Невыравненный конец файла будет читаться блокированно.
 То же относится к запросам с указанием диапазона запрашиваемых байт
 (byte-range requests) и к запросам FLV не с начала файла: чтение
 невыравненных начала и конца ответа будет блокирующимся.
 Явно выключать
 <link id="sendfile"/>
 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
 Например, при такой конфигурации
 <example>
 client_body_temp_path /spool/nginx/client_temp 1 2;
 </example>
-временный файл будет следующего вида:
+путь к временному файлу будет следующего вида:
 <example>
 /spool/nginx/client_temp/7/45/00000123457
 </example>
 </para>
 <default>256</default>
 <context>http</context>
 <context>server</context>
 <para>
-Позволяет производить точную настройку выделений памяти
+Позволяет производить точную настройку выделения памяти
 под конкретные соединения.
 Эта директива не оказывает существенного влияния на
-производительность и её не следует использовать.
+производительность, и её не следует использовать.
 </para>
 </directive>
 <para>
 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
 требуют дополнительных затрат на обработку.
 <note>
 На системах, не поддерживающих операцию открытия каталогов только для поиска,
-использование этих параметров требует, чтобы рабочие процессы
+для использования этих параметров требуется, чтобы рабочие процессы
 имели право читать все проверяемые каталоги.
 </note>
 </para>
 <para>
 <context>if в location</context>
 <para>
 Задаёт URI, который будет показываться для указанных ошибок.
 Директивы <literal>error_page</literal> наследуются с предыдущего уровня
-при условии, что на данном уровне не описаны свои директивы
+при условии, что на данном уровне не заданы свои директивы
 <literal>error_page</literal>.
 В значении <literal>uri</literal> можно использовать переменные.
 </para>
 <para>
 <appeared-in>0.8.0</appeared-in>
 <para>
 Задаёт максимальное число запросов, которые можно
 сделать по одному keep-alive соединению.
-После того, как будет сделано максимальное число запросов,
+После того, как сделано максимальное число запросов,
 соединение закрывается.
 </para>
 </directive>
 Скорость задаётся в байтах в секунду.
 Значение 0 отключает ограничение скорости.
 <!--
 Чем меньше скорость, тем более аккуратным будет ограничение.
 -->
-Ограничение устанавливается на запрос, поэтому если клиент одновременно
+Ограничение устанавливается на запрос, поэтому, если клиент одновременно
 откроет два соединения, суммарная скорость будет вдвое выше
 заданного ограничения.
 </para>
 <para>
 </para>
 <para>
 Со значением “<literal>off</literal>” nginx не будет ждать поступления
 дополнительных данных и сразу же закроет соединение.
-Это нарушает протокол, поэтому не следует это использовать без нужды.
+Это поведение нарушает протокол и поэтому не должно использоваться без
+необходимости.
 </para>
 </directive>
 <para>
 Если действует <link id="lingering_close"/>, эта директива задаёт
 максимальное время ожидания поступления дополнительных данных от клиента.
 Если в течение этого времени данные не были получены, соединение закрывается.
-Иначе данные читаются и игнорируются, затем nginx снова ждёт поступления данных.
+В противном случае данные читаются и игнорируются, и nginx снова
+ждёт поступления данных.
 Цикл “ждать-читать-игнорировать” повторяется, но не дольше чем задано
 директивой <link id="lingering_time"/>.
 </para>
 </directive>
 <para>
 Задаёт <value>адрес</value> и <value>порт</value> для IP
 или <value>путь</value> для UNIX-сокета,
 на которых сервер будет принимать запросы.
-Можно указать только <value>адрес</value>
+Можно указать <value>адрес</value> и <value>порт</value>,
-или только <value>порт</value>.
+либо только <value>адрес</value> или только <value>порт</value>.
 Кроме того, <value>адрес</value> может быть именем хоста, например:
 <example>
 listen 127.0.0.1:8000;
 listen 127.0.0.1;
 listen 8000;
 <para>
 Если указан только <value>адрес</value>, то используется порт 80.
 </para>
 <para>
-Если директива не указана, то используется либо <literal>*:80</literal>
+Если директива не указана, то используется либо <literal>*:80</literal>,
-(если nginx работает с привилегиями суперпользователя),
+если nginx работает с привилегиями суперпользователя,
 либо <literal>*:8000</literal>.
 </para>
 <para>
 Если у директивы есть параметр <literal>default_server</literal>, то сервер,
 <literal>default</literal>.
 </note>
 </para>
 <para>
-Параметр <literal>ssl</literal>(0.7.14) позволяет указать, что все соединения,
+Параметр <literal>ssl</literal> (0.7.14) указывает на то, что все соединения,
-принимаемые на этом порту, должны работать в режиме SSL.
+принимаемые на данном порту, должны работать в режиме SSL.
 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
 id="single_http_https_server">конфигурацию</link> для сервера,
 работающего сразу в двух режимах — HTTP и HTTPS.
 </para>
 задаёт название accept-фильтра
 (параметр <c-def>SO_ACCEPTFILTER</c-def>) для слушающего сокета,
 который включается для фильтрации входящих соединений
 перед передачей их в <c-func>accept</c-func>.
 Работает только на FreeBSD и NetBSD 5.0+.
-Можно использовать два фильтра —
+Можно использовать два фильтра:
 <link url="http://man.freebsd.org/accf_data">dataready</link>
 и
 <link url="http://man.freebsd.org/accf_http">httpready</link>.
 </tag-desc>
 </tag-name>
 <tag-desc>
 указывает, что для данной пары
 <value>адрес</value>:<value>порт</value> нужно делать
 <c-func>bind</c-func> отдельно.
-Дело в том, что если описаны несколько директив <literal>listen</literal>
+Это нужно потому, что если описаны несколько директив <literal>listen</literal>
 с одинаковым портом, но разными адресами, и одна из директив
 <literal>listen</literal> слушает на всех адресах для данного порта
 (<literal>*:</literal><value>порт</value>), то nginx сделает
 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
 Необходимо заметить, что в этом случае для определения адреса, на которой
 <para>
 Для сопоставления используется URI запроса в нормализованном виде,
 после декодирования текста, заданного в виде “<literal>%XX</literal>”,
 преобразования относительных элементов пути “<literal>.</literal>” и
-“<literal>..</literal>” в реальные, и возможной
+“<literal>..</literal>” в реальные и возможной
 <link id="merge_slashes">замены</link> двух и более подряд идущих
 слэшей на один.
 </para>
 <para>
 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>”
 (для поиска совпадения без учёта регистра символов),
 либо с модификатором “<literal>~</literal>” (с учётом регистра).
 Чтобы найти location, соответствующий запросу, вначале проверяются
 location’ы, заданные префиксными строками (префиксные location’ы).
-Среди них ищется максимальное совпадение.
+Среди них ищется location с совпадающим префиксом
+максимальной длины и запоминается.
 Затем проверяются регулярные выражения, в порядке их следования
 в конфигурационном файле.
 Проверка регулярных выражений прекращается после первого же совпадения,
 и используется соответствующая конфигурация.
 Если совпадение с регулярным выражением не найдено, то используется
-конфигурация максимально совпавшего префиксного location’а.
+конфигурация запомненного ранее префиксного location’а.
 </para>
 <para>
-location’ы могут быть вложенными, с некоторыми исключениями,
+Блоки <literal>location</literal> могут быть вложенными,
-о которых говорится ниже.
+с некоторыми исключениями, о которых говорится ниже.
 </para>
 <para>
 Для операционных систем, нечувствительных к регистру символов, таких
 как Mac OS X и Cygwin, сравнение с префиксными строками производится
 без учёта регистра (0.7.7).
-Однако, сравнение ограничено только однобайтными locale’ями.
+Однако сравнение ограничено только однобайтными locale’ями.
 </para>
 <para>
 Регулярные выражения могут содержать выделения (0.7.40), которые могут
 затем использоваться в других директивах.
 </para>
 <para>
-Если у максимального совпавшего префиксного location’а указан модификатор
+Если у совпавшего префиксного location’а максимальной длины указан модификатор
 “<literal>^~</literal>”, то регулярные выражения не проверяются.
 </para>
 <para>
 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное
 <para>
 Ограничивает максимальное допустимое число диапазонов в запросах с
 указанием диапазона запрашиваемых байт (byte-range requests).
 Запросы, превышающие указанное ограничение, обрабатываются как
 если бы они не содержали указания диапазонов.
-По умолчанию ограничения нет.
+По умолчанию число диапазонов не ограничено.
 Значение 0 полностью запрещает поддержку диапазонов.
 </para>
 </directive>
 <para>
 Запрет преобразования может понадобиться, если в URI используются имена,
 закодированные методом base64, в котором задействован символ
 “<literal>/</literal>”.
-Однако по соображениям безопасности лучше избегать отключения преобразования.
+Однако из соображений безопасности лучше избегать отключения преобразования.
 </para>
 <para>
 Директива может быть указана на уровне <link id="server"/>
 в сервере по умолчанию.
 <context>location</context>
 <para>
 Задаёт минимальное <value>число</value> обращений к файлу
 в течение времени, заданного параметром <literal>inactive</literal>
-директивы <link id="open_file_cache"/>, после которого дескриптор
+директивы <link id="open_file_cache"/>, необходимых для того, чтобы дескриптор
-файла будет оставаться открытым в кэше.
+файла оставался открытым в кэше.
 </para>
 </directive>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <para>
-Директива устарела, вместо неё следует использовать директиву
+Директива устарела.
-<link id="server_name_in_redirect"/>.
+Вместо неё следует использовать директиву <link id="server_name_in_redirect"/>.
 </para>
 <!--
 <para>
 Разрешает или запрещает оптимизировать проверку имени хоста в name-based
 <para>
 Позволяет производить точную настройку выделений памяти
 под конкретные запросы.
 Эта директива не оказывает существенного влияния на
-производительность и её не следует использовать.
+производительность, и её не следует использовать.
 </para>
 </directive>
 <context>server</context>
 <context>location</context>
 <para>
 Разрешает или запрещает сброс соединений по таймауту.
-Сброс делается следующим образом — перед закрытием сокета для него
+Сброс делается следующим образом.
-ставится параметр
+Перед закрытием сокета для него задаётся параметр
 <c-def>SO_LINGER</c-def>
 с таймаутом 0.
-После чего при закрытии сокета клиенту отсылается TCP RST, а вся память,
+После этого при закрытии сокета клиенту отсылается TCP RST, а вся память,
 связанная с этим сокетом, освобождается.
 Это позволяет избежать длительного нахождения уже закрытого сокета в
 состоянии FIN_WAIT1 с заполненными буферами.
 </para>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-При установке в ненулевое значение nginx будет пытаться минимизировать
+При установке этой директивы в ненулевое значение nginx будет пытаться
-число операций отправки на клиентских сокетах либо при помощи флага
+минимизировать число операций отправки на клиентских сокетах либо при
-<c-def>NOTE_LOWAT</c-def> метода
+помощи флага <c-def>NOTE_LOWAT</c-def> метода
 <link doc="../events.xml" id="kqueue"/>,
-либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>,
+либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>.
-с указанным размером.
+В обоих случаях будет использован указанный <value>размер</value>.
 </para>
 <para>
 Эта директива игнорируется на Linux, Solaris и Windows.
 </para>
 }
 </example>
 </para>
 <para>
-Если параметр равен “<var>$hostname</var>” (0.9.4), то
+Если параметр директивы установлен в “<var>$hostname</var>” (0.9.4), то
 подставляется имя хоста (hostname) машины.
 </para>
 <para>
 Возможно также указать пустое имя сервера (0.7.11):
 <para>
 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом,
 основное имя сервера, задаваемое директивой
 <link id="server_name"/>.
-Если запрещено, то используется имя, указанное в поле <header>Host</header>
+Если использование основного имени сервера запрещено, то используется имя,
-заголовка запроса.
+указанное в поле <header>Host</header> заголовка запроса.
 Если же этого поля нет, то используется IP-адрес сервера.
 </para>
 <para>
 Использование в перенаправлениях порта управляется
 expires 30s;
 }
 </example>
 Последний параметр может также указывать на именованный location,
 как в примерах ниже.
-С версии 0.7.51 последний параметр может также быть кодом:
+С версии 0.7.51 последний параметр может также быть <value>кодом</value>:
 <example>
 location / {
 try_files $uri $uri/index.html $uri.html =404;
 }
 </example>
 <context>server</context>
 <para>
 Разрешает или запрещает использование символов подчёркивания в
 полях заголовка запроса клиента.
-Если запрещено, поля заголовка запроса, в чьих именах есть подчёркивания,
+Если использование символов подчёркивания запрещено, поля заголовка запроса, в
+именах которых есть подчёркивания,
 помечаются как недопустимые и подпадают под действие директивы
 <link id="ignore_invalid_headers"/>.
 </para>
 <para>
 <tag-name id="var_request_body_file"><var>$request_body_file</var></tag-name>
 <tag-desc>
 имя временного файла, в котором хранится тело запроса
 <para>
-По завершению обработки файл необходимо удалить.
+По завершении обработки файл необходимо удалить.
 Для того, чтобы тело запроса всегда записывалось в файл,
 следует включить <link id="client_body_in_file_only"/>.
 При передаче имени временного файла в проксированном запросе
 или в запросе к FastCGI-серверу следует запретить передачу самого
 тела директивами

Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 958:fd1f8e0a405e