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

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<price>7</price>');
$reader->read();
echo $reader->name, ': ', $reader->readString(), "\n";
$reader->close();

price: 7

readString читает текст элемента. Полученная 7 пока строка; допустимость цены проверяет код приложения.

<?php
declare(strict_types=1);

try {
    XMLReader::fromString('<price/>', 'not-an-encoding');
} catch (ValueError $error) { echo "invalid encoding\n"; }

invalid encoding

Ошибка настройки не равна повреждению XML. Внешнему клиенту не нужно показывать внутренний текст исключения; сохраните ограниченную диагностику в журнал.

<?php
declare(strict_types=1);

$reader = XMLReader::fromUri(__DIR__ . '/catalog.xml');
try {
    while ($reader->read()) {
        if ($reader->nodeType === XMLReader::ELEMENT && $reader->name === 'product') {
            echo $reader->getAttribute('sku'), ': ', $reader->readString(), "\n";
        }
    }
} finally { $reader->close(); }

A1: Desk
B2: Lamp

fromUri сPHP8.4 возвращает новый reader. Товары здесь имеют текст прямо внутри product; readString не годится для раздельных name/stock, потому что объединяет весь текст потомков. Проверка ELEMENT исключает повторное чтение закрывающего product.

<?php
declare(strict_types=1);

try { XMLReader::fromUri(''); }
catch (ValueError $error) { echo "empty source path\n"; }

empty source path

Пустой адрес — ошибка аргумента, а не пустой каталог. Не подменяйте отсутствие файла успешным импортом нуля товаров.

<?php
declare(strict_types=1);

$stream = fopen('php://temp', 'w+b');
fwrite($stream, '<order>42</order>');
rewind($stream);
$reader = XMLReader::fromStream($stream);
try { $reader->read(); echo 'Заказ № ', $reader->readString(), "\n"; }
finally { $reader->close(); }
rewind($stream);
echo 'Исходный поток после close: ', stream_get_contents($stream), "\n";
fclose($stream);

Заказ № 42
Исходный поток после close: <order>42</order>

Только что записанный поток находится в конце — rewind ставит его в начало перед передачей читателю. close завершает reader, но наш ресурс остаётся доступен: это доказано повторным чтением исходных байтов. Его fclose выполняет владелец. Возможность rewind у сетевого потока не гарантирована.

<?php
declare(strict_types=1);

$stream = fopen('php://temp', 'w+b');
if ($stream === false) { throw new RuntimeException('No stream'); }
fwrite($stream, "DATA\n<order>43</order>");
fseek($stream, 5);
$reader = XMLReader::fromStream($stream, documentUri: 'urn:shop:import');
try { $reader->read(); echo $reader->readString(), "\n"; }
finally { $reader->close(); fclose($stream); }

43

Пять байтов пропускаются только потому, что это известный формат учебного контейнера. Случайный мусор перед XML не надо молча «чинить» поиском первого знака <. Для сетевого потока возможность seek не гарантирована.

<?php
declare(strict_types=1);

$reader = new XMLReader();
if (!$reader->open(__DIR__ . '/order.xml')) { throw new RuntimeException('Cannot load XML'); }
$reader->read();
echo $reader->name, ': ', $reader->readString(), "\n";
$reader->close();

order: 42

Возвращаемое true не содержит сам XML и не доказывает корректность всего документа. Объект остаётся в $reader.

<?php
declare(strict_types=1);

$reader = XMLReader::open(__DIR__ . '/order.xml');
if ($reader === false) { throw new RuntimeException('Cannot load XML'); }
try { $reader->read(); echo $reader->readString(), "\n"; }
finally { $reader->close(); }

42

В PHP 8.4+ для нового кода фабрика fromUri делает договор однозначнее: объект либо исключение. Старые формы нужны при сопровождении и совместимости с PHP 8.2/8.3.

<?php
declare(strict_types=1);

$reader = new XMLReader();
if (!$reader->XML('<order>42</order>')) { throw new RuntimeException('Cannot load XML'); }
$reader->read();
echo $reader->name, ': ', $reader->readString(), "\n";
$reader->close();

order: 42

Возвращаемое true не содержит сам XML и не доказывает корректность всего документа. Объект остаётся в $reader.

<?php
declare(strict_types=1);

$reader = XMLReader::XML('<order>42</order>');
if ($reader === false) { throw new RuntimeException('Cannot load XML'); }
try { $reader->read(); echo $reader->readString(), "\n"; }
finally { $reader->close(); }

42

В PHP 8.4+ для нового кода фабрика fromString делает договор однозначнее: объект либо исключение. Старые формы нужны при сопровождении и совместимости с PHP 8.2/8.3.

<?php
declare(strict_types=1);

$reader = XMLReader::XML('<catalog><product sku="A1">Desk</product><product sku="B2">Lamp</product></catalog>');
if ($reader === false) { throw new RuntimeException('Нет читателя'); }
try {
    while ($reader->read()) {
        if ($reader->nodeType === XMLReader::ELEMENT && $reader->name === 'product') {
            echo 'Первый товар: ', $reader->readString(), "\n";
            break;
        }
    }
} finally { $reader->close(); }
echo "Читатель закрыт после первого товара\n";

Первый товар: Desk
Читатель закрыт после первого товара

Для задачи предварительного просмотра хватает первого товара. close освобождает вход даже после break; его true не означает проверку непрочитанного хвоста. Полный импорт должен дочитать и оценить диагностику. Для поиска назад проще новое чтение либо дерево.

<?php
declare(strict_types=1);

$reader = new XMLReader();
$reader->XML('<order>42</order>');
$reader->read();
echo 'Заказ: ', $reader->readString(), "\n";
$reader->close();
$reader->XML('<shipment>SH-42</shipment>');
$reader->read();
echo 'Отправление: ', $reader->readString(), "\n";
$reader->close();

Заказ: 42
Отправление: SH-42

Это два независимых документа, а не продолжение старого курсора. После close задаём новый вход XML и снова вызываем read. В крупном приложении отдельный reader на документ часто понятнее повторного использования.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A"/>');
$reader->read();
echo $reader->getAttribute('sku'), "\n";
echo $reader->name, "\n";
$reader->close();

A
product

Сначала read ставит на элемент. Дополнительный read перед получением атрибута мог бы уже увести курсор внутрь или за пределы нужного товара.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku=""/>');
$reader->read();
$empty = $reader->getAttribute('sku');
$missing = $reader->getAttribute('missing');
if ($empty === '') { echo "Артикул передан пустым: заполнить значение\n"; }
if ($missing === null) { echo "Искомого атрибута нет: проверить имя и формат\n"; }
$reader->close();

Артикул передан пустым: заполнить значение
Искомого атрибута нет: проверить имя и формат

get-метод не перемещает курсор. Пустая строка и null приводят к разным подсказкам: у значения нет текста либо выбранного атрибута вообще нет. В обоих случаях складской импорт здесь должен отклонить товар, а не придумать новый артикул.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A"/>');
$reader->read();
echo $reader->getAttributeNo(0), "\n";
echo $reader->name, "\n";
$reader->close();

A
product

Сначала read ставит на элемент. Дополнительный read перед получением атрибута мог бы уже увести курсор внутрь или за пределы нужного товара.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku=""/>');
$reader->read();
$empty = $reader->getAttributeNo(0);
$missing = $reader->getAttributeNo(5);
if ($empty === '') { echo "Артикул передан пустым: заполнить значение\n"; }
if ($missing === null) { echo "Искомого атрибута нет: проверить имя и формат\n"; }
$reader->close();

Артикул передан пустым: заполнить значение
Искомого атрибута нет: проверить имя и формат

get-метод не перемещает курсор. Пустая строка и null приводят к разным подсказкам: у значения нет текста либо выбранного атрибута вообще нет. В обоих случаях складской импорт здесь должен отклонить товар, а не придумать новый артикул.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product xmlns:s="urn:shop" s:sku="A"/>');
$reader->read();
echo $reader->getAttributeNs('sku', 'urn:shop'), "\n";
echo $reader->name, "\n";
$reader->close();

A
product

Сначала read ставит на элемент. Дополнительный read перед получением атрибута мог бы уже увести курсор внутрь или за пределы нужного товара.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product xmlns:s="urn:shop" s:sku=""/>');
$reader->read();
$empty = $reader->getAttributeNs('sku', 'urn:shop');
$missing = $reader->getAttributeNs('missing', 'urn:shop');
if ($empty === '') { echo "Артикул передан пустым: заполнить значение\n"; }
if ($missing === null) { echo "Искомого атрибута нет: проверить имя и формат\n"; }
$reader->close();

Артикул передан пустым: заполнить значение
Искомого атрибута нет: проверить имя и формат

get-метод не перемещает курсор. Пустая строка и null приводят к разным подсказкам: у значения нет текста либо выбранного атрибута вообще нет. В обоих случаях складской импорт здесь должен отклонить товар, а не придумать новый артикул.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<s:product xmlns:s="urn:shop"/>');
$reader->read();
echo $reader->lookupNamespace('s'), "\n";
var_dump($reader->lookupNamespace('unknown'));
$reader->close();

urn:shop
NULL

Неизвестный префикс не подменяется пустым namespace. Сравнивайте результат с null до использования.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<root xmlns:s="urn:one"><child xmlns:s="urn:two"/></root>');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT) {
        echo $reader->name, ': ', $reader->lookupNamespace('s'), "\n";
    }
}
$reader->close();

root: urn:one
child: urn:two

Кеш вида «s всегда означает urn:one» для всего документа был бы ошибочным. Анализируйте namespace в месте текущего узла.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A"/>');
$reader->read();
if ($reader->moveToAttribute('sku')) { echo $reader->localName, ': ', $reader->value, "\n"; }
$reader->moveToElement();
echo $reader->name, "\n";
$reader->close();

sku: A
product

Значение атрибута читается через value. readString относится к содержимому узла и не заменяет этот способ чтения атрибута.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A"/>');
$reader->read();
if (!$reader->moveToAttribute('unknown')) { echo "attribute not found\n"; }
$reader->close();

attribute not found

Всегда проверяйте bool. Чтение текущих полей после false может дать данные прежнего положения, а не искомого атрибута.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A"/>');
$reader->read();
if ($reader->moveToAttributeNo(0)) { echo $reader->localName, ': ', $reader->value, "\n"; }
$reader->moveToElement();
echo $reader->name, "\n";
$reader->close();

sku: A
product

Значение атрибута читается через value. readString относится к содержимому узла и не заменяет этот способ чтения атрибута.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A"/>');
$reader->read();
if (!$reader->moveToAttributeNo(4)) { echo "attribute not found\n"; }
$reader->close();

attribute not found

Всегда проверяйте bool. Чтение текущих полей после false может дать данные прежнего положения, а не искомого атрибута.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product xmlns:s="urn:shop" s:sku="A"/>');
$reader->read();
if ($reader->moveToAttributeNs('sku', 'urn:shop')) { echo $reader->localName, ': ', $reader->value, "\n"; }
$reader->moveToElement();
echo $reader->name, "\n";
$reader->close();

sku: A
product

Значение атрибута читается через value. readString относится к содержимому узла и не заменяет этот способ чтения атрибута.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product xmlns:s="urn:shop" s:sku="A"/>');
$reader->read();
if (!$reader->moveToAttributeNs('sku', 'urn:other')) { echo "attribute not found\n"; }
$reader->close();

attribute not found

Всегда проверяйте bool. Чтение текущих полей после false может дать данные прежнего положения, а не искомого атрибута.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A" qty="2"/>');
$reader->read();
if ($reader->moveToFirstAttribute()) { echo $reader->name, '=', $reader->value, "\n"; }
$reader->moveToElement(); $reader->close();

sku=A

Для изучения входного договора полезно видеть имена. В бизнес-логике выбирают атрибут по согласованному имени, а не позиции.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product/>');
$reader->read();
if (!$reader->moveToFirstAttribute()) {
    echo "У product нет атрибутов: нельзя определить sku\n";
}
$reader->close();

У product нет атрибутов: нельзя определить sku

false означает отсутствие подходящего атрибута, а не ошибку XML. Следующий шаг зависит от договора: для нашего каталога sku обязателен. Если нужен только один известный атрибут, getAttribute("sku") проще полного обхода.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A" qty="2"/>');
$reader->read();
$attributes = [];
while ($reader->moveToNextAttribute()) { $attributes[$reader->name] = $reader->value; }
$reader->moveToElement();
echo json_encode($attributes, JSON_THROW_ON_ERROR), "\n";
$reader->close();

{"sku":"A","qty":"2"}

Значения остались строками. Дальше qty можно проверить как целое, а sku — по ограничениям поставщика; сам XMLReader этого не делает.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product xmlns:s="urn:shop" s:sku="A"/>');
$reader->read();
while ($reader->moveToNextAttribute()) {
    if ($reader->namespaceURI === 'urn:shop') {
        echo $reader->localName, ': ', $reader->value, "\n";
    }
}
$reader->moveToElement(); $reader->close();

sku: A

Здесь фильтруется URI атрибута, поэтому служебное объявление xmlns не попадает в бизнес-поля. Префикс s отправитель может заменить другим, сохранив URI.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A">Tea</product>');
$reader->read();
$reader->moveToAttribute('sku'); echo $reader->value, "\n";
$reader->moveToElement(); echo $reader->readString(), "\n";
$reader->close();

A
Tea

Сначала value означало артикул, затем readString читает текст товара. Поля reader всегда относятся к текущему положению.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><product/></catalog>');
$reader->read(); $reader->read();
var_dump($reader->moveToElement());
echo $reader->name, "\n";
$reader->close();

bool(false)
product

Курсор уже стоял на элементе product. Для произвольного движения вверх/назад требуется дерево DOM или сохранённый отдельный фрагмент.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<price>7</price>');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT) { echo 'start: ', $reader->name, "\n"; }
    elseif ($reader->nodeType === XMLReader::TEXT) { echo 'text: ', $reader->value, "\n"; }
    elseif ($reader->nodeType === XMLReader::END_ELEMENT) { echo 'end: ', $reader->name, "\n"; }
}
$reader->close();

start: price
text: 7
end: price

XMLReader выдаёт узлы, а не строки текстового файла. Один узел может занимать много строк, а одна строка — содержать много узлов.

<?php
declare(strict_types=1);

$old = libxml_use_internal_errors(true);
libxml_clear_errors();
$reader = XMLReader::fromString('<catalog><product></catalog>');
try {
    while ($reader->read()) { /* Здесь могла бы идти обработка узлов. */ }
    echo libxml_get_errors() === [] ? "accepted\n" : "invalid XML\n";
} finally {
    $reader->close(); libxml_clear_errors(); libxml_use_internal_errors($old);
}

invalid XML

Для важного импорта сначала складывайте результаты в промежуточное хранилище и публикуйте после полного успешного разбора. Иначе ошибка в конце файла оставит наполовину обновлённый каталог. Производственная политика может различать warning/error; здесь учебная строгая политика отклоняет любую диагностику.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><product sku="A"><details/></product><product sku="B"/></catalog>');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT && $reader->localName === 'product' && $reader->depth === 1) { break; }
}
while ($reader->nodeType === XMLReader::ELEMENT && $reader->localName === 'product' && $reader->depth === 1) {
    echo $reader->getAttribute('sku'), "\n";
    if (!$reader->next('product')) { break; }
}
$reader->close();

A
B

После next курсор уже находится на следующем товаре. Безусловный read в начале второго цикла мог бы пропустить его открывающий тег. Проверка глубины удерживает выбранную форму каталога.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><history><event/><event/></history><product sku="A"/></catalog>');
$reader->read(); $reader->read();
echo $reader->name, "\n";
if ($reader->next()) { echo $reader->name, "\n"; }
$reader->close();

history
product

Дочерние event не выдаются приложению по одному. Сам парсер всё равно должен прочитать байты и учитывать структуру; next не является бесплатным произвольным seek по XML.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<description>Hello <b>Tea</b>!</description>');
$reader->read();
echo $reader->readString(), "\n";
echo $reader->name, "\n";
$reader->close();

Hello Tea!
description

Вложенное b не попадает в текст, но его содержимое Tea сохраняется. Для вывода в HTML нужен осознанный договор: XML/сырой текст не становятся безопасным HTML автоматически.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><name>Tea</name><name>Coffee</name></catalog>');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT && $reader->name === 'name') {
        echo $reader->readString(), "\n";
    }
}
$reader->close();

Tea
Coffee

Строка одного элемента обрабатывается и отпускается. Если складывать все строки в массив, общий объём памяти снова вырастет вместе с файлом. readString объединяет текст потомков и не сохраняет границы полей; для структурированных данных читайте отдельные элементы.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<description>Hello <b>Tea</b>!</description>');
$reader->read();
echo $reader->readInnerXml(), "\n";
echo $reader->name, "\n";
$reader->close();

Hello <b>Tea</b>!
description

Вложенное b сохраняется как разметка. Для вывода в HTML нужен осознанный договор: XML/сырой текст не становятся безопасным HTML автоматически.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><name>Tea</name><name>Coffee</name></catalog>');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT && $reader->name === 'name') {
        echo $reader->readInnerXml(), "\n";
    }
}
$reader->close();

Tea
Coffee

Строка одного элемента обрабатывается и отпускается. Если складывать все строки в массив, общий объём памяти снова вырастет вместе с файлом. readString объединяет текст потомков и не сохраняет границы полей; для структурированных данных читайте отдельные элементы.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<description>Hello <b>Tea</b>!</description>');
$reader->read();
echo $reader->readOuterXml(), "\n";
echo $reader->name, "\n";
$reader->close();

<description>Hello <b>Tea</b>!</description>
description

Вложенное b сохраняется как разметка. Для вывода в HTML нужен осознанный договор: XML/сырой текст не становятся безопасным HTML автоматически.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><name>Tea</name><name>Coffee</name></catalog>');
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT && $reader->name === 'name') {
        echo $reader->readOuterXml(), "\n";
    }
}
$reader->close();

<name>Tea</name>
<name>Coffee</name>

Строка одного элемента обрабатывается и отпускается. Если складывать все строки в массив, общий объём памяти снова вырастет вместе с файлом. readString объединяет текст потомков и не сохраняет границы полей; для структурированных данных читайте отдельные элементы.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<catalog><product sku="A"><name>Tea</name></product></catalog>');
$reader->read(); $reader->read();
$document = new DOMDocument();
$product = $reader->expand($document);
if (!$product instanceof DOMElement) { throw new RuntimeException('Expected product'); }
echo $product->getAttribute('sku'), ': ', $product->getElementsByTagName('name')->item(0)->textContent, "\n";
$reader->close();

A: Tea

Вместо дерева всего каталога создаётся дерево одной записи. Это удобно, если товар сложный, а XMLReader нужен для ограничения общего накопления.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A1">Desk</product>');
$reader->read();
$document = new DOMDocument();
$copy = $reader->expand($document);
if (!$copy instanceof DOMElement) { throw new RuntimeException('Нет элемента товара'); }
$copy->setAttribute('available', 'yes');
$document->appendChild($copy);
echo 'Новый документ: ', $document->saveXML($copy), "\n";
echo 'Исходная запись: ', $reader->readOuterXml(), "\n";
$reader->close();

Новый документ: <product sku="A1" available="yes">Desk</product>
Исходная запись: <product sku="A1">Desk</product>

expand копирует поддерево в контекст owner document, но не вставляет его: appendChild сделан явно. Видно, что атрибут добавлен только в новый документ. Это старый DOMNode API, не новый Dom\Node PHP8.4.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product/>');
echo $reader->getParserProperty(XMLReader::VALIDATE)
    ? "DTD-проверка включена\n" : "DTD-проверка не включена: схему ещё не задавали\n";
$reader->close();

DTD-проверка не включена: схему ещё не задавали

Первый аргумент — конкретная XMLReader-константа настройки, не LIBXML-флаг. false означает выключенный режим, а не отказ функции. Это отчёт о настройке; результат проверки документа даёт другой метод isValid.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product/>');
try { $reader->getParserProperty(9999); }
catch (ValueError $error) { echo "unknown parser property\n"; }
finally { $reader->close(); }

unknown parser property

Константы разных библиотек нельзя подставлять друг вместо друга только потому, что обе имеют тип int.

<?php
declare(strict_types=1);

$xml = '<!DOCTYPE product [<!ENTITY shop "Tea">]><product>&shop;</product>';
$reader = XMLReader::fromString($xml);
var_dump($reader->setParserProperty(XMLReader::SUBST_ENTITIES, true));
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::TEXT) { echo $reader->value, "\n"; }
}
$reader->close();

bool(true)
Tea

Сущность объявлена внутри полностью известного учебного XML. Это не рекомендация включать подстановку для любых документов посетителя: внешняя сущность может запросить файл или адрес.

<?php
declare(strict_types=1);

$xml = '<!DOCTYPE product [<!ELEMENT product EMPTY><!ATTLIST product currency CDATA "RUB">]><product/>';
$reader = XMLReader::fromString($xml);
$reader->setParserProperty(XMLReader::DEFAULTATTRS, true);
while ($reader->read()) {
    if ($reader->nodeType === XMLReader::ELEMENT) { echo $reader->getAttribute('currency'), "\n"; }
}
$reader->close();

RUB

Атрибут появился благодаря DTD, хотя его не было в открывающем теге. Если различие важно для импорта, учитывайте isDefault на выбранном атрибуте. Пример не делает внешних чтений.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A1"/>');
while ($reader->read()) {}
if (!$reader->isValid()) {
    echo "Подтверждения схемы нет: сначала подключите договор каталога\n";
}
$reader->close();

Подтверждения схемы нет: сначала подключите договор каталога

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

<?php
declare(strict_types=1);

$xml = '<!DOCTYPE catalog [<!ELEMENT catalog (product*)><!ELEMENT product EMPTY><!ATTLIST product sku CDATA #REQUIRED>]><catalog><product sku="A1"/></catalog>';
$reader = XMLReader::fromString($xml);
$reader->setParserProperty(XMLReader::VALIDATE, true);
while ($reader->read()) {}
echo $reader->isValid() ? "Каталог соответствует DTD: у товаров есть sku\n" : "Каталог нарушает DTD\n";
$reader->close();

Каталог соответствует DTD: у товаров есть sku

DTD объявлена прямо в известном документе: catalog допускает повторения product, у каждого требуется sku. Атрибут может быть пустым текстом и всё же пройти эту DTD — заполненность и существование артикула остаются прикладными проверками. Внешних зависимостей нет.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<quantity>2</quantity>');
if (!$reader->setSchema(__DIR__ . '/quantity.xsd')) { throw new RuntimeException('Схема не подключена'); }
while ($reader->read()) {}
echo $reader->isValid() ? "Количество 2 принято\n" : "Формат не принят\n";
$reader->close();

Количество 2 принято

Сначала назначаем схему, затем полностью читаем, только потом принимаем документ. XSD требует quantity типа positiveInteger. Своя схема входит в пример; приложение выбирает её независимо от XML.

<?php
declare(strict_types=1);

$old = libxml_use_internal_errors(true);
libxml_clear_errors();
$reader = XMLReader::fromString('<quantity>0</quantity>');
try {
    if (!$reader->setSchema(__DIR__ . '/quantity.xsd')) { throw new RuntimeException('Схема не подключена'); }
    while ($reader->read()) {}
    if (!$reader->isValid()) { echo "Количество 0 запрещено: схема требует положительное целое\n"; }
} finally { $reader->close(); libxml_clear_errors(); libxml_use_internal_errors($old); }

Количество 0 запрещено: схема требует положительное целое

Угловые скобки здесь правильные. Отказ относится к правилам известной схемы. Причина вывода описывает именно подготовленный fixture; для произвольного файла нужна его диагностика. Следующая попытка не наследует сообщения этой проверки.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A1"/>');
if (!$reader->setRelaxNGSchema(__DIR__ . '/product.rng')) { throw new RuntimeException('Схема не подключена'); }
while ($reader->read()) {}
echo $reader->isValid() ? "Товар A1 соответствует формату\n" : "Формат не принят\n";
$reader->close();

Товар A1 соответствует формату

Сначала назначаем схему, затем полностью читаем, только потом принимаем документ. RelaxNG требует product с атрибутом sku и без дочернего содержимого. Своя схема входит в пример; приложение выбирает её независимо от XML.

<?php
declare(strict_types=1);

$old = libxml_use_internal_errors(true);
libxml_clear_errors();
$reader = XMLReader::fromString('<product/>');
try {
    if (!$reader->setRelaxNGSchema(__DIR__ . '/product.rng')) { throw new RuntimeException('Схема не подключена'); }
    while ($reader->read()) {}
    if (!$reader->isValid()) { echo "Товар отклонён: схема требует атрибут sku\n"; }
} finally { $reader->close(); libxml_clear_errors(); libxml_use_internal_errors($old); }

Товар отклонён: схема требует атрибут sku

Угловые скобки здесь правильные. Отказ относится к правилам известной схемы. Причина вывода описывает именно подготовленный fixture; для произвольного файла нужна его диагностика. Следующая попытка не наследует сообщения этой проверки.

<?php
declare(strict_types=1);

$reader = XMLReader::fromString('<product sku="A1"/>');
if (!$reader->setRelaxNGSchemaSource('<element xmlns="http://relaxng.org/ns/structure/1.0" name="product"><attribute name="sku"><text/></attribute><empty/></element>')) { throw new RuntimeException('Схема не подключена'); }
while ($reader->read()) {}
echo $reader->isValid() ? "Товар A1 соответствует формату\n" : "Формат не принят\n";
$reader->close();

Товар A1 соответствует формату

Сначала назначаем схему, затем полностью читаем, только потом принимаем документ. RelaxNG требует product с атрибутом sku и без дочернего содержимого. Своя схема входит в пример; приложение выбирает её независимо от XML.

<?php
declare(strict_types=1);

$old = libxml_use_internal_errors(true);
libxml_clear_errors();
$reader = XMLReader::fromString('<product/>');
try {
    if (!$reader->setRelaxNGSchemaSource('<element xmlns="http://relaxng.org/ns/structure/1.0" name="product"><attribute name="sku"><text/></attribute><empty/></element>')) { throw new RuntimeException('Схема не подключена'); }
    while ($reader->read()) {}
    if (!$reader->isValid()) { echo "Товар отклонён: схема требует атрибут sku\n"; }
} finally { $reader->close(); libxml_clear_errors(); libxml_use_internal_errors($old); }

Товар отклонён: схема требует атрибут sku

Угловые скобки здесь правильные. Отказ относится к правилам известной схемы. Причина вывода описывает именно подготовленный fixture; для произвольного файла нужна его диагностика. Следующая попытка не наследует сообщения этой проверки.