diff xml/ru/docs/http/ngx_http_proxy_module.xml @ 405:781b23ba3b0a

Documented the following directives: proxy_busy_buffers_size, proxy_max_temp_file_size, and proxy_temp_file_write_size.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 10 Feb 2012 13:27:50 +0000
parents bb51d3e17dd0
children cbc2d1b51cb6
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Thu Feb 09 06:45:43 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Feb 10 13:27:50 2012 +0000
@@ -59,14 +59,18 @@
 <context>location</context>
 
 <para>
-Разрешает или запрещает использовать буферизацию ответа проксируемого сервера.
+Разрешает или запрещает использовать буферизацию ответов проксируемого сервера.
 </para>
 
 <para>
 Если буферизация включена, то nginx принимает ответ проксируемого сервера
 как можно быстрее, сохраняя его в буферы, заданные директивами
 <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
-Если ответ не вмещается целиком в память, то его часть записывается на диск.
+Если ответ не вмещается целиком в память, то его часть может быть записана
+на диск во <link id="proxy_temp_path">временный файл</link>.
+Запись во временные файлы контролируется директивами
+<link id="proxy_max_temp_file_size"/> и
+<link id="proxy_temp_file_write_size"/>.
 </para>
 
 <para>
@@ -98,6 +102,27 @@
 </directive>
 
 
+<directive name="proxy_busy_buffers_size">
+<syntax><value>размер</value></syntax>
+<default>8k|16k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+При включённой <link id="proxy_buffering">буферизации</link> ответов
+проксируемого сервера, ограничивает суммарный <value>размер</value>
+буферов, которые могут быть заняты для отправки ответа клиенту, пока
+ответ ещё не прочитан целиком.
+Оставшиеся буферы тем временем могут использоваться для чтения ответа
+и, при необходимости, буферизации части ответа во временный файл.
+По умолчанию <value>размер</value> ограничен двумя буферами, заданными
+директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache">
 <syntax><value>зона</value> | <literal>off</literal></syntax>
 <default>off</default>
@@ -439,6 +464,30 @@
 </directive>
 
 
+<directive name="proxy_max_temp_file_size">
+<syntax><value>размер</value></syntax>
+<default>1024m</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Если включена <link id="proxy_buffering">буферизация</link> ответов
+проксируемого сервера, и ответ не вмещается целиком в буферы памяти,
+заданные директивами <link id="proxy_buffer_size"/> и
+<link id="proxy_buffers"/>, часть ответа может быть записана во временный файл.
+Эта директива задаёт максимальный <value>размер</value> временного файла.
+Размер данных, сбрасываемых во временный файл за один раз, задаётся
+директивой <link id="proxy_temp_file_write_size"/>.
+</para>
+
+<para>
+Значение 0 отключает возможность буферизации ответов во временные файлы.
+</para>
+
+</directive>
+
+
 <directive name="proxy_next_upstream">
 <syntax>
     <literal>error</literal> |
@@ -983,6 +1032,26 @@
 </directive>
 
 
+<directive name="proxy_temp_file_write_size">
+<syntax><value>размер</value></syntax>
+<default>8k|16k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
+за один раз, при включённой буферизации ответов проксируемого сервера
+во временные файлы.
+По умолчанию <value>размер</value> ограничен двумя буферами, заданными
+директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
+Максимальный размер временного файла задаётся директивой
+<link id="proxy_max_temp_file_size"/>.
+</para>
+
+</directive>
+
+
 <directive name="proxy_temp_path">
 <syntax>
     <value>путь</value>
@@ -995,8 +1064,8 @@
 <context>location</context>
 
 <para>
-Задаёт имя каталога для хранения временных файлов,
-полученных от другого сервера.
+Задаёт имя каталога для хранения временных файлов с данными,
+полученными от проксируемых серверов.
 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
 Например, при такой конфигурации
 <example>