Mercurial > hg > nginx-site
annotate xml/en/docs/http/ngx_http_gzip_static_module.xml @ 504:695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
directive achieves. Referenced the "proxy_cache_lock" directive from there,
which has similar effect when populating a new cache element.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 24 Apr 2012 06:54:47 +0000 |
parents | a4fa80755eab |
children | be54c443235a |
rev | line source |
---|---|
330
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
4 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
5 <module name="Module ngx_http_gzip_static_module" |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 link="/en/docs/http/ngx_http_gzip_static_module.html" |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
7 lang="en"> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 <section id="summary"> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 <para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
12 The <literal>ngx_http_gzip_static_module</literal> module allows |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
13 to send precompressed files with the “<literal>.gz</literal>” |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 filename extension instead of regular files. |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 </para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 <para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 This module is not built by default, it should be enabled with the |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 <literal>--with-http_gzip_static_module</literal> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 configuration parameter. |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
21 </para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 </section> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 <section id="example" name="Example Configuration"> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 <para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
330
diff
changeset
|
30 gzip_static on; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
330
diff
changeset
|
31 gzip_proxied expired no-cache no-store private auth; |
330
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 </example> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 </para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 </section> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 <section id="directives" name="Directives"> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 <directive name="gzip_static"> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 <default>off</default> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 <context>http</context> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 <context>server</context> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 <context>location</context> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
47 <para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 Enables or disables checking the existence of precompressed files. |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 The following directives are also taken into account: |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
50 <link doc="ngx_http_gzip_module.xml" id="gzip_http_version"/>, |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 <link doc="ngx_http_gzip_module.xml" id="gzip_proxied"/>, |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
52 <link doc="ngx_http_gzip_module.xml" id="gzip_disable"/>, |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 and <link doc="ngx_http_gzip_module.xml" id="gzip_vary"/>. |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 </para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 <para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 The files can be compressed using the <command>gzip</command> command, |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
58 or any other compatible. |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 It is recommended that the modification date and time of original and |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
60 compressed files be the same. |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
61 </para> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
62 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
63 </directive> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 </section> |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 |
f94bcab2a6ae
Translated ngx_http_gzip_module and ngx_http_gzip_static_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 </module> |