<?xml version="1.0"?>

<!--
  Copyright (C) Nginx, Inc.
  -->

<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">

<module name="Модуль ngx_http_spdy_module"
        link="/ru/docs/http/ngx_http_spdy_module.html"
        lang="ru"
        rev="10">

<section id="summary">

<para>
Модуль <literal>ngx_http_spdy_module</literal> обеспечивает экспериментальную
поддержку <link url="http://www.chromium.org/spdy/spdy-protocol">SPDY</link>.
В настоящий момент реализован
<link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft3-1">draft
3.1</link> протокола SPDY.
<note>
До версии 1.5.10 был реализован
<link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2">draft
2</link> протокола SPDY.
</note>
</para>

<para>
По умолчанию этот модуль не собирается, его сборку необходимо
разрешить с помощью конфигурационного параметра
<literal>--with-http_spdy_module</literal>.
</para>

<para>
<note>
Этот модуль был заменён модулем
<link doc="ngx_http_v2_module.xml">ngx_http_v2_module</link>
в версии 1.9.5.
</note>
</para>

</section>


<section id="issues" name="Известные проблемы">

<para>
Модуль экспериментальный, поэтому возможно всё.
</para>

<para>
Текущая реализация протокола SPDY не поддерживает server push.
</para>

<para>
До версии 1.5.9 скорость передачи ответа клиенту в SPDY-соединении не могла быть
<link doc="ngx_http_core_module.xml" id="limit_rate">ограничена</link>.
</para>

<para>
Буферизация тела запроса клиента не может быть выключена
независимо от значения директив
<link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering"/>,
<link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering"/>,
<link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering"/> и
<link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering"/>.
</para>

</section>


<section id="example" name="Пример конфигурации">

<para>
<example>
server {
    listen 443 ssl spdy;

    ssl_certificate server.crt;
    ssl_certificate_key server.key;
    ...
}
</example>
<note>
Для того чтобы одновременно принимать
<link doc="ngx_http_ssl_module.xml">HTTPS</link> и
SPDY соединения на том же порту,
используемая библиотека <link url="http://www.openssl.org">OpenSSL</link>
должна поддерживать расширение Next Protocol Negotiation протокола TLS,
доступное с версии OpenSSL 1.0.1.
</note>
</para>

</section>


<section id="directives" name="Директивы">

<directive name="spdy_chunk_size">
<syntax><value>размер</value></syntax>
<default>8k</default>
<context>http</context>
<context>server</context>
<context>location</context>
<appeared-in>1.5.9</appeared-in>

<para>
Задаёт максимальный размер частей,
на которые будет
<link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2#TOC-Data-frames">
разделяться</link> тело ответа.
Слишком маленькое значение может
привести к росту накладных расходов.
Слишком большое значение может
негативно сказаться на приоритизации из-за
<link url="http://en.wikipedia.org/wiki/Head-of-line_blocking">
блокировки очереди</link>.
</para>

</directive>


<directive name="spdy_headers_comp">
<syntax><value>степень</value></syntax>
<default>0</default>
<context>http</context>
<context>server</context>

<para>
Устанавливает <value>степень</value> сжатия заголовков ответа
в диапазоне от 1 (быстрее, но хуже сжатие) до 9 (медленнее, лучшее сжатие).
Специальное значение 0 отключает сжатие заголовков.
</para>

</directive>

</section>


<section id="variables" name="Встроенные переменные">

<para>
Модуль <literal>ngx_http_spdy_module</literal>
поддерживает следующие встроенные переменные:
<list type="tag" compact="no">

<tag-name id="var_spdy"><var>$spdy</var></tag-name>
<tag-desc>
версия протокола SPDY для SPDY-соединений,
либо пустая строка;
</tag-desc>

<tag-name id="var_spdy_request_priority"><var>$spdy_request_priority</var>
</tag-name>
<tag-desc>
приоритет запроса для SPDY-соединений,
либо пустая строка.
</tag-desc>

</list>
</para>

</section>

</module>