Apache 模块 mod_charset_lite

可用语言: en | fr | ko

描述	指定字符集转换或重新编码
状态	扩展
模块标识符	charset_lite_module
源文件	mod_charset_lite.c

摘要

mod_charset_lite 允许服务器在将响应发送到客户端之前更改响应的字符集。在 EBCDIC 环境中，Apache 始终将 HTTP 协议内容（例如响应头）从 Apache 进程区域设置的代码页转换为 ISO-8859-1，但不会转换响应主体。在任何环境中，mod_charset_lite 可用于指定应转换响应主体。例如，如果文件存储在 EBCDIC 中，则 mod_charset_lite 可以将它们转换为 ISO-8859-1，然后再发送到客户端。

此模块提供由 Russian Apache 及其关联的 mod_charset 实现的一小部分配置机制。

主题

常见问题

错误修复清单

另请参阅

常见问题

无效的字符集名称

CharsetSourceEnc 和 CharsetDefault 的字符集名称参数必须是 mod_charset_lite 部署的系统上 APR 使用的转换机制可以接受的。这些字符集名称没有标准化，通常与 http 头中使用的相应值不同。目前，APR 只能使用 iconv(3)，因此您可以使用 iconv(1) 程序轻松测试您的字符集名称，如下所示

iconv -f charsetsourceenc-value -t charsetdefault-value

内容字符集与转换规则不匹配

如果转换规则对内容没有意义，则转换可能会以各种方式失败，包括

转换机制可能会返回错误的返回值，连接将被中止。
转换机制可能会在无法转换输入缓冲区时，在输出缓冲区中静默放置特殊字符（例如问号）。

CharsetDefault 指令

描述	要转换到的字符集
语法	`CharsetDefault charset`
上下文	服务器配置、虚拟主机、目录、.htaccess
覆盖	FileInfo
状态	扩展
模块	mod_charset_lite

CharsetDefault 指令指定关联容器中的内容应转换到的字符集。

charset 参数的值必须被 APR 中的字符集支持接受为有效的字符集名称。通常，这意味着它必须受 iconv 支持。

示例

<Directory "/export/home/trawick/apacheinst/htdocs/convert">
    CharsetSourceEnc  UTF-16BE
    CharsetDefault    ISO-8859-1
</Directory>

为 CharsetSourceEnc 和 CharsetDefault 指定相同的字符集将禁用转换。字符集不必与响应的字符集匹配，但它必须是系统上的有效字符集。

CharsetOptions 指令

描述	配置字符集转换行为
语法	`CharsetOptions option [option] ...`
默认值	`CharsetOptions ImplicitAdd`
上下文	服务器配置、虚拟主机、目录、.htaccess
覆盖	FileInfo
状态	扩展
模块	mod_charset_lite

CharsetOptions 指令配置 mod_charset_lite 的某些行为。Option 可以是以下之一

ImplicitAdd | NoImplicitAdd: ImplicitAdd 关键字指定 mod_charset_lite 应该在配置指定内容的字符集应转换时隐式插入其过滤器。如果使用 AddOutputFilter 指令显式配置过滤器链，则应指定 NoImplicitAdd，以便 mod_charset_lite 不会添加其过滤器。
TranslateAllMimeTypes | NoTranslateAllMimeTypes: 通常，mod_charset_lite 仅对一小部分可能的 mimetype 执行转换。当为给定的配置部分指定 TranslateAllMimeTypes 关键字时，将不考虑 mimetype 执行转换。

CharsetSourceEnc 指令

描述	文件的源字符集
语法	`CharsetSourceEnc charset`
上下文	服务器配置、虚拟主机、目录、.htaccess
覆盖	FileInfo
状态	扩展
模块	mod_charset_lite

CharsetSourceEnc 指令指定关联容器中文件的源字符集。