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