Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_charset_module.xml @ 2675:893cd7724c8c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "r" argument for js_body_filter.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 09 Mar 2021 18:44:56 +0000
parents 4cafd82e5007
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: 206
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
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
10 <module name="Модуль ngx_http_charset_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_charset_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
2134
4cafd82e5007 Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1194
diff changeset
13 rev="5">
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: 108
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>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
18 Модуль <literal>ngx_http_charset_module</literal> добавляет указанную
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
19 кодировку в поле <header>Content-Type</header> заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
20 Кроме того, модуль может перекодировать данные из одной кодировки в другую
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21 с некоторыми ограничениями:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 <list type="bullet">
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 <listitem>
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 </listitem>
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 <listitem>
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 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33 или однобайтные кодировки в UTF-8 и обратно.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
42 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 349
diff changeset
46 include conf/koi-win;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 349
diff changeset
48 charset windows-1251;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 349
diff changeset
49 source_charset koi8-r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 </section>
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
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
56 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
57
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
58 <directive name="charset">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
59 <syntax><value>кодировка</value> | <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
60 <default>off</default>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
61 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
62 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
63 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
64 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
67 Добавляет указанную кодировку в поле <header>Content-Type</header>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
68 заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69 Если эта кодировка отличается от указанной в директиве
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70 <link id="source_charset"/>, то выполняется перекодирование.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
71 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
72
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
73 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
74 Параметр <literal>off</literal> отменяет добавление кодировки
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
75 в поле <header>Content-Type</header> заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
76 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
79 Кодировка может быть задана с помощью переменной:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80 <example>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
81 charset $charset;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
82 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83 В этом случае необходимо, чтобы все возможные значения переменной
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
84 присутствовали хотя бы один раз в любом месте конфигурации в виде
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
85 директив <link id="charset_map"/>, <link id="charset"/> или
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
86 <link id="source_charset"/>.
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
87 Для кодировок <literal>utf-8</literal>, <literal>windows-1251</literal>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
88 и <literal>koi8-r</literal> для этого достаточно включить в конфигурацию
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
89 файлы <path>conf/koi-win</path>, <path>conf/koi-utf</path> и
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
90 <path>conf/win-utf</path>.
285
Maxim Konovalov <maxim@nginx.com>
parents: 271
diff changeset
91 Для других кодировок можно просто сделать фиктивную таблицу перекодировки,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92 например:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 <example>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
94 charset_map iso-8859-5 _ { }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
98 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
99 Кроме того, кодировка может быть задана в поле <header>X-Accel-Charset</header>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
100 заголовка ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
101 Эту возможность можно запретить с помощью директив
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 952
diff changeset
102 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>,
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
103 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>,
2134
4cafd82e5007 Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1194
diff changeset
104 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_ignore_headers"/>,
4cafd82e5007 Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1194
diff changeset
105 <link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
106 и
2134
4cafd82e5007 Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1194
diff changeset
107 <link doc="ngx_http_grpc_module.xml" id="grpc_ignore_headers"/>.
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
108 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
109
76
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="charset_map">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
114 <syntax block="yes"><value>кодировка1</value> <value>кодировка2</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
115 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
116 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
117
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
118 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
119 Описывает таблицу перекодирования из одной кодировки в другую.
76
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 Коды символов задаются в шестнадцатеричном виде.
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
122 Неописанные символы в пределах 80-FF заменяются на “<literal>?</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
123 При перекодировании из UTF-8 символы, отсутствующие в однобайтной кодировке,
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
124 заменяются на “<literal>&amp;#XXXX;</literal>”.
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 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
128 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
129 <example>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
130 charset_map koi8-r windows-1251 {
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
131 C0 FE ; # small yu
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
132 C1 E0 ; # small a
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
133 C2 E1 ; # small b
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
134 C3 F6 ; # small ts
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
136 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
137 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
138 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
139
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
140 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
141 При описании таблицы перекодирования в UTF-8, коды кодировки UTF-8 должны
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
142 быть указаны во второй колонке, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 <example>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
144 charset_map koi8-r utf-8 {
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
145 C0 D18E ; # small yu
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
146 C1 D0B0 ; # small a
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
147 C2 D0B1 ; # small b
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
148 C3 D186 ; # small ts
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
151 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
152 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
153
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
155 Полные таблицы преобразования из <literal>koi8-r</literal> в
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
156 <literal>windows-1251</literal> и из <literal>koi8-r</literal> и
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
157 <literal>windows-1251</literal> в <literal>utf-8</literal>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
158 входят в дистрибутив и находятся в файлах <path>conf/koi-win</path>,
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
159 <path>conf/koi-utf</path> и <path>conf/win-utf</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
162 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
163
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
165 <directive name="charset_types">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
166 <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
167 <default>text/html text/xml text/plain text/vnd.wap.wml
952
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
168 application/javascript application/rss+xml</default>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
169 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
170 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
171 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
172 <appeared-in>0.7.9</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
173
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
175 Разрешает работу модуля в ответах с указанными MIME-типами
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
176 в дополнение к “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
177 Специальное значение “<literal>*</literal>” соответствует любому MIME-типу
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
178 (0.8.29).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
179 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180
952
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
181 <para>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
182 <note>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
183 До версии 1.5.4 по умолчанию вместо MIME-типа
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
184 “<literal>application/javascript</literal>” использовался
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
185 “<literal>application/x-javascript</literal>”.
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
186 </note>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
187 </para>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
188
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
189 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
190
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
191
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 <directive name="override_charset">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
193 <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
194 <default>off</default>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
195 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
196 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
197 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
198 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
200 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
201 Определяет, выполнять ли перекодирование для ответов,
2134
4cafd82e5007 Added info about gRPC to various modules.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1194
diff changeset
202 полученных от проксированного сервера или от FastCGI/uwsgi/SCGI/gRPC-сервера,
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
203 если в ответах уже указана кодировка в поле <header>Content-Type</header>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
204 заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205 Если перекодирование разрешено, то в качестве исходной кодировки
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 используется кодировка, указанная в полученном ответе.
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
207 <note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
208 Необходимо отметить, что если ответ был получен в подзапросе,
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
209 то, независимо от значения директивы <literal>override_charset</literal>,
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
210 всегда выполняется перекодирование из кодировки ответа в кодировку
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
211 основного запроса.
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
212 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
213 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
214
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
215 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
216
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218 <directive name="source_charset">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
219 <syntax><value>кодировка</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
220 <default/>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
221 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
222 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
223 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
224 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
225
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
226 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
227 Задаёт исходную кодировку ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
228 Если эта кодировка отличается от указанной в директиве
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
229 <link id="charset"/>, то выполняется перекодирование.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
230 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
231
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
232 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
233
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
234 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
236 </module>