annotate xml/ru/docs/http/ngx_http_sub_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 eeed494bba51
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
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
10 <module name="Модуль ngx_http_sub_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_sub_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
2593
eeed494bba51 Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 1807
diff changeset
13 rev="6">
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>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
18 Модуль <literal>ngx_http_sub_module</literal> — это фильтр,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
19 изменяющий в ответе одну заданную строку на другую.
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
20 </para>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
21
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
22 <para>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
23 По умолчанию этот модуль не собирается, его сборку необходимо
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
24 разрешить с помощью конфигурационного параметра
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
25 <literal>--with-http_sub_module</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
30
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
31 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 location / {
1555
2a79b38f640b Sub filter: documented support of multiple strings to replace.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1554
diff changeset
36 sub_filter '&lt;a href="http://127.0.0.1:8080/' '&lt;a href="https://$host/';
2a79b38f640b Sub filter: documented support of multiple strings to replace.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1554
diff changeset
37 sub_filter '&lt;img src="http://127.0.0.1:8080/' '&lt;img src="https://$host/';
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
38 sub_filter_once on;
76
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 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41 </para>
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 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
46 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48 <directive name="sub_filter">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
49 <syntax><value>строка</value> <value>замена</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
50 <default/>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
51 <context>http</context>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
52 <context>server</context>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
53 <context>location</context>
76
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 <para>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
56 Задаёт строку, которую нужно заменить, и строку замены.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
57 Заменяемая строка проверяется без учёта регистра.
1554
80aba0439f7d Sub filter: documented variables support in strings to replace.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
58 В заменяемой строке (1.9.4) и в строке замены можно использовать переменные.
2593
eeed494bba51 Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 1807
diff changeset
59 На одном уровне конфигурации может
1555
2a79b38f640b Sub filter: documented support of multiple strings to replace.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1554
diff changeset
60 быть указано несколько директив <literal>sub_filter</literal> (1.9.4).
2593
eeed494bba51 Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 1807
diff changeset
61 Директивы наследуются с предыдущего уровня конфигурации при условии, что
1807
dc1e51247404 Described inheritance model for sub_filter.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1555
diff changeset
62 на данном уровне не описаны свои директивы <literal>sub_filter</literal>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67
920
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
68 <directive name="sub_filter_last_modified">
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
69 <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: 589
diff changeset
70 <default>off</default>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
71 <context>http</context>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
72 <context>server</context>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
73 <context>location</context>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
74 <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: 589
diff changeset
75
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
76 <para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
77 Позволяет сохранить поле заголовка <header>Last-Modified</header>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
78 исходного ответа во время замены
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
79 для лучшего кэширования ответов.
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
80 </para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
81
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
82 <para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
83 По умолчанию поле заголовка удаляется, так как содержимое ответа
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
84 изменяется во время обработки.
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
85 </para>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
86
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
87 </directive>
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
88
7afb12159c1d Translated documentation on ssi/sub_filter/xslt_last_modified into Russian.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
89
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 <directive name="sub_filter_once">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
91 <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: 99
diff changeset
92 <default>on</default>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
93 <context>http</context>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
94 <context>server</context>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
95 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97 <para>
1555
2a79b38f640b Sub filter: documented support of multiple strings to replace.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1554
diff changeset
98 Определяет, сколько раз нужно искать каждую из заменяемых строк:
2a79b38f640b Sub filter: documented support of multiple strings to replace.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1554
diff changeset
99 один раз или многократно.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
100 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
101
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
102 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105 <directive name="sub_filter_types">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
106 <syntax><value>mime-тип</value> ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
107 <default>text/html</default>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
108 <context>http</context>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
109 <context>server</context>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
110 <context>location</context>
76
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 <para>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
113 Разрешает замену строк в ответах с указанными MIME-типами
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
114 в дополнение к “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 342
diff changeset
115 Специальное значение “<literal>*</literal>” соответствует любому MIME-типу
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 342
diff changeset
116 (0.8.29).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
117 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
118
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
121 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
123 </module>