Apache 模块 mod_xml2enc

用法

有两种使用场景：与为 mod_xml2enc 编程的模块一起使用，以及与不知道它的模块一起使用

为 mod_xml2enc 启用的过滤器模块

诸如 mod_proxy_html 版本 3.1 及更高版本之类的模块使用 xml2enc_charset 可选函数来检索要传递给 libxml2 解析器的字符集参数，并且可以使用 xml2enc_filter 可选函数来将数据后处理到另一个编码。将 mod_xml2enc 与启用的模块一起使用，无需配置：另一个模块将为您配置 mod_xml2enc（尽管您可能仍然希望使用下面的配置指令对其进行自定义）。

未启用的模块

要将其与未明确为 mod_xml2enc 启用的基于 libxml2 的模块一起使用，您必须自己配置过滤器链。因此，要将其与模块 mod_foo 提供的过滤器 foo 一起使用，以通过 HTML 和 XML 提高后者的 i18n 支持，您可以使用

    FilterProvider iconv    xml2enc Content-Type $text/html
    FilterProvider iconv    xml2enc Content-Type $xml
    FilterProvider markup   foo Content-Type $text/html
    FilterProvider markup   foo Content-Type $xml
    FilterChain     iconv markup
    

mod_foo 现在将支持 libxml2 或 apr_xlate/iconv 中任何一个（或两者）支持的任何字符集。

编程 API

编写基于 libxml2 的过滤器模块的程序员鼓励为 mod_xml2enc 启用它们，以便为您的用户提供强大的 i18n 支持，而无需重新发明轮子。编程 API 在 mod_xml2enc.h 中公开，并且 mod_proxy_html 是一个使用示例。

检测编码

与 mod_charset_lite 不同，mod_xml2enc 旨在处理其编码无法预先知道且因此无法配置的数据。因此，它使用“嗅探”技术来检测 HTTP 数据的编码，如下所示

1. 如果 HTTP Content-Type 标头包含 charset 参数，则使用该参数。
2. 如果数据以 XML 字节顺序标记 (BOM) 或 XML 编码声明开头，则使用该标记。
3. 如果在 HTML <META> 元素中声明了编码，则使用该编码。
4. 如果以上都没有匹配，则使用 xml2EncDefault 设置的默认值。

这些规则按顺序应用。一旦找到匹配项，就会使用它，并且检测将停止。

输出编码

libxml2 在内部始终使用 UTF-8（Unicode），基于 libxml2 的过滤器模块默认情况下将输出该编码。mod_xml2enc 可以通过 API 更改输出编码，但目前无法直接配置它。

更改输出编码（理论上至少）永远不会有必要，并且由于服务器上不必要的转换造成的额外处理负载，因此不建议这样做。

不支持的编码

如果您使用的是平台上任何转换方法都不支持的编码，您仍然可以使用 xml2EncAlias 将它们别名为支持的编码。