Mercurial > hg > nginx-site
view xml/en/docs/http/ngx_http_gzip_static_module.xml @ 1826:da6a3e401b26
Slightly reformatted the error_page description.
Information about directives inheritance was moved to the end.
Blocks describing various syntaxes of the "uri" argument were
put in the following order:
- internal redirect to the specified /uri;
- internal redirect to a named location;
- URL redirection.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Mon, 24 Oct 2016 11:57:46 +0300 |
parents | 95c3c3bbf1ce |
children |
line wrap: on
line source
<?xml version="1.0"?> <!-- Copyright (C) Igor Sysoev Copyright (C) Nginx, Inc. --> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> <module name="Module ngx_http_gzip_static_module" link="/en/docs/http/ngx_http_gzip_static_module.html" lang="en" rev="2"> <section id="summary"> <para> The <literal>ngx_http_gzip_static_module</literal> module allows sending precompressed files with the “<literal>.gz</literal>” filename extension instead of regular files. </para> <para> This module is not built by default, it should be enabled with the <literal>--with-http_gzip_static_module</literal> configuration parameter. </para> </section> <section id="example" name="Example Configuration"> <para> <example> gzip_static on; gzip_proxied expired no-cache no-store private auth; </example> </para> </section> <section id="directives" name="Directives"> <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> Enables (“<literal>on</literal>”) or disables (“<literal>off</literal>”) checking the existence of precompressed files. The following directives are also taken into account: <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"/>, and <link doc="ngx_http_gzip_module.xml" id="gzip_vary"/>. </para> <para> With the “<literal>always</literal>” value (1.3.6), gzipped file is used in all cases, without checking if the client supports it. It is useful if there are no uncompressed files on the disk anyway or the <link doc="ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link> is used. </para> <para> The files can be compressed using the <command>gzip</command> command, or any other compatible one. It is recommended that the modification date and time of original and compressed files be the same. </para> </directive> </section> </module>