Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_gzip_module.xml @ 617:368a449e85b8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Expanded documentation of what various parameters of the "listen" directive related to socket options do. While here, documented the fact that accept filters also work on NetBSD.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 02 Aug 2012 13:24:07 +0000
parents 764fbac1b8b4
children ac709e45740d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
10 <module name="Модуль ngx_http_gzip_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_gzip_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
13 rev="1">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 106
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
18 Модуль <literal>ngx_http_gzip_module</literal> — это фильтр,
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
19 сжимающий ответ методом gzip,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
20 что позволяет уменьшить размер передаваемых данных в 2 и более раз.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
23 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
25
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
26 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 326
diff changeset
30 gzip on;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 326
diff changeset
31 gzip_min_length 1000;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 326
diff changeset
32 gzip_proxied expired no-cache no-store private auth;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 326
diff changeset
33 gzip_types text/plain application/xml;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 <para>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
38 Для записи в лог полученной степени сжатия можно использовать переменную
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
39 <var>$gzip_ratio</var>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
45 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47 <directive name="gzip">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
48 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
49 <default>off</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
50 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
51 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
52 <context>location</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
53 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
54
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
55 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
56 Разрешает или запрещает сжатие ответа методом gzip.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
57 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
58
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
59 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
60
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
61
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
62 <directive name="gzip_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
63 <syntax><value>число</value> <value>размер</value></syntax>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
64 <default>32 4k|16 8k</default>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
65 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
66 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
67 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69 <para>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
70 Задаёт <value>число</value> и <value>размер</value> буферов,
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
71 в которые будет сжиматься ответ.
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
72 По умолчанию размер одного буфера равен размеру страницы.
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
73 В зависимости от платформы это или 4K, или 8K.
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
74 <note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75 До версии 0.7.28 по умолчанию использовалось 4 буфера размером 4K или 8K.
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
76 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
82 <directive name="gzip_comp_level">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
84 <syntax><value>степень</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
85 <default>1</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
86 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
87 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
88 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
89
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
91 Устанавливает <value>степень</value> сжатия ответа методом gzip.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
92 Допустимые значения находятся в диапазоне 1..9.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
94
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
98 <directive name="gzip_disable">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
99 <syntax><value>regex</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
100 <default/>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
101 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
102 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
103 <context>location</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
104 <appeared-in>0.6.23</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106 <para>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
107 Запрещает сжатие ответа методом gzip для запросов
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
108 с полями заголовка <header>User-Agent</header>,
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
109 совпадающими с заданными регулярными выражениями.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
111
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
112 <para>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
113 Специальная маска “<literal>msie6</literal>” (0.7.12) соответствует
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
114 регулярному выражению “<literal>MSIE [4-6]\.</literal>”, но работает быстрее.
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
115 Начиная с версии 0.8.11, из этой маски исключается
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
116 “<literal>MSIE 6.0; ... SV1</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
117 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
118
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
121
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122 <directive name="gzip_min_length">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
123 <syntax><value>длина</value></syntax>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
124 <default>20</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
125 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
126 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
127 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
128
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
129 <para>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
130 Устанавливает минимальную длину ответа, который будет сжиматься методом gzip.
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
131 Длина определяется только из поля <header>Content-Length</header>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
132 заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
133 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
134
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
136
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
137
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
138 <directive name="gzip_http_version">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
139 <syntax><literal>1.0</literal> | <literal>1.1</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
140 <default>1.1</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
141 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
142 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
143 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
145 <para>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
146 Устанавливает минимальную HTTP-версию запроса, необходимую для сжатия ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
147 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
151
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
152 <directive name="gzip_proxied">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
153 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
154 <literal>off</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
155 <literal>expired</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
156 <literal>no-cache</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
157 <literal>no-store</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
158 <literal>private</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
159 <literal>no_last_modified</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
160 <literal>no_etag</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
161 <literal>auth</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
162 <literal>any</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
163 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
164 <default>off</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
165 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
166 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
167 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
168
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
169 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
170 Разрешает или запрещает сжатие ответа методом gzip для проксированных
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 запросов в зависимости от запроса и ответа.
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
172 То, что запрос проксированный, определяется на основании наличия поля
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
173 <header>Via</header> в заголовке запроса.
285
Maxim Konovalov <maxim@nginx.com>
parents: 271
diff changeset
174 В директиве можно указать одновременно несколько параметров:
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
175 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
177 <tag-name><literal>off</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
178 <tag-desc>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
179 запрещает сжатие для всех проксированных запросов,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180 игнорируя остальные параметры;
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
181 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
182
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
183 <tag-name><literal>expired</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
184 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
185 разрешает сжатие, если в заголовке ответа есть поле
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
186 <header>Expires</header> со значением, запрещающим кэширование;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
187 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
188
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
189 <tag-name><literal>no-cache</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
190 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
191 разрешает сжатие, если в заголовке ответа есть поле
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
192 <header>Cache-Control</header> с параметром “<literal>no-cache</literal>”;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
193 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
195 <tag-name><literal>no-store</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
196 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
197 разрешает сжатие, если в заголовке ответа есть поле
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
198 <header>Cache-Control</header> с параметром “<literal>no-store</literal>”;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
199 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
200
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
201 <tag-name><literal>private</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
202 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
203 разрешает сжатие, если в заголовке ответа есть поле
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
204 <header>Cache-Control</header> с параметром “<literal>private</literal>”;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
205 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
207 <tag-name><literal>no_last_modified</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
208 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
209 разрешает сжатие, если в заголовке ответа нет поля
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
210 <header>Last-Modified</header>;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
211 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
212
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
213 <tag-name><literal>no_etag</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
214 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
215 разрешает сжатие, если в заголовке ответа нет поля
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
216 <header>ETag</header>;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
217 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
219 <tag-name><literal>auth</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
220 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
221 разрешает сжатие, если в заголовке запроса есть поле
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
222 <header>Authorization</header>;
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
223 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
225 <tag-name><literal>any</literal></tag-name>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
226 <tag-desc>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
227 разрешает сжатие для всех проксированных запросов.
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
228 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
229
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
230 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
231 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
232
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
233 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
234
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
236 <directive name="gzip_types">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
237 <syntax><value>mime-тип</value> ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
238 <default>text/html</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
239 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
240 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
241 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
242
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244 Разрешает сжатие ответа методом gzip для указанных MIME-типов в дополнение
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
245 к “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
246 Специальное значение “<literal>*</literal>” соответствует любому MIME-типу
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
247 (0.8.29).
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
248 Ответы с типом “<literal>text/html</literal>” сжимаются всегда.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
250
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
251 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
252
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
253
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
254 <directive name="gzip_vary">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
255 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
256 <default>off</default>
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
257 <context>http</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
258 <context>server</context>
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
259 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
260
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
261 <para>
326
92213e993a0b Some minor clarifications.
Ruslan Ermilov <ru@nginx.com>
parents: 322
diff changeset
262 Разрешает или запрещает выдавать в ответе поле заголовка
322
099ee546b04e Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
263 <header>Vary: Accept-Encoding</header>, если директивы
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
264 <link id="gzip"/> или
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
265 <link doc="ngx_http_gzip_static_module.xml" id="gzip_static"/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
266 активны.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
267 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
268
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
269 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
270
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
271 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
272
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
273 </module>