PHP 8.4.2 Released!

    XSLTProcessor::transformToDoc

    (PHP 5, PHP 7, PHP 8)

    XSLTProcessor::transformToDoc — Transformiert in ein Dokument

    Beschreibung

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

    Transformiert den Quellknoten in ein Dokument (z. B. DOMDocument, indem das mittels der Methode XSLTProcessor::importStylesheet() übergebene Stylesheet angewendet wird.

    Parameter-Liste

    document

    Das zu verarbeitende Dom\Document-, DOMDocument-, SimpleXMLElement- oder libxml-kompatible Objekt.

    returnClass

    Dieser optionale Parameter kann verwendet werden, damit XSLTProcessor::transformToDoc() ein Objekt der angegebenen Klasse zurückgibt. Diese Klasse sollte entweder die gleiche Klasse sein wie die von document oder diese erweitern.

    Rückgabewerte

    Das erzeugte Dokument oder false, falls ein Fehler aufgetreten ist.

    Changelog

    Version Beschreibung
    8.4.0 Unterstützung für Dom\Document hinzugefügt.

    Beispiele

    Beispiel #1 Transformation in ein DOMDocument

    <?php

    // XML-Quelle laden
    $xml = new DOMDocument;
    $xml->load('collection.xml');

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

    // Transformierenden Prozessor instanziieren und konfigurieren
    $proc = new XSLTProcessor;
    $proc->importStyleSheet($xsl); // die XSL-Regeln anhängen

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

    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

    Beispiel #2 Transformation in ein Dom\Document

    <?php

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

    // Transformierenden Prozessor instanziieren und konfigurieren
    $proc = new XSLTProcessor;
    $proc->importStyleSheet($xsl); // attach the xsl rules

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

    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

    Siehe auch

    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