xslt_stylesheet

The `xslt_stylesheet` 指令指定要在 NGINX 中应用于 XML 响应的 XSLT 样式表。 — NGINX HTTP Core

xslt_stylesheet
location
语法xslt_stylesheet path | path;
默认值none
上下文location
模块NGINX HTTP Core
参数1+

说明

`xslt_stylesheet` 指令在 NGINX 中用于定义一个或多个 XSLT 样式表,这些样式表将在请求 XML 响应时应用。该指令在 `location` 块中定义,可以接受一个或多个参数,每个参数指定要在转换过程中应用的 XSLT 文件的路径或参数。当生成 XML 响应时,NGINX 将使用提供的 XSLT 样式表将 XML 转换为不同的格式(例如 HTML),然后将数据传递给客户端浏览器。 使用 `xslt_stylesheet` 时,重要的是正确配置 XSLT 文件的路径,并确保 XML 响应格式正确以便进行转换。XSLT 的处理还可能受 NGINX 中与 XML 处理相关的其他指令的影响,例如 `xslt_types` 和 `xslt_last_modified`。此外,正确的转换依赖于 NGINX 配置中存在有效的 XSLT 处理器,XSLT 中的任何错误都可能导致无法转换 XML 响应。 此外,它既可以接受基于 NGINX 根目录的相对路径,也可以接受绝对路径。该指令的行为是,如果指定了多个样式表,它们将按给定顺序依次应用,这有助于在需要多次转换以进行复杂 XML 操作的场景中实现所需的处理。

配置示例

location /xml {
    xslt_stylesheet /path/to/stylesheet.xsl;
}

确保 XSLT 文件的路径正确;否则转换将无法正常工作。

在部署到生产环境之前,请分别验证 XML 和 XSLT 文件以查找语法错误。

如果指定了多个 XSLT 文件,应用的顺序会影响最终输出。