changeset 411:f8248d0e3c8f

Documented the following directives: fastcgi_busy_buffers_size, fastcgi_max_temp_file_size, and fastcgi_temp_file_write_size.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 14 Feb 2012 11:03:53 +0000
parents e766fa4c2dbb
children d85b74249e04
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml
diffstat 2 files changed, 129 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Mon Feb 13 13:35:57 2012 +0000
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Tue Feb 14 11:03:53 2012 +0000
@@ -75,6 +75,26 @@
 </directive>
 
 
+<directive name="fastcgi_busy_buffers_size">
+<syntax><value>size</value></syntax>
+<default>8k|16k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Limits the total <value>size</value> of buffers that
+can be busy sending a response to the client while the response is not
+yet fully read.
+In the mean time, the rest of the buffers can be used for reading a response
+and, if needed, buffering part of a response to a temporary file.
+By default, <value>size</value> is limited by two buffers set by the
+<link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/> directives.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache">
 <syntax><value>zone</value> | <literal>off</literal></syntax>
 <default>off</default>
@@ -437,6 +457,29 @@
 </directive>
 
 
+<directive name="fastcgi_max_temp_file_size">
+<syntax><value>size</value></syntax>
+<default>1024m</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+When the whole response does not fit into memory buffers
+set by the <link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/>
+directives, part of a response can be saved to a temporary file.
+This directive sets the maximum <value>size</value> of a temporary file.
+The size of data written to a temporary file at a time is set
+by the <link id="fastcgi_temp_file_write_size"/> directive.
+</para>
+
+<para>
+Value of zero disables buffering of responses to temporary files.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_next_upstream">
 <syntax>
     <literal>error</literal> |
@@ -772,6 +815,26 @@
 </directive>
 
 
+<directive name="fastcgi_temp_file_write_size">
+<syntax><value>size</value></syntax>
+<default>8k|16k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Limits the <value>size</value> of data written to a temporary file
+at a time, when buffering of responses from the FastCGI server
+to temporary files is enabled.
+By default, <value>size</value> is limited by two buffers set by the
+<link id="fastcgi_buffer_size"/> and <link id="fastcgi_buffers"/> directives.
+The maximum size of a temporary file is set by the
+<link id="fastcgi_max_temp_file_size"/> directive.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_temp_path">
 <syntax>
     <value>path</value>
@@ -785,7 +848,7 @@
 
 <para>
 Defines a directory for storing temporary files
-received from another server.
+with data received from FastCGI servers.
 Up to three-level subdirectory hierarchy can be used underneath the specified
 directory.
 For example, in the following configuration
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Mon Feb 13 13:35:57 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Tue Feb 14 11:03:53 2012 +0000
@@ -74,6 +74,26 @@
 </directive>
 
 
+<directive name="fastcgi_busy_buffers_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="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache">
 <syntax><value>зона</value> | <literal>off</literal></syntax>
 <default>off</default>
@@ -434,6 +454,29 @@
 </directive>
 
 
+<directive name="fastcgi_max_temp_file_size">
+<syntax><value>размер</value></syntax>
+<default>1024m</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Если ответ не вмещается целиком в буферы памяти, заданные
+директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>,
+часть ответа может быть записана во временный файл.
+Эта директива задаёт максимальный <value>размер</value> временного файла.
+Размер данных, сбрасываемых во временный файл за один раз, задаётся
+директивой <link id="fastcgi_temp_file_write_size"/>.
+</para>
+
+<para>
+Значение 0 отключает возможность буферизации ответов во временные файлы.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_next_upstream">
 <syntax>
     <literal>error</literal> |
@@ -767,6 +810,26 @@
 </directive>
 
 
+<directive name="fastcgi_temp_file_write_size">
+<syntax><value>размер</value></syntax>
+<default>8k|16k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
+за один раз, при включённой буферизации ответов FastCGI-сервера
+во временные файлы.
+По умолчанию <value>размер</value> ограничен двумя буферами, заданными
+директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
+Максимальный размер временного файла задаётся директивой
+<link id="fastcgi_max_temp_file_size"/>.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_temp_path">
 <syntax>
     <value>путь</value>
@@ -779,8 +842,8 @@
 <context>location</context>
 
 <para>
-Задаёт имя каталога для хранения временных файлов,
-полученных от другого сервера.
+Задаёт имя каталога для хранения временных файлов с данными,
+полученными от FastCGI-серверов.
 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
 Например, при такой конфигурации
 <example>