模块 ngx_http_xslt_module

这ngx_http_xslt_module（0.7.8+） 是一个过滤器 ，它使用一个或多个 XSLT 样式表转换 XML 响应。

这个模块不是默认构建的，它应该使用--with-http_xslt_moduleconfiguration 参数。

此模块需要 libxml2 和 libxslt 库。

location / {
    xml_entities    /site/dtd/entities.dtd;
    xslt_stylesheet /site/xslt/one.xslt param=value;
    xslt_stylesheet /site/xslt/two.xslt;
}

指定声明字符实体的 DTD 文件。 此文件在配置阶段编译。 由于技术原因，该模块无法使用 外部子集，因此它是 ignored 的 URL，而是使用专门定义的文件。 此文件不应描述 XML 结构。 只需声明所需的字符实体就足够了，例如：

<!ENTITY nbsp "&#xa0;">

xslt_last_modified off;

允许保留 “Last-Modified” 报头字段 从 XSLT 转换期间的原始响应 以促进响应缓存。

默认情况下，标头字段将作为响应的内容删除 在转换期间被修改，并且可能包含动态生成的 独立于原始响应而更改的元素或部分。

定义 XSLT 样式表的参数。 这value被视为 XPath 表达式。 这value可以包含变量。 要将字符串值传递给样式表， 可以使用 xslt_string_param Directives。

可能有几个xslt_paramDirectives。 这些Directives继承自之前的配置级别 当且仅当没有xslt_param和 xslt_string_param Directives 在当前级别上定义。

定义 XSLT 样式表的字符串参数。 XPath 表达式中的value不进行解释。 这value可以包含变量。

可能有几个xslt_string_paramDirectives。 这些Directives继承自之前的配置级别 当且仅当没有 xslt_param 且xslt_string_paramDirectives 在当前级别上定义。

定义 XSLT 样式表及其可选参数。 stylesheet 在配置阶段编译。

参数可以单独指定，也可以在 使用”:“ 分隔符。 如果参数包含 ”:“字， 它应该转义为 ”%3A”. 也libxsltrequires 将参数括起来 包含非字母数字字符的单引号或双引号， 例如：

param1='http%3A//www.example.com':param2=value2

参数描述可以包含变量，例如 整行参数可以从单个变量中获取：

location / {
    xslt_stylesheet /site/xslt/one.xslt
                    $arg_xslt_params
                    param1='$value1':param2=value2
                    param3=value3;
}

可以指定多个样式表。 它们将按指定顺序顺序应用。

xslt_types text/xml;

在具有指定 MIME 类型的响应中启用转换 除了”text/xml”. 特殊值 “” 与任何 MIME 类型 （0.8.29） 匹配。 如果转换结果是 HTML 响应，则其 MIME 类型 更改为”*text/html”.