説明

public XSLTProcessor::transformToDoc(object $document, ?string $returnClass = null): DOMDocument|false

XSLTProcessor::importStylesheet() メソッドで与えられたスタイルシートを適用し、ソースノードをドキュメント (例: DOMDocument) に変換します。

パラメータ

document: 変換される Dom\Document, DOMDocument, SimpleXMLElement、または libxml と互換性があるオブジェクトを指定します。
returnClass: XSLTProcessor::transformToDoc() が返すオブジェクトのクラス名を指定する、オプションのパラメータです。ここで指定するクラスは、document と同じものか、それを継承したクラスであるべきです。

エラー / 例外

PHP のコールバックを呼び出す式を使う際は、以下のエラーが発生する可能性があります。

PHP のコールバックを呼び出しているのにコールバックが登録されていなかったり、名前付きコールバックが登録されていない場合、 Error がスローされます。
php:function を使っていて、ハンドラ名が文字列でない場合、 TypeError がスローされます。
DOM でないオブジェクトがコールバックから返された場合、 Error がスローされます。

戻り値

結果のドキュメントを返します。エラーが発生した場合は false を返します。

変更履歴

バージョン	説明
8.4.0	コールバックが呼び出せない場合、警告を発生させる代わりに、 Error がスローされるようになりました。
8.4.0	Dom\Document のサポートが追加されました。

例

例1 DOMDocument への変換

<?php

// XML ソースをロードする
$xml = new DOMDocument;
$xml->load('collection.xml');

$xsl = new DOMDocument;
$xsl->load('collection.xsl');

// 変換の設定を行う
$proc = new XSLTProcessor;
$proc->importStyleSheet($xsl); // XSL ルールを適用する

echo trim($proc->transformToDoc($xml)->firstChild->wholeText);

?>

上の例の出力は以下となります。

Hey! Welcome to Nicolas Eliaszewicz's sweet CD collection!

例2 Dom\Document への変換

<?php

$xml = Dom\XMLDocument::createFromFile('collection.xml');
$xsl = Dom\XMLDocument::createFromFile('collection.xsl');

// 変換の設定を行う
$proc = new XSLTProcessor;
$proc->importStyleSheet($xsl); // XSL ルールを適用する

echo trim($proc->transformToDoc($xml)->firstChild->wholeText);

?>

上の例の出力は以下となります。

Hey! Welcome to Nicolas Eliaszewicz's sweet CD collection!

参考

XSLTProcessor::transformToUri() - URI に変換する
XSLTProcessor::transformToXml() - XML に変換する