annotate xml/ru/docs/http/ngx_http_ssi_module.xml @ 546:694db9597ee0

Documented the special value "*" in various "*_type" directives.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 21 Jun 2012 21:29:00 +0000
parents 8548b80a4552
children be54c443235a
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
4
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
5 <module name="Модуль ngx_http_ssi_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
6 link="/ru/docs/http/ngx_http_ssi_module.html"
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
7 lang="ru">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
9 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
10
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
12 Модуль <literal>ngx_http_ssi_module</literal> — это фильтр,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
13 обрабатывающий команды SSI (Server Side Includes) в проходящих
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
14 через него ответах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
15 На данный момент список поддерживаемых команд SSI неполон.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
18 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
19
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
20
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
21 <section id="example" name="Пример конфигурации">
76
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 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
25 location / {
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
26 ssi on;
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
27 ...
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
28 }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
30 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
35 <section id="directives" name="Директивы">
76
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 <directive name="ssi">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
38 <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: 76
diff changeset
39 <default>off</default>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
40 <context>http</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
41 <context>server</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
42 <context>location</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
43 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
46 Разрешает или запрещает обработку команд SSI в ответах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 <directive name="ssi_silent_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
53 <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: 76
diff changeset
54 <default>off</default>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
55 <context>http</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
56 <context>server</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
57 <context>location</context>
76
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 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
60 Разрешает не выводить строку
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
61 “<literal>[an error occurred while processing the directive]</literal>”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
62 если во время обработки SSI произошла ошибка.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68 <directive name="ssi_types">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
69 <syntax><value>mime-тип</value> ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
70 <default>text/html</default>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
71 <context>http</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
72 <context>server</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
73 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
74
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
76 Разрешает обработку команд SSI в ответах с указанными MIME-типами
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
77 в дополнение к “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 398
diff changeset
78 Специальное значение “<literal>*</literal>” соответствует любому MIME-типу
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 398
diff changeset
79 (0.8.29).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80 </para>
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
84 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
85
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
87 <section id="commands" name="Команды SSI">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
89 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
90 Общий формат команд SSI такой:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
92 &lt;!--# команда параметр1=значение1 параметр2=значение2 ... --&gt;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
94 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
97 Поддерживаются следующие команды:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
98 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
99
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
100 <tag-name><literal>block</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
101 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
102 Описывает блок, который можно использовать
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
103 как заглушку в команде <literal>include</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
104 Внутри блока могут быть другие команды SSI.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
105 Параметр команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
107 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
108 <tag-name><literal>name</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
109 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
110 имя блока.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
111 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
112 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
113
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
114 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
115 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
116 &lt;!--# block name="one" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
117 заглушка
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
118 &lt;!--# endblock --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
121 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
123
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
124 <tag-name><literal>config</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
125 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
126 Задаёт некоторые параметры, используемые при обработке SSI, а именно:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
127
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
128 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
129 <tag-name><literal>errmsg</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
130 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
131 строка, выводящаяся при ошибке во время обработки SSI.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
132 По умолчанию выводится такая строка:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
133 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
134 [an error occurred while processing the directive]
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
136 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
137
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
138 <tag-name><literal>timefmt</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
139 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
140 строка формата, передаваемая функции <c-func>strftime</c-func>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
141 для вывода даты и времени.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
142 По умолчанию используется такой формат:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144 "%A, %d-%b-%Y %H:%M:%S %Z"
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
145 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
146 Для вывода времени в секундах подходит формат
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
147 “<literal>%s</literal>”.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
148 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
151 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
152
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
153
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
154 <tag-name><literal>echo</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
155 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
156 Выводит значение переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
157 Параметры команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
159 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
160 <tag-name><literal>var</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
161 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
162 имя переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
163 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
165 <tag-name><literal>encoding</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
166 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
167 способ кодирования.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
168 Возможны три значения — <literal>none</literal>, <literal>url</literal> и
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
169 <literal>entity</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
170 По умолчанию используется <literal>entity</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
171 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
172
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
173 <tag-name><literal>default</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
174 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
175 нестандартный параметр, задающий строку, которая выводится,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
176 если переменная не определена.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
177 По умолчанию выводится строка
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
178 “<literal>none</literal>”.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
179 Команда
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
181 &lt;!--# echo var="name" default="<emphasis>нет</emphasis>" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
182 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
183 заменяет такую последовательность команд:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
184 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
185 &lt;!--# if expr="$name" --&gt;&lt;!--# echo var="name" --&gt;&lt;!--#
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
186 else --&gt;<emphasis>нет</emphasis>&lt;!--# endif --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
187 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
188 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
189 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
190
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
191 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
193
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
194 <tag-name><literal>if</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
195 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
196 Выполняет условное включение.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
197 Поддерживаются следующие команды:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
198 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199 &lt;!--# if expr="..." --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
200 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
201 &lt;!--# elif expr="..." --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
202 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
203 &lt;!--# else --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
204 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205 &lt;!--# endif --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
207 На данный момент поддерживается только один уровень вложенности.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
208 Параметр команды:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
209
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
210 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
211 <tag-name><literal>expr</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
212 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
213 выражение.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
214 В выражении может быть:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
215
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
216 <list type="bullet">
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
217
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218 <listitem>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
219 проверка существования переменной:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
220 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
221 &lt;!--# if expr="$name" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
222 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
223 </listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
224
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
225 <listitem>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
226 сравнение переменной с текстом:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
227 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
228 &lt;!--# if expr="$name = <value>text</value>" --&gt;
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
229 &lt;!--# if expr="$name != <value>text</value>" --&gt;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
230 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
231 </listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
232
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
233 <listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
234 сравнение переменной с регулярным выражением:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
236 &lt;!--# if expr="$name = /<value>text</value>/" --&gt;
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
237 &lt;!--# if expr="$name != /<value>text</value>/" --&gt;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
238 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
239 </listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
240 </list>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
241
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
242 Если в <value>text</value> встречаются переменные,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
243 то производится подстановка их значений.
290
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
244 В регулярном выражении можно задать позиционные и именованные выделения,
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
245 а затем использовать их через переменные, например:
290
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
246 <example>
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
247 &lt;!--# if expr="$name = /(.+)@(?P&lt;domain&gt;.+)/" --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
248 &lt;!--# echo var="1" --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
249 &lt;!--# echo var="domain" --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
250 &lt;!--# endif --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
251 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
252 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
253 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
254
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
255 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
256
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
257
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
258 <tag-name><literal>include</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
259 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
260 Включает в ответ результат другого запроса.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
261 Параметры команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
262
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
263 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
264 <tag-name><literal>file</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
265 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
266 задаёт включаемый файл, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
267 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
268 &lt;!--# include file="footer.html" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
269 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
270 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
271
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
272 <tag-name><literal>virtual</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
273 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
274 задаёт включаемый запрос, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
275 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
276 &lt;!--# include virtual="/remote/body.php?argument=value" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
277 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
278 Несколько запросов, указанных на одной странице и обрабатываемых
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
279 проксируемыми или FastCGI-серверами, работают параллельно.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
280 Если нужна последовательная обработка, следует воспользоваться параметром
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
281 <literal>wait</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
282 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
283
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
284 <tag-name><literal>stub</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
285 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
286 нестандартный параметр, задающий имя блока,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
287 содержимое которого будет выведено, если тело ответа на включаемый запрос
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
288 пустое или если при исполнении запроса произошла ошибка, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
289 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
290 &lt;!--# block name="one" --&gt;&amp;nbsp;&lt;!--# endblock --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
291 &lt;!--# include virtual="/remote/body.php?argument=value" stub="one" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
292 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
293 Содержимое замещающего блока обрабатывается в контексте включаемого запроса.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
294 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
295
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
296 <tag-name><literal>wait</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
297 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
298 нестандартный параметр, указывающий, нужно ли ждать
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
299 полного исполнения данного запроса, прежде чем продолжать выполнение
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
300 SSI, например:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
301 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
302 &lt;!--# include virtual="/remote/body.php?argument=value" wait="yes" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
303 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
304 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
305
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
306 <tag-name><literal>set</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
307 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
308 нестандартный параметр, указывающий, что удачный
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
309 результат выполнения запроса нужно записать в заданную переменную,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
310 например:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
311 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312 &lt;!--# include virtual="/remote/body.php?argument=value" set="one" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
314 Необходимо учитывать, что в переменные можно записать только результаты
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
315 ответов, полученные через модули
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
316 <link doc="ngx_http_proxy_module.xml">ngx_http_proxy_module</link> и
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
317 <link doc="ngx_http_memcached_module.xml">ngx_http_memcached_module</link>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
318 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
319
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
320 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
321
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
322 </tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
323
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
324
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
325 <tag-name><literal>set</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
326 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
327 Присваивает значение переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
328 Параметры команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
329
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
330 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
331 <tag-name><literal>var</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
332 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
333 имя переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
334 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
336 <tag-name><literal>value</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
337 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
338 значение переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
339 Если в присваиваемом значении есть переменные,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
340 то производится подстановка их значений.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
341 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
342 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
343
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
344 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
345
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
346 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
347 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
348
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
349 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
350
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
351
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
352 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
353
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
354 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
355 Модуль <literal>ngx_http_ssi_module</literal> поддерживает
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
356 две встроенные переменные:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
357 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
358
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
359 <tag-name><var>$date_local</var></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
360 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
361 текущее время в локальной временной зоне.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
362 Формат задаётся командой <literal>config</literal>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
363 с параметром <literal>timefmt</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
364 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
365
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
366 <tag-name><var>$date_gmt</var></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
367 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
368 текущее время в GMT.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
369 Формат задаётся командой <literal>config</literal>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
370 с параметром <literal>timefmt</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
371 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
372
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
373 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
374 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
375
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
376 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
377
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
378 </module>