Mercurial > hg > nginx-site
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"/>.