XSLTProcessor::transformToDoc

    (PHP 5, PHP 7, PHP 8)

    XSLTProcessor::transformToDoc — Transforma em um documento

    Descrição

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

    Transforma o nó de origem em um documento (ex.: DOMDocument) aplicando a folha de estilos fornecida pelo método XSLTProcessor::importStylesheet().

    Parâmetros

    document

    O objeto Dom\Document, DOMDocument, SimpleXMLElement, ou outro compatível com libxml a ser transformado.

    returnClass

    Este parâmetro opcional pode ser usado para que XSLTProcessor::transformToDoc() retorne um objeto da classe especificada. Esta classe deve estender ou ser da mesma classe de document.

    Erros/Exceções

    Os seguintes erros são possíveis ao usar uma expressão que invoca retornos de chamada PHP.

    • Lança um Error se um retorno de chamada do PHP for invocado, mas não houver nenhum retorno de chamada registrado ou se o retorno de chamada nomeado não tiver sido registrado.
    • Lança um TypeError se a sintaxe php:function for usada e o nome do manipulador não for uma string.
    • Lança um Error se um objeto não DOM foi retornado de um retorno de chamada.

    Valor Retornado

    O documento resultante ou false em caso de erro.

    Registro de Alterações

    Versão Descrição
    8.4.0 Agora lança uma exceção Error se a função de retorno não puder ser chamada, em vez de emitir um alerta.
    8.4.0 Adicionado suporte para Dom\Document.

    Exemplos

    Exemplo #1 Transformando em um DOMDocument

    <?php

    // Carrega a fonte XML
    $xml = new DOMDocument;
    $xml->load('collection.xml');

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

    // Configura o transformador
    $proc = new XSLTProcessor;
    $proc->importStyleSheet($xsl); // anexa as regras xsl

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

    ?>

    O exemplo acima produzirá:

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

    Exemplo #2 Transformando em um Dom\Document

    <?php

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

    // Configura o transformador
    $proc = new XSLTProcessor;
    $proc->importStyleSheet($xsl); // anexa as regras xsl

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

    ?>

    O exemplo acima produzirá:

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

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 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.
    ＋adicione uma nota
    To Top