comparison xml/ru/docs/http/ngx_http_v2_module.xml @ 2105:d45887ccafde

Documented HTTP/2 server push.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 15 Feb 2018 21:24:36 +0300
parents ffb3570c352c
children ca7568f67dee
comparison
equal deleted inserted replaced
2104:c2e3884f1a9c 2105:d45887ccafde
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_http_v2_module" 9 <module name="Модуль ngx_http_v2_module"
10 link="/ru/docs/http/ngx_http_v2_module.html" 10 link="/ru/docs/http/ngx_http_v2_module.html"
11 lang="ru" 11 lang="ru"
12 rev="10"> 12 rev="11">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_http_v2_module</literal> (1.9.5) обеспечивает 17 Модуль <literal>ngx_http_v2_module</literal> (1.9.5) обеспечивает
125 </para> 125 </para>
126 126
127 </directive> 127 </directive>
128 128
129 129
130 <directive name="http2_max_concurrent_pushes">
131 <syntax><value>число</value></syntax>
132 <default>10</default>
133 <context>http</context>
134 <context>server</context>
135 <appeared-in>1.13.9</appeared-in>
136
137 <para>
138 Ограничивает максимальное число параллельных
139 <link id="http2_push">push</link>-запросов в соединении.
140 </para>
141
142 </directive>
143
144
130 <directive name="http2_max_concurrent_streams"> 145 <directive name="http2_max_concurrent_streams">
131 <syntax><value>число</value></syntax> 146 <syntax><value>число</value></syntax>
132 <default>128</default> 147 <default>128</default>
133 <context>http</context> 148 <context>http</context>
134 <context>server</context> 149 <context>server</context>
181 <context>http</context> 196 <context>http</context>
182 <context>server</context> 197 <context>server</context>
183 <appeared-in>1.11.6</appeared-in> 198 <appeared-in>1.11.6</appeared-in>
184 199
185 <para> 200 <para>
186 Задаёт максимальное число запросов, которые можно 201 Задаёт максимальное число запросов (включая
202 <link id="http2_push">push</link>-запросы), которые можно
187 сделать по одному соединению HTTP/2, 203 сделать по одному соединению HTTP/2,
188 после чего соединение закрывается 204 после чего очередной клиентский запрос приведёт к закрытию соединения
189 и клиенту необходимо использовать новое соединение. 205 и необходимости установить новое соединение.
206 </para>
207
208 </directive>
209
210
211 <directive name="http2_push">
212 <syntax><value>uri</value> | <literal>off</literal></syntax>
213 <default>off</default>
214 <context>http</context>
215 <context>server</context>
216 <context>location</context>
217 <appeared-in>1.13.9</appeared-in>
218
219 <para>
220 Заблаговременно отправляет
221 (<link url="https://tools.ietf.org/html/rfc7540#section-8.2">push</link>) запрос
222 к заданному <value>uri</value>
223 вместе с ответом на оригинальный запрос.
224 Будут обработаны только относительные URI с абсолютными путями,
225 например:
226 <example>
227 http2_push /static/css/main.css;
228 </example>
229 В значении <value>uri</value> допустимо использование переменных.
230 </para>
231
232 <para>
233 На одном уровне конфигурации можно указать несколько
234 <literal>http2_push</literal> директив.
235 Параметр <literal>off</literal> отменяет действие
236 унаследованных с предыдущего уровня конфигурации
237 директив <literal>http2_push</literal>.
238 </para>
239
240 </directive>
241
242
243 <directive name="http2_push_preload">
244 <syntax><literal>on</literal> | <literal>off</literal></syntax>
245 <default>off</default>
246 <context>http</context>
247 <context>server</context>
248 <context>location</context>
249 <appeared-in>1.13.9</appeared-in>
250
251 <para>
252 Разрешает автоматическое преобразование
253 <link url="https://www.w3.org/TR/preload/#server-push-http-2">preload
254 links</link>,
255 указанных в полях <header>Link</header> заголовка ответа, в
256 <link url="https://tools.ietf.org/html/rfc7540#section-8.2">push</link>-запросы.
190 </para> 257 </para>
191 258
192 </directive> 259 </directive>
193 260
194 261