XSLTProcessor::transformToDoc

(PHP 5, PHP 7, PHP 8)

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

Описание

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

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

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

document: Объект, который требуется преобразовать. Параметр принимает объект класса Dom\Document, DOMDocument, SimpleXMLElement или объект, который совместим с библиотекой libxml.
returnClass: Через этот необязательный параметр устанавливают класс объекта, который вернёт метод XSLTProcessor::transformToDoc(). В параметр передают название класса, который либо расширяет, либо принадлежит тому же классу, который передали в параметр document.

Ошибки

При работе с выражением, в котором вызывают PHP-функции обратного вызова, возникают следующие ошибки:

Метод выбрасывает ошибку Error, если в выражении вызвали PHP-функцию обратного вызова, но ни одной callback-функции не регистрировали, или если callback-функцию с таким названием не зарегистрировали.
Метод выбрасывает ошибку TypeError, если при вызове функции из XPath-выражения синтаксисом php:function вместо строкового названия обработчика передают значение другого типа.
Метод выбрасывает ошибку Error, если callback-функция вместо DOM-объекта возвращает значение другого типа.

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

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

Список изменений

Версия	Описание
8.4.0	Вместо предупреждения метод теперь выбрасывает ошибку Error, если callback-функцию невозможно вызвать.
8.4.0	Добавили поддержку объектов класса Dom\Document.

Примеры

Пример #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);

?>

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

Привет! Добро пожаловать в замечательную коллекцию компакт-дисков Николаса Элиашевича!

Пример #2 Пример преобразования узла в объект класса Dom\Document

<?php

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

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

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

?>

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

Привет! Добро пожаловать в замечательную коллекцию компакт-дисков Николаса Элиашевича!

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

XSLTProcessor::transformToUri() - Преобразовывает в URI-идентификатор
XSLTProcessor::transformToXml() - Преобразовывает в XML-строку

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 1 note

down

franp at free dot fr ¶

19 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.

＋Добавить