Mercurial > hg > nginx-site

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "fastcgi_buffering" directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 02 Oct 2013 13:41:26 +0400
parents 95c3c3bbf1ce
children 2275611970dd
comparison
equal deleted inserted replaced
994:f09f77ef45e9 995:c5ccf511346a
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_fastcgi_module" 10 <module name="Модуль ngx_http_fastcgi_module"
11 link="/ru/docs/http/ngx_http_fastcgi_module.html" 11 link="/ru/docs/http/ngx_http_fastcgi_module.html"
12 lang="ru" 12 lang="ru"
13 rev="9"> 13 rev="10">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать 18 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать
81 </para> 81 </para>
82 82
83 </directive> 83 </directive>
84 84
85 85
86 <directive name="fastcgi_buffering">
87 <syntax><literal>on</literal> | <literal>off</literal></syntax>
88 <default>on</default>
89 <context>http</context>
90 <context>server</context>
91 <context>location</context>
92 <appeared-in>1.5.6</appeared-in>
93
94 <para>
95 Разрешает или запрещает использовать буферизацию ответов FastCGI-сервера.
96 </para>
97
98 <para>
99 Если буферизация включена, то nginx принимает ответ FastCGI-сервера
100 как можно быстрее, сохраняя его в буферы, заданные директивами
101 <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>.
102 Если ответ не вмещается целиком в память, то его часть может быть записана
103 на диск во <link id="fastcgi_temp_path">временный файл</link>.
104 Запись во временные файлы контролируется директивами
105 <link id="fastcgi_max_temp_file_size"/> и
106 <link id="fastcgi_temp_file_write_size"/>.
107 </para>
108
109 <para>
110 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
111 по мере его поступления.
112 nginx не пытается считать весь ответ FastCGI-сервера.
113 Максимальный размер данных, который nginx может принять от сервера
114 за один раз, задаётся директивой <link id="fastcgi_buffer_size"/>.
115 </para>
116
117 <para>
118 Буферизация может быть также включена или выключена путём передачи
119 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
120 <header>X-Accel-Buffering</header> заголовка ответа.
121 Эту возможность можно запретить с помощью директивы
122 <link id="fastcgi_ignore_headers"/>.
123 </para>
124
125 </directive>
126
127
86 <directive name="fastcgi_buffers"> 128 <directive name="fastcgi_buffers">
87 <syntax><value>число</value> <value>размер</value></syntax> 129 <syntax><value>число</value> <value>размер</value></syntax>
88 <default>8 4k|8k</default> 130 <default>8 4k|8k</default>
89 <context>http</context> 131 <context>http</context>
90 <context>server</context> 132 <context>server</context>
107 <context>http</context> 149 <context>http</context>
108 <context>server</context> 150 <context>server</context>
109 <context>location</context> 151 <context>location</context>
110 152
111 <para> 153 <para>
112 Ограничивает суммарный <value>размер</value> 154 При включённой <link id="fastcgi_buffering">буферизации</link> ответов
155 FastCGI-сервера, ограничивает суммарный <value>размер</value>
113 буферов, которые могут быть заняты для отправки ответа клиенту, пока 156 буферов, которые могут быть заняты для отправки ответа клиенту, пока
114 ответ ещё не прочитан целиком. 157 ответ ещё не прочитан целиком.
115 Оставшиеся буферы тем временем могут использоваться для чтения ответа 158 Оставшиеся буферы тем временем могут использоваться для чтения ответа
116 и, при необходимости, буферизации части ответа во временный файл. 159 и, при необходимости, буферизации части ответа во временный файл.
117 По умолчанию <value>размер</value> ограничен двумя буферами, заданными 160 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
534 скорости</link> передачи ответа клиенту; 577 скорости</link> передачи ответа клиенту;
535 </listitem> 578 </listitem>
536 579
537 <listitem> 580 <listitem>
538 <header>X-Accel-Buffering</header> включает или выключает 581 <header>X-Accel-Buffering</header> включает или выключает
539 буферизацию ответа; 582 <link id="fastcgi_buffering">буферизацию</link> ответа;
540 </listitem> 583 </listitem>
541 584
542 <listitem> 585 <listitem>
543 <header>X-Accel-Charset</header> задаёт желаемую 586 <header>X-Accel-Charset</header> задаёт желаемую
544 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link> 587 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
620 <context>http</context> 663 <context>http</context>
621 <context>server</context> 664 <context>server</context>
622 <context>location</context> 665 <context>location</context>
623 666
624 <para> 667 <para>
625 Если ответ не вмещается целиком в буферы памяти, заданные 668 Если включена <link id="fastcgi_buffering">буферизация</link> ответов
626 директивами <link id="fastcgi_buffer_size"/> и <link id="fastcgi_buffers"/>, 669 FastCGI-сервера, и ответ не вмещается целиком в буферы памяти,
627 часть ответа может быть записана во временный файл. 670 заданные директивами <link id="fastcgi_buffer_size"/> и
671 <link id="fastcgi_buffers"/>, часть ответа может быть записана во временный файл.
628 Эта директива задаёт максимальный <value>размер</value> временного файла. 672 Эта директива задаёт максимальный <value>размер</value> временного файла.
629 Размер данных, сбрасываемых во временный файл за один раз, задаётся 673 Размер данных, сбрасываемых во временный файл за один раз, задаётся
630 директивой <link id="fastcgi_temp_file_write_size"/>. 674 директивой <link id="fastcgi_temp_file_write_size"/>.
631 </para> 675 </para>
632 676