diff 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
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_v2_module.xml	Tue Feb 13 19:51:25 2018 +0300
+++ b/xml/ru/docs/http/ngx_http_v2_module.xml	Thu Feb 15 21:24:36 2018 +0300
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_http_v2_module"
         link="/ru/docs/http/ngx_http_v2_module.html"
         lang="ru"
-        rev="10">
+        rev="11">
 
 <section id="summary">
 
@@ -127,6 +127,21 @@
 </directive>
 
 
+<directive name="http2_max_concurrent_pushes">
+<syntax><value>число</value></syntax>
+<default>10</default>
+<context>http</context>
+<context>server</context>
+<appeared-in>1.13.9</appeared-in>
+
+<para>
+Ограничивает максимальное число параллельных
+<link id="http2_push">push</link>-запросов в соединении.
+</para>
+
+</directive>
+
+
 <directive name="http2_max_concurrent_streams">
 <syntax><value>число</value></syntax>
 <default>128</default>
@@ -183,10 +198,62 @@
 <appeared-in>1.11.6</appeared-in>
 
 <para>
-Задаёт максимальное число запросов, которые можно
+Задаёт максимальное число запросов (включая
+<link id="http2_push">push</link>-запросы), которые можно
 сделать по одному соединению HTTP/2,
-после чего соединение закрывается
-и клиенту необходимо использовать новое соединение.
+после чего очередной клиентский запрос приведёт к закрытию соединения
+и необходимости установить новое соединение.
+</para>
+
+</directive>
+
+
+<directive name="http2_push">
+<syntax><value>uri</value> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.13.9</appeared-in>
+
+<para>
+Заблаговременно отправляет
+(<link url="https://tools.ietf.org/html/rfc7540#section-8.2">push</link>) запрос
+к заданному <value>uri</value>
+вместе с ответом на оригинальный запрос.
+Будут обработаны только относительные URI с абсолютными путями,
+например:
+<example>
+http2_push /static/css/main.css;
+</example>
+В значении <value>uri</value> допустимо использование переменных.
+</para>
+
+<para>
+На одном уровне конфигурации можно указать несколько
+<literal>http2_push</literal> директив.
+Параметр <literal>off</literal> отменяет действие
+унаследованных с предыдущего уровня конфигурации
+директив <literal>http2_push</literal>.
+</para>
+
+</directive>
+
+
+<directive name="http2_push_preload">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.13.9</appeared-in>
+
+<para>
+Разрешает автоматическое преобразование
+<link url="https://www.w3.org/TR/preload/#server-push-http-2">preload
+links</link>,
+указанных в полях <header>Link</header> заголовка ответа, в
+<link url="https://tools.ietf.org/html/rfc7540#section-8.2">push</link>-запросы.
 </para>
 
 </directive>