Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_gunzip_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
parents | ac709e45740d |
children |
rev | line source |
---|---|
676
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
2 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
3 <!-- |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
4 Copyright (C) Maxim Dounin |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
6 --> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
7 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
9 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
10 <module name="Модуль ngx_http_gunzip_module" |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
11 link="/ru/docs/http/ngx_http_gunzip_module.html" |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
12 lang="ru" |
744
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
13 rev="2"> |
676
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
14 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
15 <section id="summary"> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
16 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
17 <para> |
744
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
18 Модуль <literal>ngx_http_gunzip_module</literal> — это фильтр, |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
19 распаковывающий ответы с “<literal>Content-Encoding: gzip</literal>” |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
20 для тех клиентов, которые не поддерживают метод сжатия “gzip”. |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
21 Модуль будет полезен, когда данные желательно хранить сжатыми |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
22 для экономии места и сокращения затрат на ввод-вывод. |
676
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
23 </para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
24 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
25 <para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
26 По умолчанию этот модуль не собирается, его сборку необходимо |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
27 разрешить с помощью конфигурационного параметра |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
28 <literal>--with-http_gunzip_module</literal>. |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
29 </para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
30 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
31 </section> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
32 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
33 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
34 <section id="example" name="Пример конфигурации"> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
35 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
36 <para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
37 <example> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
38 location /storage/ { |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
39 gunzip on; |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
40 ... |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
41 } |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
42 </example> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
43 </para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
44 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
45 </section> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
46 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
47 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
48 <section id="directives" name="Директивы"> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
49 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
50 <directive name="gunzip"> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
51 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
52 <default>off</default> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
53 <context>http</context> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
54 <context>server</context> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
55 <context>location</context> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
56 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
57 <para> |
744
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
58 Разрешает или запрещает распаковку ответов, сжатых методом gzip, |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
59 для тех клиентов, которые его не поддерживают. |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
60 Если разрешено, то для определения, поддерживает ли клиент gzip, |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
61 также учитываются следующие директивы: |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
62 <link doc="ngx_http_gzip_module.xml" id="gzip_http_version"/>, |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
63 <link doc="ngx_http_gzip_module.xml" id="gzip_proxied"/> и |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
64 <link doc="ngx_http_gzip_module.xml" id="gzip_disable"/>. |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
65 См. также директиву <link doc="ngx_http_gzip_module.xml" id="gzip_vary"/>. |
676
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
66 </para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
67 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
68 </directive> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
69 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
70 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
71 <directive name="gunzip_buffers"> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
72 <syntax><value>число</value> <value>размер</value></syntax> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
73 <default>32 4k|16 8k</default> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
74 <context>http</context> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
75 <context>server</context> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
76 <context>location</context> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
77 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
78 <para> |
744
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
79 Задаёт <value>число</value> и <value>размер</value> буферов, |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
80 в которые будет разжиматься ответ. |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
81 По умолчанию размер одного буфера равен размеру страницы. |
ac709e45740d
Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
676
diff
changeset
|
82 В зависимости от платформы это или 4K, или 8K. |
676
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
83 </para> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
84 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
85 </directive> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
86 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
87 </section> |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
88 |
6d6aa03e43fa
Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff
changeset
|
89 </module> |