CakeFest 2024: The Official CakePHP Conference

XSLTProcessor::transformToDoc

(PHP 5, PHP 7, PHP 8)

XSLTProcessor::transformToDocПреобразовывает в документ

Описание

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

Преобразовывает исходный узел в документ (например, в объект DOMDocument), применяя таблицу стилей, заданную методом XSLTProcessor::importStylesheet().

Список параметров

document

Объект класса DOMDocument, объект класса SimpleXMLElement или libxml-совместимый объект, который будет преобразован.

returnClass

Через этот необязательный параметр можно установить класс объекта, который вернёт XSLTProcessor::transformToDoc(). Этот класс должен либо расширять, либо быть объектом того же класса, который передан в параметр document.

Возвращаемые значения

Возвращает результирующий документ или false в случае возникновения ошибки.

Примеры

Пример #1 Преобразование в DOMDocument

<?php

// Загрузка исходного XML
$xml = new DOMDocument;
$xml->load('collection.xml');

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

// Настройка преобразования
$proc = new XSLTProcessor;
$proc->importStyleSheet($xsl); // добавление стилей xsl

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

?>

Результат выполнения приведённого примера:

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

Смотрите также

add a note

User Contributed Notes 1 note

up
1
franp at free dot fr
17 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.
To Top