XSLTProcessor::transformToDoc

    (PHP 5, PHP 7, PHP 8)

    XSLTProcessor::transformToDoc — Transform to a document

    Опис

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

    Transforms the source node to a document (e.g. DOMDocument) applying the stylesheet given by the XSLTProcessor::importStylesheet() method.

    Параметри

    document

    The Dom\Document, DOMDocument, SimpleXMLElement or libxml-compatible object to be transformed.

    returnClass

    This optional parameter may be used so that XSLTProcessor::transformToDoc() will return an object of the specified class. That class should either extend or be the same class as document's class.

    Значення, що повертаються

    The resulting document or false on error.

    Журнал змін

    Версія Опис
    8.4.0 Added support for Dom\Document.

    Приклади

    Приклад #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);

    ?>

    Поданий вище приклад виведе:

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

    Приклад #2 Transforming to a Dom\Document

    <?php

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

    // Configure the transformer
    $proc = new XSLTProcessor;
    $proc->importStyleSheet($xsl); // attach the xsl rules

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

    ?>

    Поданий вище приклад виведе:

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

    Прогляньте також

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    1
    franp at free dot fr
    18 years ago
    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
    To Top