Mercurial > hg > nginx-site

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 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>