Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_headers_module.xml @ 353:7b6155ac373b
Revised the Russian version of ngx_http_headers_module and translated
it into English.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Wed, 25 Jan 2012 13:22:09 +0000 |
parents | 4c6d2c614d2c |
children | bb51d3e17dd0 |
comparison
equal
deleted
inserted
replaced
352:d0c9b9e436d4 | 353:7b6155ac373b |
---|---|
1 <?xml version="1.0"?> | 1 <?xml version="1.0"?> |
2 | 2 |
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4 | 4 |
5 <module name="Директивы модуля ngx_http_headers_module" | 5 <module name="Модуль ngx_http_headers_module" |
6 link="/ru/docs/http/ngx_http_headers_module.html" | 6 link="/ru/docs/http/ngx_http_headers_module.html" |
7 lang="ru"> | 7 lang="ru"> |
8 | 8 |
9 <section id="summary"> | 9 <section id="summary"> |
10 | 10 |
11 <para> | 11 <para> |
12 Модуль ngx_http_headers_module позволяет выдавать строки "Expires" | 12 Модуль <literal>ngx_http_headers_module</literal> позволяет выдавать |
13 и "Cache-Control" и добавлять произвольные строки в заголовке ответа. | 13 поля заголовка <header>Expires</header> и <header>Cache-Control</header>, |
14 а также добавлять произвольные поля в заголовок ответа. | |
14 </para> | 15 </para> |
15 | 16 |
16 </section> | 17 </section> |
17 | 18 |
18 <section name="Примеры конфигурации" id="example"> | 19 <section id="example" name="Пример конфигурации"> |
19 | 20 |
20 <para> | 21 <para> |
21 <example> | 22 <example> |
22 expires 24h; | 23 expires 24h; |
23 expires modified +24h; | 24 expires modified +24h; |
24 expires @24h; | 25 expires @24h; |
25 expires 0; | 26 expires 0; |
26 expires -1; | 27 expires -1; |
27 expires epoch; | 28 expires epoch; |
28 add_header Cache-Control private; | 29 add_header Cache-Control private; |
29 </example> | 30 </example> |
30 </para> | 31 </para> |
31 | 32 |
32 </section> | 33 </section> |
33 | 34 |
34 | 35 |
35 <section name="Директивы" id="directives"> | 36 <section id="directives" name="Директивы"> |
36 | 37 |
37 <directive name="add_header"> | 38 <directive name="add_header"> |
38 <syntax><value>название</value> <value>значение</value></syntax> | 39 <syntax><value>имя</value> <value>значение</value></syntax> |
39 <default/> | 40 <default/> |
40 <context>http, server, location</context> | 41 <context>http</context> |
42 <context>server</context> | |
43 <context>location</context> | |
41 | 44 |
42 <para> | 45 <para> |
43 Директива добавляет строку в заголовке ответа при условии, что код ответа | 46 Добавляет указанное поле в заголовок ответа при условии, что код ответа |
44 равен 200, 204, 301, 302 или 304. | 47 равен 200, 204, 301, 302 или 304. |
45 В значении можно использовать переменные. | 48 В значении можно использовать переменные. |
46 </para> | 49 </para> |
47 | 50 |
48 </directive> | 51 </directive> |
49 | 52 |
50 | 53 |
51 <directive name="expires"> | 54 <directive name="expires"> |
52 <syntax>[<literal>modified</literal>] <value>время</value></syntax> | 55 <syntax>[<literal>modified</literal>] <value>время</value></syntax> |
53 <syntax> | 56 <syntax> |
54 <literal>epoch</literal> | | 57 <literal>epoch</literal> | |
55 <literal>max</literal> | | 58 <literal>max</literal> | |
56 <literal>off</literal></syntax> | 59 <literal>off</literal></syntax> |
57 <default>off</default> | 60 <default>off</default> |
58 <context>http, server, location</context> | 61 <context>http</context> |
62 <context>server</context> | |
63 <context>location</context> | |
59 | 64 |
60 <para> | 65 <para> |
61 Разрешает или запрещает добавлять или менять строки "Expires" | 66 Разрешает или запрещает добавлять или менять поля <header>Expires</header> |
62 и "Cache-Control" в заголовке ответа. | 67 и <header>Cache-Control</header> в заголовке ответа. |
63 В качестве параметра можно задать положительное или отрицательное | 68 В качестве параметра можно задать положительное или отрицательное |
64 <link doc="../syntax.xml">время</link>. | 69 <link doc="../syntax.xml">время</link>. |
65 </para> | 70 </para> |
66 | 71 |
67 <para> | 72 <para> |
68 Время в строке "Expires" получается как сумма текущего времени | 73 Время в поле <header>Expires</header> получается как сумма текущего времени |
69 и времени, заданного в директиве. | 74 и времени, заданного в директиве. |
70 Если используется параметр "modified" (0.7.0, 0.6.32), | 75 Если используется параметр <literal>modified</literal> (0.7.0, 0.6.32), |
71 то время получается как сумма | 76 то время получается как сумма |
72 времени модификации файла и времени, заданного в директиве. | 77 времени модификации файла и времени, заданного в директиве. |
73 </para> | 78 </para> |
74 | 79 |
75 <para> | 80 <para> |
76 Кроме того, с помощью префикса "@" можно задать время суток (0.7.9, 0.6.34): | 81 Кроме того, с помощью префикса “<literal>@</literal>” можно задать |
82 время суток (0.7.9, 0.6.34): | |
77 <example> | 83 <example> |
78 expires @15h30m; | 84 expires @15h30m; |
79 </example> | 85 </example> |
80 </para> | 86 </para> |
81 | 87 |
82 <para> | 88 <para> |
83 Параметр "epoch" означает абсолютное время 1 января 1970 года 00:00:01 GMT. | 89 Параметр <literal>epoch</literal> соответствует абсолютному времени |
84 Содержимое строки "Cache-Control" зависит от знака заданного времени: | 90 “<literal>Thu, 01 Jan 1970 00:00:01 GMT</literal>” |
91 (1 января 1970 года 00:00:01 GMT). | |
92 Содержимое поля <header>Cache-Control</header> зависит от знака | |
93 заданного времени: | |
85 <list type="bullet"> | 94 <list type="bullet"> |
86 | 95 |
87 <listitem> | 96 <listitem> |
88 отрицательное время — "Cache-Control: no-cache". | 97 отрицательное время — <header>Cache-Control: no-cache</header>. |
89 </listitem> | 98 </listitem> |
90 | 99 |
91 <listitem> | 100 <listitem> |
92 положительное время или равное нулю — "Cache-Control: max-age=#", | 101 положительное или равное нулю время — |
93 где "#" - это время в секундах, заданное в директиве. | 102 <header>Cache-Control: max-age=<value>t</value></header>, |
103 где <value>t</value> это время в секундах, заданное в директиве. | |
94 </listitem> | 104 </listitem> |
95 | 105 |
96 </list> | 106 </list> |
97 </para> | 107 </para> |
98 | 108 |
99 <para> | 109 <para> |
100 Параметр "max" задаёт время 31 декабря 2037 23:55:55 GMT для строки "Expires" | 110 Параметр <literal>max</literal> задаёт время |
101 и 10 лет для строки "Cache-Control". | 111 “<literal>Thu, 31 Dec 2037 23:55:55 GMT</literal>” |
112 (31 декабря 2037 23:55:55 GMT) для поля <header>Expires</header> | |
113 и 10 лет для поля <header>Cache-Control</header>. | |
102 </para> | 114 </para> |
103 | 115 |
104 <para> | 116 <para> |
105 Параметр "off" запрещает добавлять или менять строки "Expires" | 117 Параметр <literal>off</literal> запрещает добавлять или менять поля |
106 и "Cache-Control" в заголовке ответа. | 118 <header>Expires</header> и <header>Cache-Control</header> в заголовке ответа. |
107 </para> | 119 </para> |
108 | 120 |
109 </directive> | 121 </directive> |
110 | 122 |
111 </section> | 123 </section> |