nginx中文文档-ngx_http_xslt_module

ngx_http_xslt_module模块(0.7.8+)是一个过滤器,用于使用一个或多个XSLT 样式表改变XML响应样式。该模块默认不会构建,需要通过–with-http_xslt_module配置参数开启。该模块需要libxml2和libxslt库。

示例配置

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

xml_entities

语法:xml_entities path
默认:—
上下文:http, server, location

指定DTD文件声明实体字符。这个文件在配置阶段编译。由于技术原因,这个模块不能使用声明在处理过的XML中的外部子集,所以它会被忽略,然后使用一个特殊定义的文件替代它。文件不应该描述XML结构。它只声明需要的实体字符就够了,例如:
<!ENTITY nbsp "&#xa0;">

xslt_last_modified

语法:xslt_last_modified on | off
默认:xslt_last_modified off
上下文:http, server, location
版本:1.5.1+

允许在XSLT转换期间从原始响应头中保留“Last-Modified”字段,有助于缓存响应。
默认情况下,头域会被删除,因为在转换过程中,响应的内容改变了,可能包含动态生成的元素或与原始请求不同的部分。

xslt_param

语法:xslt_param parameter value
默认:—
上下文:http, server, location
版本:1.1.18+

定义XSLT样式表的参数。值看做是一个XPath表达式。值可以包含变量。为了传递字符串值到样式表,可以使用xslt_string_param指令。
可以有多个xslt_param指令。这些指令当且仅当当前层级中没有定义xslt_param和xslt_string_param指令时会继承自上一层级。

xslt_string_param

语法:xslt_string_param parameter value
默认:—
上下文:http, server, location
版本:1.1.18+

为XSLT样式表定义字符串参数。值中的XPath表达式是不被理解的。值可以包含变量。
可以有多个xslt_string_param指令。这些指令当且仅当当前层级中没有定义xslt_param和xslt_string_param指令时,会继承自上一层级。

xslt_stylesheet

语法:xslt_stylesheet stylesheet [parameter=value …];
默认:—
上下文:location

定义XLST样式表和它的可选参数。样式表在配置阶段编译。
参数可以是分开的,也可是聚合在同一行使用“:”分割。如果参数包含“:”字符,需要转义为“%3A”。同样libxslt需要将包含非字母数字的字符用单引号或双引号包裹起来,例如:
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

语法:xslt_types mime-type
默认:xslt_types text/xml
上下文:http, server, location

对指定除了“text/xml”意外的MIME类型的响应启用转换。特殊值“*”匹配任意MIME类型(0.8.29+)。如果转换结果是一个HTML响应,它的MIME类型变更为“text/html”。

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

请开启浏览器JavaScript