Last updated: Sun, 25 Nov 2007

XSLTProcessor->transformToDoc()

(no version information, might be only in CVS)

XSLTProcessor->transformToDoc() -- Transform to a DOMDocument

Description

class XSLTProcessor {

DOMDocument transformToDoc ( DOMNode doc )

}

Transforms the source node to a DOMDocument applying the stylesheet given by the XSLTProcessor->importStylesheet() method.

Parameters

doc: The node to be transformed.

Return Values

The resulting DOMDocument or FALSE on error.

Examples

Example 1. Transforming to a DOMDocument


<?php



// Load the XML source

$xml = new DOMDocument;

$xml->load('collection.xml');



$xsl = new DOMDocument;

$xsl->load('collection.xsl');



// Configure the transformer

$proc = new XSLTProcessor;

$proc->importStyleSheet($xsl); // attach the xsl rules



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



?>

The above example will output:

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


In most cases if you expect XML (or XHTML) as output you better use transformToXML() directly. You gain better control over xsl:output attributes, notably omit-xml-declaration.



Instead of :

$proc = new XSLTProcessor();

$proc->importStylesheet($xsl);

$dom = $proc->transformToDoc($xml);

echo $dom->saveXML();



do use : 

$proc = new XSLTProcessor();

$proc->importStylesheet($xsl);

$newXml = $proc->transformToXML($xml);

echo $newXml;



In the first case, <?xml version="1.0" encoding="utf-8"?> is added whatever you set the omit-xml-declaration while transformToXML() take the attribute into account.

add a note

XSLTProcessor->transformToURI()

XSLTProcessor->setParameter()