Apache模块mod_xml2enc

用法

有两种使用情况：编程为可与mod_xml2enc一起使用的模块，以及不知道该模块的模块：

为mod_xml2enc启用了过滤器模块

mod_proxy_html3.1版及更高版本等模块使用xml2enc_charset可选功能来检索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. 如果以上都不匹配，则使用默认值by xml2EncDefault。

规则按顺序应用。一旦找到匹配项，将使用该匹配项并停止检测。

输出编码

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

至少从理论上讲，不必更改输出编码，并且不建议这样做，因为不必要的转换会给服务器带来额外的处理负担。

不支持的编码

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