XSLTProcessor::transformToUri

(PHP 5, PHP 7, PHP 8)

XSLTProcessor::transformToUri — URI に変換する

説明

public XSLTProcessor::transformToUri(object $document, string $uri): int

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

パラメータ

document

変換される Dom\Document, DOMDocument, SimpleXMLElement、または libxml と互換性があるオブジェクトを指定します。

uri

変換先の URI。

エラー / 例外

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

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

戻り値

書き込まれたバイト数。エラーが発生した場合は false 。

変更履歴

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

例

例1 HTML ファイルへの変換

<?php

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

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

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

$proc->transformToURI($xml, 'file:///tmp/out.html');

?>

例2 Dom\Document を使ってHTMLファイルへの変換を行う

<?php

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

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

$proc->transformToURI($xml, 'file:///tmp/out.html');

?>

参考