nginx-site: xml/ru/docs/http/ngx_http_ssi

annotate xml/ru/docs/http/ngx_http_ssi_module.xml @ 2769:16f6fa718be2

Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.

author	Sergey Kandaurov <pluknet@nginx.com>
date	Thu, 30 Sep 2021 16:29:20 +0300
parents	5cacd6fffade
children

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 <!--# команда параметр1=значение1 параметр2=значение2 ... -->
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 <!--# block name="one" -->
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 <!--# endblock -->
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 <!--# echo var="name" default="<emphasis>нет</emphasis>" -->
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 <!--# if expr="$name" --><!--# echo var="name" --><!--#
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	245 else --><emphasis>нет</emphasis><!--# endif -->
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 <!--# if expr="..." -->
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 <!--# elif expr="..." -->
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 <!--# else -->
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 <!--# endif -->
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 <!--# if expr="$name" -->
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 <!--# if expr="$name = <value>text</value>" -->
8548b80a4552 Revision. Ruslan Ermilov <ru@nginx.com> parents: 290 diff changeset	288 <!--# if expr="$name != <value>text</value>" -->
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 <!--# if expr="$name = /<value>text</value>/" -->
8548b80a4552 Revision. Ruslan Ermilov <ru@nginx.com> parents: 290 diff changeset	296 <!--# if expr="$name != /<value>text</value>/" -->
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 <!--# if expr="$name = /(.+)@(?P<domain>.+)/" -->
15f81ed48a43 Documented regex captures in the "if" SSI command. Valentin Bartenev <vbart@nginx.com> parents: 285 diff changeset	307 <!--# echo var="1" -->
15f81ed48a43 Documented regex captures in the "if" SSI command. Valentin Bartenev <vbart@nginx.com> parents: 285 diff changeset	308 <!--# echo var="domain" -->
15f81ed48a43 Documented regex captures in the "if" SSI command. Valentin Bartenev <vbart@nginx.com> parents: 285 diff changeset	309 <!--# endif -->
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 <!--# include file="footer.html" -->
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 <!--# include virtual="/remote/body.php?argument=value" -->
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 <!--# block name="one" -->&nbsp;<!--# endblock -->
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	350 <!--# include virtual="/remote/body.php?argument=value" stub="one" -->
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 <!--# include virtual="/remote/body.php?argument=value" wait="yes" -->
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 <!--# include virtual="/remote/body.php?argument=value" set="one" -->
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>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_ssi_module.xml @ 2769:16f6fa718be2