annotate xml/ru/docs/http/ngx_http_ssi_module.xml @ 2965:23eedf89fd5d

Updated QUIC documentation after QUIC code merge. - removed http3_max_concurrent_pushes, http3_push http3_push_preload, quic_mtu - updated apperared-in version - update of quic.xml, adding Rus translation
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 23 May 2023 16:44:47 +0100
parents 5cacd6fffade
children
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
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
10 <module name="Модуль ngx_http_ssi_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_ssi_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
2206
5cacd6fffade Eliminated some examples of unsafe prefix locations.
Ruslan Ermilov <ru@nginx.com>
parents: 2134
diff changeset
13 rev="12">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
18 Модуль <literal>ngx_http_ssi_module</literal> — это фильтр,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
19 обрабатывающий команды SSI (Server Side Includes) в проходящих
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
20 через него ответах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21 На данный момент список поддерживаемых команд SSI неполон.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
23
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
25
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
27 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
30 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
31 location / {
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
32 ssi on;
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
33 ...
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
34 }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
41 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 <directive name="ssi">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
44 <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
45 <default>off</default>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
46 <context>http</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
47 <context>server</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
48 <context>location</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
49 <context>if в location</context>
76
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 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
52 Разрешает или запрещает обработку команд SSI в ответах.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
54
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
55 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
56
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
57
920
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
58 <directive name="ssi_last_modified">
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
59 <syntax><literal>on</literal> | <literal>off</literal></syntax>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
60 <default>off</default>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
61 <context>http</context>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
62 <context>server</context>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
63 <context>location</context>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
64 <appeared-in>1.5.1</appeared-in>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
65
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
66 <para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
67 Позволяет сохранить поле заголовка <header>Last-Modified</header>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
68 исходного ответа во время обработки SSI
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
69 для лучшего кэширования ответов.
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
70 </para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
71
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
72 <para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
73 По умолчанию поле заголовка удаляется, так как содержимое ответа
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
74 изменяется во время обработки и может содержать динамически созданные
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
75 элементы или части, которые изменились независимо от исходного ответа.
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
76 </para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
77
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
78 </directive>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
79
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 726
diff changeset
80
725
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
81 <directive name="ssi_min_file_chunk">
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
82 <syntax><literal>размер</literal></syntax>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
83 <default>1k</default>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
84 <context>http</context>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
85 <context>server</context>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
86 <context>location</context>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
87
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
88 <para>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
89 Задаёт минимальный <value>размер</value> частей ответа, хранящихся
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
90 на диске, начиная с которого имеет смысл посылать их с помощью
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
91 <link doc="ngx_http_core_module.xml" id="sendfile"/>.
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
92 </para>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
93
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
94 </directive>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
95
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
96
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97 <directive name="ssi_silent_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
98 <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
99 <default>off</default>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
100 <context>http</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
101 <context>server</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
102 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
105 Разрешает не выводить строку
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
106 “<literal>[an error occurred while processing the directive]</literal>”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
107 если во время обработки SSI произошла ошибка.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
109
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
111
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
112
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
113 <directive name="ssi_types">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
114 <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
115 <default>text/html</default>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
116 <context>http</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
117 <context>server</context>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
118 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
121 Разрешает обработку команд SSI в ответах с указанными MIME-типами
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
122 в дополнение к “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 398
diff changeset
123 Специальное значение “<literal>*</literal>” соответствует любому MIME-типу
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 398
diff changeset
124 (0.8.29).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
125 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
126
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
127 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
128
725
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
129
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
130 <directive name="ssi_value_length">
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
131 <syntax><value>длина</value></syntax>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
132 <default>256</default>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
133 <context>http</context>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
134 <context>server</context>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
135 <context>location</context>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
136
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
137 <para>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
138 Задаёт максимальную длину значений параметров в SSI-командах.
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
139 </para>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
140
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
141 </directive>
64085bf227f6 Documented 'min_file_chunk' and 'value_length' SSI module directives.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
142
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
145
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
146 <section id="commands" name="Команды SSI">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
147
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
149 Общий формат команд SSI такой:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
151 &lt;!--# команда параметр1=значение1 параметр2=значение2 ... --&gt;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
152 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
153 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
156 Поддерживаются следующие команды:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
157 <list type="tag">
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 <tag-name><literal>block</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
160 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
161 Описывает блок, который можно использовать
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
162 как заглушку в команде <literal>include</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
163 Внутри блока могут быть другие команды SSI.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
164 Параметр команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
165
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
166 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
167 <tag-name><literal>name</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
168 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
169 имя блока.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
170 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 </list>
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 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175 &lt;!--# block name="one" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176 заглушка
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
177 &lt;!--# endblock --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
178 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
179
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
180 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
181
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
182
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
183 <tag-name><literal>config</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
184 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
185 Задаёт некоторые параметры, используемые при обработке SSI, а именно:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
186
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
187 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
188 <tag-name><literal>errmsg</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
189 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
190 строка, выводящаяся при ошибке во время обработки SSI.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
191 По умолчанию выводится такая строка:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
193 [an error occurred while processing the directive]
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
195 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
196
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
197 <tag-name><literal>timefmt</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
198 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
199 строка формата, передаваемая функции <c-func>strftime</c-func>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
200 для вывода даты и времени.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
201 По умолчанию используется такой формат:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
202 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
203 "%A, %d-%b-%Y %H:%M:%S %Z"
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
204 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
205 Для вывода времени в секундах подходит формат
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
206 “<literal>%s</literal>”.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
207 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
208 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
209
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
210 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
212
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
213 <tag-name><literal>echo</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
214 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
215 Выводит значение переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
216 Параметры команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
218 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
219 <tag-name><literal>var</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
220 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
221 имя переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
222 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
224 <tag-name><literal>encoding</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
225 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
226 способ кодирования.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
227 Возможны три значения — <literal>none</literal>, <literal>url</literal> и
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
228 <literal>entity</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
229 По умолчанию используется <literal>entity</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
230 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
231
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
232 <tag-name><literal>default</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
233 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
234 нестандартный параметр, задающий строку, которая выводится,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
235 если переменная не определена.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
236 По умолчанию выводится строка
1875
4687cbd3c933 SSI: corrected how "echo var" outputs undefined variables.
Ruslan Ermilov <ru@nginx.com>
parents: 1194
diff changeset
237 “<literal>(none)</literal>”.
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
238 Команда
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
239 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
240 &lt;!--# echo var="name" default="<emphasis>нет</emphasis>" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
241 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
242 заменяет такую последовательность команд:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244 &lt;!--# if expr="$name" --&gt;&lt;!--# echo var="name" --&gt;&lt;!--#
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
245 else --&gt;<emphasis>нет</emphasis>&lt;!--# endif --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
246 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
247 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
248 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
250 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
251
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
252
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
253 <tag-name><literal>if</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
254 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
255 Выполняет условное включение.
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 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
258 &lt;!--# if expr="..." --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
259 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
260 &lt;!--# elif expr="..." --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
261 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
262 &lt;!--# else --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
263 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
264 &lt;!--# endif --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
265 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
266 На данный момент поддерживается только один уровень вложенности.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
267 Параметр команды:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
268
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
269 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
270 <tag-name><literal>expr</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
271 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
272 выражение.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
273 В выражении может быть:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
274
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
275 <list type="bullet">
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
276
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
277 <listitem>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
278 проверка существования переменной:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
279 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
280 &lt;!--# if expr="$name" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
281 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
282 </listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
283
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
284 <listitem>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
285 сравнение переменной с текстом:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
286 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
287 &lt;!--# if expr="$name = <value>text</value>" --&gt;
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
288 &lt;!--# if expr="$name != <value>text</value>" --&gt;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
289 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
290 </listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
291
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
292 <listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
293 сравнение переменной с регулярным выражением:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
294 <example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
295 &lt;!--# if expr="$name = /<value>text</value>/" --&gt;
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
296 &lt;!--# if expr="$name != /<value>text</value>/" --&gt;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
297 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
298 </listitem>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
299 </list>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
300
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
301 Если в <value>text</value> встречаются переменные,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
302 то производится подстановка их значений.
290
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
303 В регулярном выражении можно задать позиционные и именованные выделения,
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
304 а затем использовать их через переменные, например:
290
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
305 <example>
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
306 &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
307 &lt;!--# echo var="1" --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
308 &lt;!--# echo var="domain" --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
309 &lt;!--# endif --&gt;
15f81ed48a43 Documented regex captures in the "if" SSI command.
Valentin Bartenev <vbart@nginx.com>
parents: 285
diff changeset
310 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
311 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
314 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
315
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
316
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
317 <tag-name><literal>include</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
318 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
319 Включает в ответ результат другого запроса.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
320 Параметры команды:
76
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 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
323 <tag-name><literal>file</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
324 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
325 задаёт включаемый файл, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
326 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
327 &lt;!--# include file="footer.html" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
328 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
329 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
330
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
331 <tag-name><literal>virtual</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 задаёт включаемый запрос, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
334 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335 &lt;!--# include virtual="/remote/body.php?argument=value" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
336 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
337 Несколько запросов, указанных на одной странице и обрабатываемых
2134
4cafd82e5007 Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2122
diff changeset
338 проксируемыми или FastCGI/uwsgi/SCGI/gRPC-серверами, работают параллельно.
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
339 Если нужна последовательная обработка, следует воспользоваться параметром
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
340 <literal>wait</literal>.
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
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
343 <tag-name><literal>stub</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
344 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
345 нестандартный параметр, задающий имя блока,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
346 содержимое которого будет выведено, если тело ответа на включаемый запрос
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
347 пустое или если при исполнении запроса произошла ошибка, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
348 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
349 &lt;!--# block name="one" --&gt;&amp;nbsp;&lt;!--# endblock --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
350 &lt;!--# include virtual="/remote/body.php?argument=value" stub="one" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
351 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
352 Содержимое замещающего блока обрабатывается в контексте включаемого запроса.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
353 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
354
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
355 <tag-name><literal>wait</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
356 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
357 нестандартный параметр, указывающий, нужно ли ждать
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
358 полного исполнения данного запроса, прежде чем продолжать выполнение
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
359 SSI, например:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
360 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
361 &lt;!--# include virtual="/remote/body.php?argument=value" wait="yes" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
362 </example>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
363 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
364
2118
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
365 <tag-name id="ssi_include_set"><literal>set</literal></tag-name>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
366 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
367 нестандартный параметр, указывающий, что удачный
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
368 результат выполнения запроса нужно записать в заданную переменную,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
369 например:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
370 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
371 &lt;!--# include virtual="/remote/body.php?argument=value" set="one" --&gt;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
372 </example>
2122
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
373 Максимальный размер ответа задаётся директивой
2118
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
374 <link doc="ngx_http_core_module.xml" id="subrequest_output_buffer_size"/>
2122
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
375 (1.13.10):
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
376 <example>
2206
5cacd6fffade Eliminated some examples of unsafe prefix locations.
Ruslan Ermilov <ru@nginx.com>
parents: 2134
diff changeset
377 location /remote/ {
2122
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
378 subrequest_output_buffer_size 64k;
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
379 ...
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
380 }
86a73b6f32f2 Added example to ssi include set.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2118
diff changeset
381 </example>
2118
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
382 До версии 1.13.10 в переменные можно было записать только результаты
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
383 ответов, полученные через модули
994
f09f77ef45e9 Documented extended support of SSI "include virtual= set=".
Ruslan Ermilov <ru@nginx.com>
parents: 920
diff changeset
384 <link doc="ngx_http_proxy_module.xml">ngx_http_proxy_module</link>,
f09f77ef45e9 Documented extended support of SSI "include virtual= set=".
Ruslan Ermilov <ru@nginx.com>
parents: 920
diff changeset
385 <link doc="ngx_http_memcached_module.xml">ngx_http_memcached_module</link>,
f09f77ef45e9 Documented extended support of SSI "include virtual= set=".
Ruslan Ermilov <ru@nginx.com>
parents: 920
diff changeset
386 <link doc="ngx_http_fastcgi_module.xml">ngx_http_fastcgi_module</link> (1.5.6),
f09f77ef45e9 Documented extended support of SSI "include virtual= set=".
Ruslan Ermilov <ru@nginx.com>
parents: 920
diff changeset
387 <link doc="ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link> (1.5.6)
f09f77ef45e9 Documented extended support of SSI "include virtual= set=".
Ruslan Ermilov <ru@nginx.com>
parents: 920
diff changeset
388 и <link doc="ngx_http_scgi_module.xml">ngx_http_scgi_module</link> (1.5.6).
2118
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
389 Максимальный размер ответа задавался при помощи директив
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
390 <link doc="ngx_http_proxy_module.xml" id="proxy_buffer_size"/>,
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
391 <link doc="ngx_http_memcached_module.xml" id="memcached_buffer_size"/>,
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
392 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_buffer_size"/>,
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
393 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_buffer_size"/>
0b3103eabdf1 Documented the "subrequest_output_buffer_size" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1875
diff changeset
394 и <link doc="ngx_http_scgi_module.xml" id="scgi_buffer_size"/>.
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
395 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
396
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
397 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
398
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
399 </tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
400
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
401
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
402 <tag-name><literal>set</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
403 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
404 Присваивает значение переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
405 Параметры команды:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
406
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
407 <list type="tag">
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
408 <tag-name><literal>var</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
409 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
410 имя переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
411 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
412
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
413 <tag-name><literal>value</literal></tag-name>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
414 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
415 значение переменной.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
416 Если в присваиваемом значении есть переменные,
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
417 то производится подстановка их значений.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
418 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
419 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
420
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
421 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
422
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
423 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
424 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
425
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
426 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
427
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
428
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
429 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
430
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
431 <para>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
432 Модуль <literal>ngx_http_ssi_module</literal> поддерживает
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
433 две встроенные переменные:
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
434 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
435
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 994
diff changeset
436 <tag-name id="var_date_local"><var>$date_local</var></tag-name>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
437 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
438 текущее время в локальной временной зоне.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
439 Формат задаётся командой <literal>config</literal>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
440 с параметром <literal>timefmt</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
441 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
442
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 994
diff changeset
443 <tag-name id="var_date_gmt"><var>$date_gmt</var></tag-name>
398
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
444 <tag-desc>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
445 текущее время в GMT.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
446 Формат задаётся командой <literal>config</literal>
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
447 с параметром <literal>timefmt</literal>.
8548b80a4552 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 290
diff changeset
448 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
449
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
450 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
451 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
452
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
453 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
454
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
455 </module>