Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_charset_module.xml @ 617:368a449e85b8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Expanded documentation of what various parameters of the "listen" directive related to socket options do. While here, documented the fact that accept filters also work on NetBSD.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 02 Aug 2012 13:24:07 +0000
parents 764fbac1b8b4
children 417dc982362e
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"
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
13 rev="1">
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 Эту возможность можно запретить с помощью директив
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
102 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
103 и
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
104 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
105 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
106
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
107 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
109
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110 <directive name="charset_map">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
111 <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
112 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
113 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
114
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
115 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
116 Описывает таблицу перекодирования из одной кодировки в другую.
76
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 Коды символов задаются в шестнадцатеричном виде.
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
119 Неописанные символы в пределах 80-FF заменяются на “<literal>?</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120 При перекодировании из UTF-8 символы, отсутствующие в однобайтной кодировке,
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
121 заменяются на “<literal>&amp;#XXXX;</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
123
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
124 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
125 Пример:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
126 <example>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
127 charset_map koi8-r windows-1251 {
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
128 C0 FE ; # small yu
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
129 C1 E0 ; # small a
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
130 C2 E1 ; # small b
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
131 C3 F6 ; # small ts
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
132 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
133 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
134 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 </para>
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 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
138 При описании таблицы перекодирования в UTF-8, коды кодировки UTF-8 должны
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
139 быть указаны во второй колонке, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
140 <example>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
141 charset_map koi8-r utf-8 {
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
142 C0 D18E ; # small yu
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
143 C1 D0B0 ; # small a
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
144 C2 D0B1 ; # small b
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
145 C3 D186 ; # small ts
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
146 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
147 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149 </para>
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 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
152 Полные таблицы преобразования из <literal>koi8-r</literal> в
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
153 <literal>windows-1251</literal> и из <literal>koi8-r</literal> и
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
154 <literal>windows-1251</literal> в <literal>utf-8</literal>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
155 входят в дистрибутив и находятся в файлах <path>conf/koi-win</path>,
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
156 <path>conf/koi-utf</path> и <path>conf/win-utf</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
157 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
159 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160
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 name="charset_types">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
163 <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
164 <default>text/html text/xml text/plain text/vnd.wap.wml
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
165 application/x-javascript application/rss+xml</default>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
166 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
167 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
168 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
169 <appeared-in>0.7.9</appeared-in>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
170
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
172 Разрешает работу модуля в ответах с указанными MIME-типами
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
173 в дополнение к “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
174 Специальное значение “<literal>*</literal>” соответствует любому MIME-типу
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
175 (0.8.29).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
177
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
178 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
179
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
181 <directive name="override_charset">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
182 <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
183 <default>off</default>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
184 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
185 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
186 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
187 <context>if в location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
188
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
189 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
190 Определяет, выполнять ли перекодирование для ответов,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
191 полученных от проксированного сервера или от FastCGI-сервера,
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
192 если в ответах уже указана кодировка в поле <header>Content-Type</header>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
193 заголовка ответа.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194 Если перекодирование разрешено, то в качестве исходной кодировки
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
195 используется кодировка, указанная в полученном ответе.
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
196 <note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
197 Необходимо отметить, что если ответ был получен в подзапросе,
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
198 то, независимо от значения директивы <literal>override_charset</literal>,
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
199 всегда выполняется перекодирование из кодировки ответа в кодировку
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
200 основного запроса.
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
201 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
202 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
203
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
204 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
207 <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
208 <syntax><value>кодировка</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
209 <default/>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
210 <context>http</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
211 <context>server</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
212 <context>location</context>
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
213 <context>if в location</context>
76
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 <para>
349
302222923e34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
216 Задаёт исходную кодировку ответа.
76
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 <link id="charset"/>, то выполняется перекодирование.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
219 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
220
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
221 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
222
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
225 </module>