charset_map
charset_map 指令在 NGINX 中定义了字符集与其等效 MIME 组件之间的映射。 — NGINX HTTP Core
charset_map
http
语法charset_map { charset source_charset destination_charset; ... };
默认值none
上下文http
模块NGINX HTTP Core
参数block (2)
说明
`charset_map` 指令允许用户指定在 NGINX 的 `http` 上下文中,不同字符集应如何映射到 MIME 组件。这对于确保 NGINX 所提供的内容正确标识其字符编码尤其有用,字符编码会影响浏览器如何显示内容。`charset_map` 块中的每一项由源字符集和目标字符集组成,提供了一种在需要时在不同编码之间转换的方法。 该指令在 `http` 上下文中生效,使用一个块结构进行配置,包含一系列格式为 `charset source_charset destination_charset;` 的条目。例如,如果某个字符集应被视为另一个字符集(例如将 `latin1` 映射到 `utf-8`),可以在该块中声明。当 NGINX 处理请求时,会查阅此映射以确定如何为发送给客户端的内容处理字符编码。 需要确保所定义的映射是准确且必要的,因为错误的配置可能导致客户端浏览器上的内容渲染不正确。此外,这对国际化也非常重要,内容可能需要根据用户位置和偏好以不同语言和编码进行提供。
配置示例
charset_map {
charset windows-1251 utf-8;
charset iso-8859-1 utf-8;
};⚠
确保所使用的所有字符集都被客户端浏览器支持并识别。
⚠
重叠或冲突的字符集定义可能导致意外行为或内容渲染不正确。
⚠
在修改 charset map 后,记得重启 NGINX 以确保更改生效。