XSLTProcessor::transformToDoc

(PHP 5, PHP 7, PHP 8)

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

Описание

public 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);

?>

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

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

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