PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

$data = new DOMDocument();
$data->load(__DIR__ . '/catalog.xml');
$rules = new DOMDocument();
$rules->load(__DIR__ . '/first.xsl');
$processor = new XSLTProcessor();
$processor->importStylesheet($rules);
echo 'Первый товар в отчёте: ', $processor->transformToXml($data), "\n";

Первый товар в отчёте: Desk

Конструктор не принимает аргументы и создаёт только процессор. Файлы данных и правил подготовлены отдельно; два следующих вызова импортируют правила и запускают преобразование. Второй пример ниже показывает конкретный Error, если этап импорта пропустить.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog/>');
$processor = new XSLTProcessor();
try {
    $processor->transformToXml($xml);
} catch (Error $error) {
    echo "Сначала импортируйте XSL\n";
}

Сначала импортируйте XSL

В актуальном PHP отсутствие импортированного шаблона приводит к Error. Это ошибка порядка вызовов, а не повод повторять запрос к поставщику.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="catalog/product[1]/title"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
echo $processor->transformToXml($xml), "\n";

Tea

loadXML понимает текст XML. importStylesheet понимает назначения xsl:template и xsl:value-of. Это разные этапы; разделяйте их ошибки.

<?php
declare(strict_types=1);

$previous = libxml_use_internal_errors(true);
libxml_clear_errors();
try {
    $rules = new DOMDocument();
    if ($rules->loadXML('<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><xsl:template match="/"><xsl:value-of select="["/></xsl:template></xsl:stylesheet>')) {
        echo "XML шаблона разобран\n";
    }
    $processor = new XSLTProcessor();
    if (!$processor->importStylesheet($rules)) {
        echo "Отчёт не запускаем: незавершённый XPath в select\n";
    }
} finally { libxml_clear_errors(); libxml_use_internal_errors($previous); }

XML шаблона разобран
Отчёт не запускаем: незавершённый XPath в select

В известном fixture одна [ допустима как текст XML-атрибута, но не как законченное XPath-выражение. Поэтому loadXML может быть успешным, а importStylesheet отказывает. Диагностика libxml содержит подробности; её не превращают в публичный HTML без ограничения/экранирования.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:for-each select="catalog/product"><xsl:value-of select="@sku"/><xsl:text>: </xsl:text><xsl:value-of select="title"/><xsl:text>&#10;</xsl:text></xsl:for-each></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$result = $processor->transformToXml($xml);
if ($result === false) {
    throw new RuntimeException('Не удалось сформировать отчёт');
}
echo $result ?? '';

A: Tea
B: Coffee

for-each перебирает выбранные product; @sku — атрибут; xsl:text явно сохраняет разделители и перевод строки. Итог можно вернуть HTTP-ответом или положить в письмо.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    $result = $processor->transformToXml($xml);
    if ($result === false) { echo "Ошибка формирования отчёта\n"; }
    elseif ($result === null || $result === '') { echo "Шаблон не вывел строк: отчёт пуст\n"; }
    else { echo $result; }

Шаблон не вывел строк: отчёт пуст

Шаблон намеренно пуст: преобразование не равно отказу. Условие if (!$result) смешало бы пустой успешный результат и false. В каталожном отчёте неожиданную пустоту стоит проверять по пути XPath и namespace.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="xml" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><summary><first><xsl:value-of select="catalog/product[1]/title"/></first></summary></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    $result = $processor->transformToDoc($xml);
    if (!$result instanceof DOMDocument) { throw new RuntimeException('Нет дерева отчёта'); }
    $result->documentElement->setAttribute('checked', 'yes');
    echo $result->saveXML($result->documentElement), "\n";

<summary checked="yes"><first>Tea</first></summary>

transformToDoc даёт новое дерево, поэтому сразу меняем его атрибут, без transformToXml→строка→loadXML. saveXML в конце нужен лишь для показа фактической структуры. Отметка checked здесь демонстрирует редактирование, не доказывает реальную складскую проверку.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="xml" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><summary>ready</summary></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
class ExportDocument extends DOMDocument
{
    public function status(): string
    {
        return $this->documentElement->textContent;
    }
}
$result = $processor->transformToDoc($xml, ExportDocument::class);
if (!$result instanceof ExportDocument) {
    throw new RuntimeException('Нет документа экспорта');
}
echo $result->status(), "\n";

ready

::class передаёт имя класса, а не создаёт объект. Пример показывает расширение DOMDocument; не рассчитывайте, что фабрика вызовет ваш пользовательский конструктор и его побочные действия.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:for-each select="catalog/product"><xsl:value-of select="@sku"/><xsl:text>: </xsl:text><xsl:value-of select="title"/><xsl:text>&#10;</xsl:text></xsl:for-each></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    $path = __DIR__ . '/export.txt';
    if ($processor->transformToUri($xml, $path) < 0) {
        throw new RuntimeException('Ведомость не сохранена');
    }
    echo file_get_contents($path);

A: Tea
B: Coffee

Числовой возврат сообщает запись/отказ, содержимое находится в export.txt. Выводим саму ведомость. Файл остаётся в учебной папке; этот метод всё равно строит результат преобразования в памяти libxslt и не является потоковым XMLReader.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    $path = __DIR__ . '/empty.txt';
    $written = $processor->transformToUri($xml, $path);
    if ($written < 0) { echo "Ошибка сохранения\n"; }
    elseif ($written === 0) { echo "empty.txt создан пустым: проверьте, ожидается ли пустой отчёт\n"; }

empty.txt создан пустым: проверьте, ожидается ли пустой отчёт

0 байтов допустим для успешного пустого преобразования. Отказ текущего PHP8.5.11 — отрицательное число. Существование файла не делает его подходящим для бизнес-задачи: наш оператор отдельно решает, почему отчёт не содержит строк.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="heading" select="'Catalog'"/><xsl:template match="/"><xsl:value-of select="$heading"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$heading = 'Products';
var_dump($processor->setParameter('', 'heading', $heading));
echo $processor->transformToXml($xml), "\n";

bool(true)
Products

PHP-переменная содержит строку Products. XSL-переменная с тем же именем получает её через явный мост setParameter. Вставка $heading в кавычках как текста не выполнит PHP-код.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="heading" select="'Catalog'"/><xsl:param name="currency" select="'RUB'"/><xsl:template match="/"><xsl:value-of select="$heading"/><xsl:text>: </xsl:text><xsl:value-of select="$currency"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->setParameter('', ['heading' => 'Price list', 'currency' => 'EUR']);
echo $processor->transformToXml($xml), "\n";

Price list: EUR

Второй аргумент — массив настроек, поэтому третий не передают. Неизвестный шаблону параметр не создаёт новый вывод автоматически: правила должны его использовать.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="heading" select="'Catalog'"/><xsl:template match="/"><xsl:value-of select="$heading"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->setParameter('', 'heading', 'Alice\'s "Tea"');
echo $processor->transformToXml($xml), "\n";

Alice's "Tea"

Обратная косая черта защищает одинарную кавычку в PHP-литерале. Не нужно заменять реальные кавычки на другие символы или включать disable-output-escaping.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:report="urn:report"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="report:heading" select="'Default'"/><xsl:template match="/"><xsl:value-of select="$report:heading"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->setParameter('urn:report', 'heading', 'Namespaced title');
echo $processor->transformToXml($xml), "\n";

Namespaced title

PHP передаёт URI urn:report и локальное имя heading; префикс report объявлен в XSL и может быть другим. Этот контракт namespace требует PHP 8.5, его нельзя переносить на 8.4 без проверки.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="position" select="'1'"/><xsl:template match="/"><xsl:value-of select="catalog/product[position() = number($position)]/title"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->setParameter('', 'position', '2');
echo $processor->transformToXml($xml), "\n";

Coffee

В XPath 1.0 product[$position] при строковом непустом $position проверяет истинность строки и может выбрать все товары. position() = number($position) выражает намерение явно. Внешнее значение позиции ещё надо проверить как допустимое целое.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="heading" select="'Catalog'"/><xsl:template match="/"><xsl:value-of select="$heading"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
var_dump($processor->getParameter('', 'heading'));
echo $processor->transformToXml($xml), "\n";
$processor->setParameter('', 'heading', 'Orders');
echo $processor->getParameter('', 'heading'), "\n";

bool(false)
Catalog
Orders

Шаблон уже знает Catalog, но процессор не имеет внешнего override. getParameter показывает только назначение через PHP; это удобно для журнала конфигурации отчёта.

<?php
declare(strict_types=1);

$processor = new XSLTProcessor();
$processor->setParameter('', 'heading', '');
if ($processor->getParameter('', 'heading') === '') {
    echo "Заголовок явно оставлен пустым\n";
}
if ($processor->getParameter('', 'missing') === false) {
    echo "Внешняя настройка missing не задана\n";
}

Заголовок явно оставлен пустым
Внешняя настройка missing не задана

getParameter читает параметры, назначенные PHP, а не select/default внутри XSL. Пустая строка существует как значение; false означает отсутствие. Для возвращения default используют removeParameter, а не пустую строку.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="heading" select="'Catalog'"/><xsl:template match="/"><xsl:value-of select="$heading"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->setParameter('', 'heading', 'Special');
echo $processor->transformToXml($xml), "\n";
var_dump($processor->removeParameter('', 'heading'));
echo $processor->transformToXml($xml), "\n";
var_dump($processor->removeParameter('', 'heading'));

Special
bool(true)
Catalog
bool(false)

Повторное удаление возвращает false, потому что первого назначения уже нет. Это удобно в рабочем процессе, где один шаблон служит нескольким экспортам.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:param name="heading" select="'Catalog'"/><xsl:template match="/"><xsl:value-of select="$heading"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->setParameter('', 'heading', '');
var_dump($processor->transformToXml($xml));
$processor->removeParameter('', 'heading');
echo $processor->transformToXml($xml), "\n";

NULL
Catalog

Пустой override просит вывести пустое значение. Удаление возвращает Catalog. Не пытайтесь очистить конфигурацию заменой всех параметров на пустые строки.

<?php
declare(strict_types=1);

$processor = new XSLTProcessor();
$mask = $processor->getSecurityPrefs();
echo ($mask & XSL_SECPREF_WRITE_FILE) !== 0 ? "Запись из XSLT запрещена\n" : "Запись из XSLT разрешена\n";
echo ($mask & XSL_SECPREF_READ_FILE) !== 0 ? "Чтение из XSLT запрещено\n" : "Чтение из XSLT не запрещено этой маской\n";

Запись из XSLT запрещена
Чтение из XSLT не запрещено этой маской

& проверяет отдельный бит маски. Это диагностический первый шаг: по умолчанию запреты записи не означают запрет чтения. Они относятся к transform libxslt, а не ко всем операциям PHP; рабочий пример отказа document() приведён в setter.

<?php
declare(strict_types=1);

$processor = new XSLTProcessor();
$processor->setSecurityPrefs(XSL_SECPREF_DEFAULT | XSL_SECPREF_READ_NETWORK);
$blocked = ($processor->getSecurityPrefs() & XSL_SECPREF_READ_NETWORK) !== 0;
echo $blocked ? "XSLT network read blocked\n" : "XSLT network read not blocked\n";

XSLT network read blocked

Это проверка настройки, без реального сетевого запроса. Она не утверждает, что PHP-callback, DOM load или импорт шаблона охватывается той же границей.

<?php
declare(strict_types=1);

$processor = new XSLTProcessor();
$denyAll = XSL_SECPREF_READ_FILE | XSL_SECPREF_WRITE_FILE
    | XSL_SECPREF_CREATE_DIRECTORY | XSL_SECPREF_READ_NETWORK
    | XSL_SECPREF_WRITE_NETWORK;
$previous = $processor->setSecurityPrefs($denyAll);
var_dump($previous === XSL_SECPREF_DEFAULT);
var_dump($processor->getSecurityPrefs() === $denyAll);
$processor->setSecurityPrefs($previous);

bool(true)
bool(true)

Полезно для доверенного шаблона, которому не нужны document() и дополнительные файлы. Сам XML и XSL должны также загружаться с подходящими ограничениями libxml.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="document('extra.xml')/extra"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    $processor->setSecurityPrefs(XSL_SECPREF_DEFAULT | XSL_SECPREF_READ_FILE);
    $previous = libxml_use_internal_errors(true);
    libxml_clear_errors();
    try {
        if ($processor->transformToXml($xml) === false) {
            echo "Отчёт отклонён: шаблону запрещено дополнительное чтение\n";
        }
    } finally { libxml_clear_errors(); libxml_use_internal_errors($previous); }

Отчёт отклонён: шаблону запрещено дополнительное чтение

extra.xml реально находится в учебной папке. Причина отказа — настройка READ_FILE, а не отсутствующий fixture. Запрет трансформации не заменяет контроль xsl:include/import при компиляции и не ограничивает произвольный PHP callback.

<?php
declare(strict_types=1);

$processor = new XSLTProcessor();
echo $processor->hasExsltSupport() ? "EXSLT available\n" : "EXSLT unavailable\n";

EXSLT available

Ожидаемый результат относится к проверенной сборке PHP 8.5.11. На другом сервере ветка unavailable — допустимый результат проверки, а не поломка кода.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:variable name="temporary"><item>Tea</item><item>Coffee</item></xsl:variable><xsl:for-each select="exsl:node-set($temporary)/item"><xsl:value-of select="."/><xsl:text>&#10;</xsl:text></xsl:for-each></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    if (!$processor->hasExsltSupport()) { throw new RuntimeException('Этот шаблон требует EXSLT'); }
    echo $processor->transformToXml($xml);

Tea
Coffee

В XSLT1.0 временный фрагмент результата ещё не node-set для такого обхода. exsl:node-set превращает его в доступный набор узлов; теперь foreach выдаёт названия. Поддержка EXSLT не означает XSLT2/3; конкретную функцию также можно проверить в XSL через function-available.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="catalog/product[1]/title"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);

    $profile = __DIR__ . '/xsl-profile.txt';
    $processor->setProfiling($profile);
    echo 'Результат: ', $processor->transformToXml($xml), "\n";
    $processor->setProfiling(null);
    $text = file_get_contents($profile);
    if ($text === false || !preg_match('/^\s*0\s+\/\s+(\d+)\s+/m', $text, $match)) {
        throw new RuntimeException('Не найдена строка корневого шаблона в профиле');
    }
    echo 'Профиль: шаблон / выполнен ', $match[1], " раз\n";

Результат: Tea
Профиль: шаблон / выполнен 1 раз

Полный xsl-profile.txt остаётся рядом и содержит также меняющиеся времена. Для точного учебного вывода извлечена стабильная строка имени/числа вызовов из профиля проверенной libxslt. Это доказывает реальное выполнение шаблона, а не только наличие пустого файла. При другой форме профиля используйте сам файл; настройка пути возвращает true до записи.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="catalog/product[1]/title"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$profile = __DIR__ . '/disabled-profile.txt';
$processor->setProfiling($profile);
$processor->setProfiling(null);
echo $processor->transformToXml($xml), "\n";
var_dump(is_file($profile));

Tea
bool(false)

Настройка пути сама не создаёт файл. Профилирование имеет накладные расходы и обычно включается на время измерения конкретного медленного отчёта.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="php:function('strtoupper', string(catalog/product[1]/title))"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->registerPHPFunctions('strtoupper');
echo $processor->transformToXml($xml), "\n";

TEA

В XSL объявлен префикс php. Первый аргумент php:function — разрешённое имя. string(...) преобразует набор узлов в текст до входа в PHP; strtoupper здесь работает с ASCII-названием.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="php:function('stockLabel', number(catalog/product[1]/price))"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->registerPHPFunctions([
    'stockLabel' => static function (float $price): string {
        return $price >= 400 ? 'premium' : 'regular';
    },
]);
echo $processor->transformToXml($xml), "\n";

regular

Именем stockLabel шаблон обращается к callable, а не обязательно к глобальной одноимённой PHP-функции. XPath 1.0 передаёт числа как float; поэтому контракт callback должен это учитывать.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:shop="urn:shop"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="shop:label(string(catalog/product[1]/title))"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->registerPHPFunctionNS('urn:shop', 'label',
    static fn (string $title): string => 'Product: ' . $title
);
echo $processor->transformToXml($xml), "\n";

Product: Tea

Префикс shop связывается с urn:shop внутри XSL. registerPHPFunctionNS использует URI и локальное label. PHP return возвращает строку в value-of, после чего продолжается тот же шаблон.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:shop="urn:shop"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="shop:countExpensive(catalog/product)"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->registerPHPFunctionNS('urn:shop', 'countExpensive',
    static function (array $products): int {
        $count = 0;
        foreach ($products as $product) {
            $price = (int) $product->getElementsByTagName('price')->item(0)->textContent;
            if ($price >= 400) {
                $count++;
            }
        }
        return $count;
    }
);
echo $processor->transformToXml($xml), "\n";

1

Здесь массив содержит DOMElement, не строки. Форма XML полностью известна, поэтому price есть у каждого товара; для внешнего каталога нужны проверки отсутствия/формата. Простой порог можно выразить XPath; callback полезен, когда требуется уже существующее правило PHP, а не ради усложнения.

<?php
declare(strict_types=1);

$xml = new DOMDocument();
$xml->loadXML('<catalog><product sku="A"><title>Tea</title><price>250</price></product><product sku="B"><title>Coffee</title><price>450</price></product></catalog>');
$xsl = new DOMDocument();
$xsl->loadXML(<<<'XSL'
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:shop="urn:shop"><xsl:output method="text" encoding="UTF-8" omit-xml-declaration="yes"/><xsl:template match="/"><xsl:value-of select="shop:fail()"/></xsl:template></xsl:stylesheet>
XSL);
$processor = new XSLTProcessor();
$processor->importStylesheet($xsl);
$processor->registerPHPFunctionNS('urn:shop', 'fail', static function (): string {
    throw new DomainException('Unknown customer');
});
$previous = libxml_use_internal_errors(true);
try {
    $processor->transformToXml($xml);
} catch (DomainException $error) {
    echo $error->getMessage(), "\n";
} finally {
    libxml_clear_errors();
    libxml_use_internal_errors($previous);
}

Unknown customer

Исключение из PHP не нужно превращать в «товаров нет». Обработчик задания решает, можно ли повторить операцию или надо исправить данные.