Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_sub_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
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> |