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