Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_gunzip_module.xml @ 2675:893cd7724c8c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "r" argument for js_body_filter.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 09 Mar 2021 18:44:56 +0000
parents ac709e45740d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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>