<?xml version="1.0"?>

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

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

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

<section id="summary">

<para>
Модуль <literal>ngx_http_gzip_static_module</literal> позволяет отдавать
вместо обычного файла предварительно сжатый файл с таким же именем
и с расширением “<literal>.gz</literal>”.
</para>

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

</section>


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

<para>
<example>
gzip_static  on;
gzip_proxied expired no-cache no-store private auth;
</example>
</para>

</section>


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

<directive name="gzip_static">
<syntax>
    <literal>on</literal> |
    <literal>off</literal> |
    <literal>always</literal></syntax>
<default>off</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Разрешает (“<literal>on</literal>”) или запрещает (“<literal>off</literal>”)
проверку готового сжатого файла.
При использовании также учитываются директивы
<link doc="ngx_http_gzip_module.xml" id="gzip_http_version"/>,
<link doc="ngx_http_gzip_module.xml" id="gzip_proxied"/>,
<link doc="ngx_http_gzip_module.xml" id="gzip_disable"/>
и <link doc="ngx_http_gzip_module.xml" id="gzip_vary"/>.
</para>

<para>
Со значением “<literal>always</literal>” (1.3.6) во всех случаях будет
использоваться сжатый файл, без проверки поддержки на стороне клиента.
Это полезно, если на диске всё равно нет несжатых файлов, или используется
модуль <link doc="ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link>.
</para>

<para>
Сжимать файлы можно с помощью программы <command>gzip</command>
или совместимой с ней.
Желательно, чтобы дата и время модификации исходного и сжатого файлов совпадали.
</para>

</directive>

</section>

</module>