模块 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-8conf/koi-winconf/koi-utfconf/win-utf

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

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

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

override_charset off;

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

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

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