非常教程

Nginx参考手册

ngx_http_charset_module

ngx_http_charset_module

  • 示例配置
  • 指令
  • 字符集
  • charset_map
  • charset_types
  • override_charset
  • source_charset

ngx_http_charset_module模块将指定的字符集添加到“Content-Type”响应标题字段。此外,该模块可以将数据从一个字符集转换为另一个字符集,但有一些限制:

  • 转换以单向方式执行 - 从服务器到客户端,
  • 只能转换单字节字符集
  • 或UTF-8的单字节字符集。

示例配置

include        conf/koi-win;

charset        windows-1251;
source_charset koi8-r;

指令

句法:

字符集字符集| 关闭;

默认:

字符集关闭;

语境:

http,服务器,位置,如果在指定位置

将指定的字符集添加到“Content-Type”响应标题字段。如果此字符集与source_charset伪指令中指定的字符集不同,则执行转换。

该参数off取消将字符集添加到“Content-Type”响应标题字段。

字符集可以用变量定义:

charset $charset;

在这种情况下,变量的所有可能值至少需要以charset_map,charset或source_charset指令的形式出现在配置中。 对于utf-8,windows-1251和koi8-r字符集,配置文件中包含conf / koi-win,conf / koi-utf和conf / win-utf文件就足够了。 对于其他字符集,只需制作一个虚构的转换表就行,例如:

charset_map iso-8859-5 _ { }

另外,可以在“X-Accel-Charset”响应头字段中设置字符集。可以使用proxy_ignore_headers,fastcgi_ignore_headers,uwsgi_ignore_headers和scgi_ignore_headers指令禁用此功能。

句法:

charset_map charset1 charset2 {...}

默认:

语境:

HTTP

描述从一个字符集到另一个字符集的转换表。使用相同的数据构建反向转换表。字符代码以十六进制给出。缺少80-FF范围内的字符将被替换为“ ?”。从UTF-8转换时,单字节字符集中丢失的字符被替换为“ &#XXXX;”。

例:

charset_map koi8-r windows-1251 {
    C0 FE ; # small yu
    C1 E0 ; # small a
    C2 E1 ; # small b
    C3 F6 ; # small ts
    ...
}

在将转换表格描述为UTF-8时,应在第二列中给出UTF-8字符集编码,例如:

charset_map koi8-r utf-8 {
    C0 D18E ; # small yu
    C1 D0B0 ; # small a
    C2 D0B1 ; # small b
    C3 D186 ; # small ts
    ...
}

分发文件conf / koi-win,conf / koi-utf和conf / win-utf中提供了从koi8-r到windows-1251以及从koi8-r和windows-1251到utf-8的完整转换表。

句法:

charset_types mime-type ...;

默认:

charset_types text / html text / xml text / plain text / vnd.wap.wml application / javascript application / rss + xml;

语境:

http,服务器,位置

除了“ text/html” 之外,还允许模块处理响应指定的MIME类型。特殊值“ *”匹配任何MIME类型(0.8.29)。

在版本1.5.4之前,“ application/x-javascript”被用作默认的MIME类型而不是“ application/javascript”。

句法:

override_charset 开启|关闭;

默认:

override_charset关闭;

语境:

http,服务器,位置,如果在指定位置

确定在答案已在“Content-Type”响应头字段中携带字符集时,是否应对从代理或FastCGI / uwsgi / SCGI服务器收到的答案执行转换。如果启用转换,则将接收到的响应中指定的字符集用作源字符集。

应该注意的是,如果在子请求中接收到响应,则始终执行从响应字符集到主要请求字符集的转换,而不管override_charset指令设置如何。

句法:

source_charset字符集;

默认:

语境:

http,服务器,位置,如果在位置

定义响应的源字符集。如果此字符集与charset伪指令中指定的字符集不同,则执行转换。

ngx_http_charset_module
Nginx

Nginx是一款轻量级的 Web 服务器/反向代理服务器及电子邮件代理服务器,可在 BSD-like 协议下发行。其特点是占有内存少,并发能力强。

主页 https://nginx.org/
源码 http://hg.nginx.org/nginx
发布版本 1.13.6

Nginx目录

1.指南 | Guides
2.核心 | Core
3.ngx_google_perftools_module
4.ngx_http_access_module
5.ngx_http_addition_module
6.ngx_http_api_module
7.ngx_http_auth_basic_module
8.ngx_http_auth_jwt_module
9.ngx_http_auth_request_module
10.ngx_http_autoindex_module
11.ngx_http_browser_module
12.ngx_http_charset_module
13.ngx_http_core_module
14.ngx_http_dav_module
15.ngx_http_empty_gif_module
16.ngx_http_f4f_module
17.ngx_http_fastcgi_module
18.ngx_http_flv_module
19.ngx_http_geoip_module
20.ngx_http_geo_module
21.ngx_http_gunzip_module
22.ngx_http_gzip_module
23.ngx_http_gzip_static_module
24.ngx_http_headers_module
25.ngx_http_hls_module
26.ngx_http_image_filter_module
27.ngx_http_index_module
28.ngx_http_js_module
29.ngx_http_keyval_module
30.ngx_http_limit_conn_module
31.ngx_http_limit_req_module
32.ngx_http_log_module
33.ngx_http_map_module
34.ngx_http_memcached_module
35.ngx_http_mirror_module
36.ngx_http_mp4_module
37.ngx_http_perl_module
38.ngx_http_proxy_module
39.ngx_http_random_index_module
40.ngx_http_realip_module
41.ngx_http_referer_module
42.ngx_http_rewrite_module
43.ngx_http_scgi_module
44.ngx_http_secure_link_module
45.ngx_http_session_log_module
46.ngx_http_slice_module
47.ngx_http_spdy_module
48.ngx_http_split_clients_module
49.ngx_http_ssi_module
50.ngx_http_ssl_module
51.ngx_http_status_module
52.ngx_http_stub_status_module
53.ngx_http_sub_module
54.ngx_http_upstream_conf_module
55.ngx_http_upstream_hc_module
56.ngx_http_upstream_module
57.ngx_http_userid_module
58.ngx_http_uwsgi_module
59.ngx_http_v2_module
60.ngx_http_xslt_module
61.ngx_mail_auth_http_module
62.ngx_mail_core_module
63.ngx_mail_imap_module
64.ngx_mail_pop3_module
65.ngx_mail_proxy_module
66.ngx_mail_smtp_module
67.ngx_mail_ssl_module
68.ngx_stream_access_module
69.ngx_stream_core_module
70.ngx_stream_geoip_module
71.ngx_stream_geo_module
72.ngx_stream_js_module
73.ngx_stream_limit_conn_module
74.ngx_stream_log_module
75.ngx_stream_map_module
76.ngx_stream_proxy_module
77.ngx_stream_realip_module
78.ngx_stream_return_module
79.ngx_stream_split_clients_module
80.ngx_stream_ssl_module
81.ngx_stream_ssl_preread_module
82.ngx_stream_upstream_hc_module
83.ngx_stream_upstream_module