HttpXsltModule

WARNING: this article is obsoleted. Please refer to http://nginx.org/en/docs/ for the latest official documentation.

= Synopsis =

This module is a filter which converts an XML response with the aid of one or more XSLT templates.

This module was introduced in 0.7.8 and needs to be enabled via ./configure --with-http_xslt_module

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

= Directives =

xml_entities


Specifies the DTD file which describes symbolic elements (xml entities). This file is compiled at the stage of configuration. For technical reasons it's not possible to specify entities in the XML being processed, therefore they are ignored, but this specially assigned file is used instead. In this file it is not necessary to describe structure of processed XML, it is sufficient only to declare necessary symbolic elements, for example:

<! ENTITY of nbsp “&#xa0; “>

xslt_param


xslt_string_param


xslt_stylesheet


Specifies the XSLT template with its parameters. Template is compiled at the stage of configuration. The parameters are assigned as shown:

param=value

You can specify parameters either one per line, or separate multiple parameters with colon (“: ”) If the parameter itself contains the character “:”, escape it as “%3A”. Furthermore, libxslt requires that string parameters should be quoted by the single or dual quotation marks if they contain non-alphanumeric characters, for example:

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

It's possible to use variables as parameters, for example, the entire line of the parameters can be substituted with one variable:

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

It is possible to specify several templates, in which case they would be chained together in the order of their declaration.

xslt_types


Permit processing responses with specified MIME-types in addition to “text/xml”. If XSLT output mode is HTML, then the response MIME-type changes to “text/HTML”.

= References = Original Documentation