diff xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 995:c5ccf511346a

Documented the "fastcgi_buffering" directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 02 Oct 2013 13:41:26 +0400
parents 95c3c3bbf1ce
children 2275611970dd
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Oct 02 13:41:24 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Oct 02 13:41:26 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="9">
+        rev="10">
 
 <section id="summary">
 
@@ -83,6 +83,48 @@
 </directive>
 
 
+<directive name="fastcgi_buffering">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>on</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.5.6</appeared-in>
+
+<para>
+Разрешает или запрещает использовать буферизацию ответов FastCGI-сервера.
+</para>
+
+<para>
+Если буферизация включена, то nginx принимает ответ FastCGI-сервера
+как можно быстрее, сохраняя его в буферы, заданные директивами
+<link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
+Если ответ не вмещается целиком в память, то его часть может быть записана
+на диск во <link id="fastcgi_temp_path">временный файл</link>.
+Запись во временные файлы контролируется директивами
+<link id="fastcgi_max_temp_file_size"/> и
+<link id="fastcgi_temp_file_write_size"/>.
+</para>
+
+<para>
+Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
+по мере его поступления.
+nginx не пытается считать весь ответ FastCGI-сервера.
+Максимальный размер данных, который nginx может принять от сервера
+за один раз, задаётся директивой <link id="fastcgi_buffer_size"/>.
+</para>
+
+<para>
+Буферизация может быть также включена или выключена путём передачи
+значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
+<header>X-Accel-Buffering</header> заголовка ответа.
+Эту возможность можно запретить с помощью директивы
+<link id="fastcgi_ignore_headers"/>.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_buffers">
 <syntax><value>число</value> <value>размер</value></syntax>
 <default>8 4k|8k</default>
@@ -109,7 +151,8 @@
 <context>location</context>
 
 <para>
-Ограничивает суммарный <value>размер</value>
+При включённой <link id="fastcgi_buffering">буферизации</link> ответов
+FastCGI-сервера, ограничивает суммарный <value>размер</value>
 буферов, которые могут быть заняты для отправки ответа клиенту, пока
 ответ ещё не прочитан целиком.
 Оставшиеся буферы тем временем могут использоваться для чтения ответа
@@ -536,7 +579,7 @@
 
 <listitem>
 <header>X-Accel-Buffering</header> включает или выключает
-буферизацию ответа;
+<link id="fastcgi_buffering">буферизацию</link> ответа;
 </listitem>
 
 <listitem>
@@ -622,9 +665,10 @@
 <context>location</context>
 
 <para>
-Если ответ не вмещается целиком в буферы памяти, заданные
-директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>,
-часть ответа может быть записана во временный файл.
+Если включена <link id="fastcgi_buffering">буферизация</link> ответов
+FastCGI-сервера, и ответ не вмещается целиком в буферы памяти,
+заданные директивами <link id="fastcgi_buffer_size"/> и
+<link id="fastcgi_buffers"/>, часть ответа может быть записана во временный файл.
 Эта директива задаёт максимальный <value>размер</value> временного файла.
 Размер данных, сбрасываемых во временный файл за один раз, задаётся
 директивой <link id="fastcgi_temp_file_write_size"/>.