PHPでXMLをXSLTを使って変換する際に役立つ XSLTProcessor::setParameter 関数

PHPでXMLをXSLTを使って変換する際に役立つXSLTProcessor::setParameter関数

XSLTProcessor::setParameter関数は、XSLTスタイルシート内で使用するパラメータの値を設定するために使用されます。このパラメータは、スタイルシート内のXSLT式で使用して、XML文書の処理方法を動的に制御することができます。

構文

XSLTProcessor::setParameter($namespace, $name, $value);

パラメータ

• $namespace: パラメータのネームスペースURI。省略可能な場合は、空文字列を指定します。
• $name: パラメータのローカル名。
• $value: パラメータの新しい値。

例

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// パラメータ "price" を設定
$xsltProcessor->setParameter(NULL, 'price', 10.00);

// パラメータ "discount" を設定
$xsltProcessor->setParameter(NULL, 'discount', 0.10);

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<product name="Book" price="12.00"/>');
$output = $xsltProcessor->transformToXml($xmlDocument);

echo $output;

この例では、price と discount という2つのパラメータを設定しています。これらのパラメータは、スタイルシート内のXSLT式で使用して、製品の価格と割引率を計算するために使用されます。

• XSLTスタイルシート内のXML文書の処理方法を動的に制御することができます。
• スタイルシートを再コンパイルせずに、パラメータを変更することができます。
• さまざまなXML文書に対して同じスタイルシートを使用することができます。

XSLTProcessor::setParameter関数は、PHPでXMLをXSLTを使って変換する際に非常に役立つ関数です。この関数を活用することで、スタイルシートをより柔軟かつ効率的に使用することができます。

上記以外にも、XSLTProcessorクラスには、XML文書を変換したり、パラメータを取得したり、セキュリティ設定を変更したりするなどのさまざまな機能があります。これらの機能の詳細については、PHPのマニュアルを参照してください。

PHPでXMLをXSLTを使って変換する際のXSLTProcessor::setParameter関数のサンプルコード集

この例では、price と discount という2つのパラメータを使用して、書籍の価格と割引率を計算する方法を示します。

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// パラメータ "price" を設定
$xsltProcessor->setParameter(NULL, 'price', 12.00);

// パラメータ "discount" を設定
$xsltProcessor->setParameter(NULL, 'discount', 0.10);

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<product name="Book" price="12.00"/>');
$output = $xsltProcessor->transformToXml($xmlDocument);

echo $output;

出力:

<product name="Book" price="10.80" discount="0.10"/>

商品リストをHTMLテーブルに変換する

この例では、XSLTProcessor::setParameter関数を使用して、商品リストをHTMLテーブルに変換する方法を示します。

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// パラメータ "showHeader" を設定して、テーブルヘッダーを表示する
$xsltProcessor->setParameter(NULL, 'showHeader', true);

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<products>
    <product id="1" name="Book" price="12.00"/>
    <product id="2" name="Computer" price="600.00"/>
    <product id="3" name="TV" price="500.00"/>
</products>');
$output = $xsltProcessor->transformToXml($xmlDocument);

echo $output;

出力:

<table>
  <tr>
    <th>ID</th>
    <th>商品名</th>
    <th>価格</th>
  </tr>
  <tr>
    <td>1</td>
    <td>Book</td>
    <td>12.00</td>
  </tr>
  <tr>
    <td>2</td>
    <td>Computer</td>
    <td>600.00</td>
  </tr>
  <tr>
    <td>3</td>
    <td>TV</td>
    <td>500.00</td>
  </tr>
</table>

XML文書から特定の要素を抽出する

この例では、XSLTProcessor::setParameter関数を使用して、XML文書から特定の要素を抽出する方法を示します。

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// パラメータ "category" を設定して、"Electronics" カテゴリの製品のみを抽出
$xsltProcessor->setParameter(NULL, 'category', 'Electronics');

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<products>
    <product id="1" name="Book" category="Books" price="12.00"/>
    <product id="2" name="Computer" category="Electronics" price="600.00"/>
    <product id="3" name="TV" category="Electronics" price="500.00"/>
</products>');
$output = $xsltProcessor->transformToXml($xmlDocument);

echo $output;

出力:

<products>
    <product id="2" name="Computer" category="Electronics" price="600.00"/>
    <product id="3" name="TV" category="Electronics" price="500.00"/>
</products>

XML文書を別の形式に変換する

この例では、XSLTProcessor::setParameter関数を使用して、XML文書をJSON形式に変換する方法を示します。

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// 出力形式を "json" に設定
$xsltProcessor->setOutputFormat('json');

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<product name="Book" price="12.00"/>');
$output = $xsltProcessor->transformToXml($xmlDocument);

echo $output;

出力:

{"product

PHPでXMLをXSLTを使って変換する際にXSLTProcessor::setParameter関数以外の方法

XSLTスタイルシート内にパラメータを直接定義する

XSLTスタイルシート内に<xsl:param>要素を使用して、パラメータを直接定義することができます。

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:param name="price" as="xs:decimal" default="10.00"/>
  <xsl:param name="discount" as="xs:decimal" default="0.10"/>

  <xsl:template match="/product">
    <product name="{name}" price="{price * (1 - discount)}" discount="{discount}"/>
  </xsl:template>

</xsl:stylesheet>

この例では、price と discount という2つのパラメータを定義しています。これらのパラメータは、スタイルシート内のXSLT式で使用することができます。

XSLT 2.0のxsl:variable要素を使用する

XSLT 2.0では、<xsl:variable>要素を使用して、パラメータを定義することができます。

<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:variable name="price" as="xs:decimal" value="10.00"/>
  <xsl:variable name="discount" as="xs:decimal" value="0.10"/>

  <xsl:template match="/product">
    <product name="{name}" price="{price * (1 - discount)}" discount="{discount}"/>
  </xsl:template>

</xsl:stylesheet>

この例は、XSLT 1.0の例とほぼ同じですが、<xsl:variable>要素を使用してパラメータを定義しています。

XPath式を使用して、XML文書から値を取得することができます。

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<product name="Book" price="12.00"/>');

// XPath式を使用して価格を取得
$price = $xmlDocument->xpath('//product/@price')[0]->nodeValue;

// パラメータ "price" を設定
$xsltProcessor->setParameter(NULL, 'price', $price);

// 変換結果を出力
$output = $xsltProcessor->transformToXml($xmlDocument);
echo $output;

この例では、XPath式を使用して、XML文書から製品の価格を取得しています。取得した価格は、XSLTProcessor::setParameter関数を使用して、スタイルシート内のパラメータに設定されます。

グローバル変数を使用して、パラメータの値を共有することができます。

$price = 12.00;
$discount = 0.10;

$xsltProcessor = new XSLTProcessor();
$xsltProcessor->importStyleSheet($stylesheet);

// XML文書を変換
$xmlDocument = new DOMDocument();
$xmlDocument->loadXML('<product name="Book"/>');

// 変換結果を出力
$output = $xsltProcessor->transformToXml($xmlDocument);
echo $output;

この例では、$price と $discount という2つのグローバル変数を使用して、パラメータの値を共有しています。これらの変数は、スタイルシート内のXSLT式で使用することができます。

上記以外にも、PHPでXMLをXSLTを使って変換する際に、さまざまな方法があります。それぞれの方法には、それぞれ利点と欠点がありますので、状況に応じて最適な方法を選択してください。