Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_sub_module.xml @ 3012:ac4191d05fdf
Fixed link to the server directive in ssl_protocols.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Thu, 14 Sep 2023 21:20:14 +0100 |
parents | eeed494bba51 |
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 |
342 | 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 | 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 | 18 Модуль <literal>ngx_http_sub_module</literal> — это фильтр, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
19 изменяющий в ответе одну заданную строку на другую. |
342 | 20 </para> |
21 | |
22 <para> | |
23 По умолчанию этот модуль не собирается, его сборку необходимо | |
24 разрешить с помощью конфигурационного параметра | |
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 | 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 '<a href="http://127.0.0.1:8080/' '<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 '<img src="http://127.0.0.1:8080/' '<img src="https://$host/'; |
342 | 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 | 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 | 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 | 51 <context>http</context> |
52 <context>server</context> | |
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 | 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 | 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 | 93 <context>http</context> |
94 <context>server</context> | |
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 | 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 | 108 <context>http</context> |
109 <context>server</context> | |
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 | 113 Разрешает замену строк в ответах с указанными MIME-типами |
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> |