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


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




syntax: xml_entities <path>

default: no

context: http, server, location

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 “  “>


syntax: xslt_stylesheet template [parameter[[ parameter... ]] default: no

context: http, server, location

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


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//': 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

    param1='$value1': param2=value2

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


syntax: xslt_types mime-type [mime-type...]

default: xslt_types text/xml

context: http, server, location

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”.