# HG changeset patch # User Ruslan Ermilov # Date 1326721332 0 # Node ID 099ee546b04ee8671a40d7aa7776301b91889625 # Parent f28abb2ea6383e9fc0fa01936a4b670f6d476bb5 Revision. diff --git a/xml/ru/docs/http/ngx_http_gzip_module.xml b/xml/ru/docs/http/ngx_http_gzip_module.xml --- a/xml/ru/docs/http/ngx_http_gzip_module.xml +++ b/xml/ru/docs/http/ngx_http_gzip_module.xml @@ -2,44 +2,49 @@ -
-Модуль ngx_http_gzip_module - это фильтр, сжимающий ответ методом gzip, +Модуль ngx_http_gzip_module — это фильтр, +сжимающий ответ методом gzip, что позволяет уменьшить размер передаваемых данных в 2 и более раз.
-
+
- gzip on; - gzip_min_length 1000; - gzip_proxied expired no-cache no-store private auth; - gzip_types text/plain application/xml; + gzip on; + gzip_min_length 1000; + gzip_proxied expired no-cache no-store private auth; + gzip_types text/plain application/xml; -Для записи в лог степени сжатия можно использовать переменную $gzip_ratio. +Для записи в лог степени сжатия можно использовать переменную +$gzip_ratio.
-
+
on | off off -http, server, location, if в location +http +server +location +if в location Разрешает или запрещает сжатие ответа методом gzip. @@ -50,14 +55,19 @@ число размер -32 4k/16 8k -http, server, location +32 4k|16 8k +http +server +location -Директива задаёт число и размер буферов, в которые будет сжиматься ответ. -По умолчанию размер одного буфера равен размеру страницы, в зависимости -от платформы это или 4K, или 8K. +Задаёт число и размер буферов, +в которые будет сжиматься ответ. +По умолчанию размер одного буфера равен размеру страницы. +В зависимости от платформы это или 4K, или 8K. + До версии 0.7.28 по умолчанию использовалось 4 буфера размером 4K или 8K. + @@ -67,7 +77,9 @@ степень 1 -http, server, location +http +server +location Устанавливает степень сжатия ответа методом gzip. @@ -80,17 +92,22 @@ regex ... -http, server, location +http +server +location +0.6.23 -Директива (0.6.23) запрещает сжатие ответа методом gzip для запросов -со строками "User-Agent", совпадающими с заданными регулярными выражениями. +Запрещает сжатие ответа методом gzip для запросов +со строками заголовка
User-Agent
, +совпадающими с заданными регулярными выражениями.
-Специальная маска "msie6" (0.7.12) соответствует -регулярному выражению "MSIE [4-6]\.", но работает быстрее. -Начиная с версии 0.8.11, из этой маски исключается "MSIE 6.0; ... SV1". +Специальная маска “msie6” (0.7.12) соответствует +регулярному выражению “MSIE [4-6]\.”, но работает быстрее. +Начиная с версии 0.8.11, из этой маски исключается +“MSIE 6.0; ... SV1”.
@@ -99,12 +116,14 @@ длина 20 -http, server, location +http +server +location -Устанавливает минимальную длину ответа, для которых -будет выполняться сжатие ответа методом gzip. -Длина определяется только из строки "Content-Length" заголовка ответа. +Устанавливает минимальную длину ответа, который будет сжиматься методом gzip. +Длина определяется только из строки
Content-Length
+заголовка ответа.
@@ -113,10 +132,12 @@ 1.0 | 1.1 1.1 -http, server, location +http +server +location -Устанавливает минимальную версию HTTP запроса для сжатия ответа. +Устанавливает минимальную версию HTTP-запроса, необходимую для сжатия ответа. @@ -135,57 +156,71 @@ any ... off -http, server, location +http +server +location Разрешает или запрещает сжатие ответа методом gzip для проксированных запросов в зависимости от запроса и ответа. -То что, запрос проксированный, определяется на основании строки "Via" +То, что запрос проксированный, определяется на основании строки +
Via
в заголовке запроса. В директиве можно указать одновременно несколько параметров: - + - -off — запрещает сжатие для всех проксированных запросов, +off + +запрещает сжатие для всех проксированных запросов, игнорируя остальные параметры; - + - -expired — разрешить сжатие, если в ответе есть -строка "Expires" со значением, запрещающим кэширование; - +expired + +разрешить сжатие, если в заголовке ответа есть строка +
Expires
со значением, запрещающим кэширование; +
- -no-cache — разрешить сжатие, если в ответе есть -строка "Cache-Control" с параметром "no-cache"; - +no-cache + +разрешить сжатие, если в заголовке ответа есть строка +
Cache-Control
с параметром “no-cache”; +
- -no-store — разрешить сжатие, если в ответе есть -строка "Cache-Control" с параметром "no-store"; - +no-store + +разрешить сжатие, если в заголовке ответа есть строка +
Cache-Control
с параметром “no-store”; +
- -private — разрешить сжатие, если в ответе есть -строка "Cache-Control" с параметром "private"; - +private + +разрешить сжатие, если в заголовке ответа есть строка +
Cache-Control
с параметром “private”; +
- -no_last_modified — разрешить сжатие, если в ответе нет -строки "Last-Modified"; - +no_last_modified + +разрешить сжатие, если в заголовке ответа нет строки +
Last-Modified
; +
- -no_etag — разрешить сжатие, если в ответе нет строки "ETag"; - +no_etag + +разрешить сжатие, если в заголовке ответа нет строки +
ETag
; +
- -auth — разрешить сжатие, если в запросе есть строка "Authorization"; - +auth + +разрешить сжатие, если в заголовке запроса есть строка +
Authorization
; +
- -any — разрешить сжатие для всех проксированных запросов; - +any + +разрешить сжатие для всех проксированных запросов; +
@@ -196,11 +231,14 @@ any — разрешить сжатие для всех проксированных запросов; mime-тип ... text/html -http, server, location +http +server +location Разрешает сжатие ответа методом gzip для указанных MIME-типов в дополнение -к "text/html". "text/html" сжимается всегда. +к “text/html”. +Ответы с типом “text/html” сжимаются всегда. @@ -209,11 +247,13 @@ any — разрешить сжатие для всех проксированных запросов; on | off off -http, server, location +http +server +location Разрешает или запрещает выдавать в ответе строку заголовка -"Vary: Accept-Encoding", если директивы +
Vary: Accept-Encoding
, если директивы или активны. diff --git a/xml/ru/docs/http/ngx_http_gzip_static_module.xml b/xml/ru/docs/http/ngx_http_gzip_static_module.xml --- a/xml/ru/docs/http/ngx_http_gzip_static_module.xml +++ b/xml/ru/docs/http/ngx_http_gzip_static_module.xml @@ -2,44 +2,47 @@ -
-Модуль ngx_http_gzip_static_module позволяет отдавать +Модуль ngx_http_gzip_static_module позволяет отдавать вместо обычного файла предварительно сжатый файл с таким же именем -и с суффиксом ".gz". +и с расширением “.gz”. -По умолчанию модуль не собирается, нужно разрешить его сборку при -конфигурировании параметром --with-http_gzip_static_module. +По умолчанию этот модуль не собирается, его сборку необходимо +разрешить с помощью конфигурационного параметра +--with-http_gzip_static_module.
-
+
- gzip_static on; - gzip_proxied expired no-cache no-store private auth; + gzip_static on; + gzip_proxied expired no-cache no-store private auth;
-
+
on | off off -http, server, location +http +server +location Разрешает или запрещает проверку готового сжатого файла. @@ -51,8 +54,9 @@ -Сжимать файлы можно с помощью программы gzip или совместимой с ней. -Желательно, чтобы время модификации исходного и сжатого файлов совпадали. +Сжимать файлы можно с помощью программы gzip +или совместимой с ней. +Желательно, чтобы дата и время модификации исходного и сжатого файлов совпадали.