示例配置
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 " ">
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”。