模块 ngx_http_charset_module

模块 ngx_http_charset_module 将指定的字符集添加到“Content-Type”响应头字段中。此外，该模块可以将数据从一个字符集转换为另一个字符集，但存在一些限制：

• 转换是单向的 —— 从服务器到客户端，
• 只能转换单字节字符集，
• 或单字节字符集与UTF-8之间的转换。

include        conf/koi-win;

charset        windows-1251;
source_charset koi8-r;

charset off;

将指定的字符集添加到“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 和 grpc_ignore_headers 指令禁用此功能。

描述了从一个字符集到另一个字符集的转换表。使用相同的数据构建反向转换表。字符代码以十六进制给出。范围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
    ...
}

从koi8-r到windows-1251的完整转换表，以及从koi8-r和windows-1251到utf-8的转换表可在分发文件conf/koi-win，conf/koi-utf和conf/win-utf中找到。

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

除了“text/html”之外，还启用了对指定MIME类型的响应中模块处理的支持。特殊值“*”匹配任何MIME类型（0.8.29）。

直到版本1.5.4，“application/x-javascript”被用作默认MIME类型，而不是“application/javascript”。

override_charset off;

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

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

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