ngx_http_xslt_module モジュール

ngx_http_xslt_module (0.7.8+) は、一つ以上のXSLTスタイルシートを使ってXML応答を変形するフィルタです。

このモジュールはデフォルトではビルドされず、--with-http_xslt_module configureパラメータを有効にする必要があります。

このモジュールは libxml2 と libxslt ライブラリを必要とします。

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

キャラクタエンティティを宣言するDTDファイルを指定する。このファイルは配置ステージでコンパイルされます。技術的な理由で、モジュールは処理中のXMLで定義されている外部のサブセットを使うことができません。そのため、そのサブセットは無視され、代わりに特別に指定したファイルが使われます。このファイルはXML構造を記述すべきではありません。それは、要求される文字を宣言するだけで十分です。例えば:

<!ENTITY nbsp "&#xa0;">

xslt_last_modified off;

応答のキャッシュを容易にするために、XSLTの変換時に元の応答の"Last-Modified"ヘッダを保持することができます。

デフォルトでは、応答のコンテンツは変換時に修正されるため、そのヘッダは削除されます。そして、元の応答とは無関係に変更された動的生成された要素あるいはパーツを含むかもしれません。

XSLTスタイルシートのためのパラメータを定義します。value は XPath表現として扱われます。value は変数を含むことができます。文字列をスタイルシートに渡すには、 xslt_string_param ディレクティブを使うことができます。

幾つかのxslt_paramディレクティブが有り得ます。現在のレベルにxslt_param とxslt_string_paramのディレクティブがない場合に限り、これらのディレクティブは上の設定レベルから引き継ぎます。

XSLTスタイルシートのためのパラメータを定義します。value の中のxPath表現は解釈されません。value は変数を含むことができます。

幾つかのxslt_string_paramディレクティブが有り得ます。現在のレベルにxslt_param とxslt_string_paramのディレクティブがない場合に限り、これらのディレクティブは上の設定レベルから引き継ぎます。

XSLTスタイルシートとそのオプションのパラメータを定義します。スタイルシートは配置ステージでコンパイルされます。

パラメータは個々に指定することも、行の中で":"デリミタを使ってグループ化することもできます。もしパラメータに":"文字が含まれる場合は、"%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 text/xml;

"text/xml"に加えて、指定されたMIMEタイプで応答の変換を行うことができます。特別な値"*"は全てのMIMEタイプに一致します(0.8.29)。変換の結果がHTML応答であった場合、MIMEタイプは"text/html"に変更されます。