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

<?php
declare(strict_types=1);

$catalog = simplexml_load_string('<catalog><product><name>Desk</name></product></catalog>');
if ($catalog === false) { throw new RuntimeException('XML не прочитан'); }
$name = (string) $catalog->product->name;
echo $name, "\n";

Desk

Строка между кавычками — данные документа. product и name после стрелки — имена вложенных тегов. (string) отделяет текст от XML-представления: $name уже можно передать функции, которая ждёт строку.

<?php
declare(strict_types=1);

$catalog = simplexml_load_string('<catalog/>');
if ($catalog === false) {
    echo "Повреждённый XML\n";
} elseif ($catalog->product->count() === 0) {
    echo "Каталог прочитан; товаров нет\n";
}

Каталог прочитан; товаров нет

Строгое === false проверяет отказ функции. Пустой корректный SimpleXMLElement может преобразовываться в false, поэтому if (!$catalog) ошибочно смешивает два случая. Отсутствие товаров — отдельное решение: здесь показываем пустой каталог, а не удаляем прежние остатки.

<?php
declare(strict_types=1);

$previous = libxml_use_internal_errors(true);
libxml_clear_errors();
try {
    $catalog = simplexml_load_string('<catalog><product></catalog>');
    echo $catalog === false ? "Импорт отклонён\n" : "Прочитан\n";
    echo count(libxml_get_errors()) > 0 ? "Есть диагностика\n" : "Нет ошибок\n";
} finally {
    libxml_clear_errors();
    libxml_use_internal_errors($previous);
}

Импорт отклонён
Есть диагностика

Сначала останавливаем дальнейшую работу с false, затем изучаем причину. Точный текст ошибок зависит от libxml, поэтому пользовательское сообщение и автоматическая проверка не привязаны к английской формулировке.

<?php
declare(strict_types=1);

$catalog = simplexml_load_file(__DIR__ . '/catalog.xml');
if ($catalog === false) { throw new RuntimeException('Каталог недоступен'); }
foreach ($catalog->product as $product) {
    echo (string) $product['sku'], ': ', (string) $product->name, "\n";
}

A1: Desk
B2: Lamp

__DIR__ — папка этого PHP-файла, точка склеивает путь. foreach по очереди кладёт каждый product в $product. В учебном запуске catalog.xml создаётся рядом; в своём проекте сохраните файл с указанным XML.

<?php
declare(strict_types=1);

class InventoryXml extends SimpleXMLElement {
    public function firstAvailability(): string {
        $stock = (string) $this->product[0]->stock;
        return $stock === '0' ? 'закончился' : 'остаток ' . $stock;
    }
}
$catalog = simplexml_load_file(__DIR__ . '/catalog.xml', InventoryXml::class);
echo (string) $catalog->product[0]->name, ': ', $catalog->firstAvailability(), "\n";

Desk: остаток 3

Второй аргумент задаёт класс результата. InventoryXml наследует чтение XML и добавляет операцию для известного формата; ::class даёт имя класса строкой. Это развитие примера после знакомства с классами. Валидацию произвольного stock оно не заменяет; для обычной выгрузки достаточно отдельной функции без наследника.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order number="42" status="accepted"/>');
echo 'Заказ ', (string) $order['number'], ': ', (string) $order['status'], "\n";
echo $order->asXML();

Заказ 42: accepted
<?xml version="1.0"?>
<order number="42" status="accepted"/>

new создаёт объект из XML-строки: number и status — атрибуты одного корня. asXML показывает, какой документ можно передать следующему этапу. Конструктор не подтверждает заказ в магазине сам по себе — accepted здесь явно заданные учебные данные.

<?php
declare(strict_types=1);

$old = libxml_use_internal_errors(true);
libxml_clear_errors();
try {
    new SimpleXMLElement('<order>');
} catch (Exception $error) {
    echo "Заказ не принят\n";
} finally {
    libxml_clear_errors();
    libxml_use_internal_errors($old);
}

Заказ не принят

catch выполняется после неудачного new. Не присваиваем повреждённый объект и не продолжаем импорт. Если удобнее явное значение false, используйте функцию загрузки.

<?php
declare(strict_types=1);

$dom = new DOMDocument();
if (!$dom->loadXML('<order><status>new</status></order>')) {
    throw new RuntimeException('Нет документа');
}
$order = simplexml_import_dom($dom);
if ($order === null) { throw new RuntimeException('Нет элемента'); }
echo (string) $order->status, "\n";
$order->status = 'paid';
echo $dom->getElementsByTagName('status')->item(0)->textContent, "\n";

new
paid

Метод loadXML возвращает bool: проверяем его, а не истинность объекта $dom. Импорт сохраняет связь с деревом; это важно, если разные части программы редактируют один документ.

<?php
declare(strict_types=1);

$document = Dom\XMLDocument::createFromString('<catalog><product>Desk</product></catalog>');
$catalog = simplexml_import_dom($document);
if ($catalog === null) { throw new RuntimeException('Нет XML'); }
echo (string) $catalog->product, "\n";
try { simplexml_import_dom(new stdClass()); }
catch (TypeError $error) { echo "Нужен DOM-узел\n"; }

Desk
Нужен DOM-узел

Этот пример требует PHP 8.4+. Нельзя заменить документ объектом с похожими публичными свойствами: контракт проверяет фактический DOM-тип.

<?php
declare(strict_types=1);

$product = new SimpleXMLElement('<product sku="A1" currency="RUB">Desk</product>');
foreach ($product->attributes() as $name => $value) {
    echo $name, '=', (string) $value, "\n";
}

sku=A1
currency=RUB

В foreach запись $name => $value означает «имя атрибута и его значение». Текст Desk расположен между тегами, поэтому сюда не попадает. Для заранее известного sku короче $product['sku'].

<?php
declare(strict_types=1);

$product = new SimpleXMLElement('<product xmlns="urn:shop" xmlns:sync="urn:sync" id="local-7" sync:id="remote-9"/>');
echo (string) $product->attributes()['id'], "\n";
echo (string) $product->attributes('urn:sync')['id'], "\n";
echo (string) $product->attributes('sync', true)['id'], "\n";
var_dump($product->attributes()->attributes());

local-7
remote-9
remote-9
NULL

Одинаковое локальное имя id не делает атрибуты одинаковыми: URI различает их смысл. У атрибутов нет своего уровня атрибутов. Не удаляйте xmlns строковой заменой ради упрощения чтения.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order><number>42</number><delivery><city>Tula</city></delivery></order>');
foreach ($order->children() as $name => $child) {
    echo $name, "\n";
}
echo (string) $order->delivery->city, "\n";

number
delivery
Tula

foreach не спускается автоматически во все ветки. Известный путь city можно прочитать цепочкой стрелок, для произвольной глубины пригодятся getChildren/RecursiveIteratorIterator.

<?php
declare(strict_types=1);

$product = new SimpleXMLElement('<product xmlns:s="urn:stock"><name>Desk</name><s:available>5</s:available><s:reserved>2</s:reserved></product>');
echo count($product->children('s')), "\n";
foreach ($product->children('urn:stock') as $name => $value) {
    echo $name, '=', (string) $value, "\n";
}
echo (string) $product->children('s', true)->available, "\n";

0
available=5
reserved=2
5

Первый вызов искал URI s, которого нет. Второй выбирает фактический URI, третий явно трактует s как префикс. Адрес urn:stock — идентификатор: SimpleXML не делает HTTP-запрос, чтобы его открыть.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog><product sku="A1"><name>Desk</name><stock>3</stock></product><product sku="B2"><name>Lamp</name><stock>0</stock></product></catalog>');
echo 'Товаров в каталоге: ', $catalog->product->count(), "\n";
echo 'Дочерних полей первого товара: ', $catalog->product[0]->count(), "\n";
echo 'Дочерних элементов внутри name: ', $catalog->product[0]->name[0]->count(), "\n";

Товаров в каталоге: 2
Дочерних полей первого товара: 2
Дочерних элементов внутри name: 0

Для подписи списка считаем выборку product. Индекс [0] выбирает отдельный узел: у первого product считаются вложенные name и stock, атрибут sku не входит. У конкретного name[0] нет дочерних элементов, хотя текст Desk существует. Вызов ->name->count() без [0] считал бы саму выборку name и вернул 1. count не проверяет пустоту текста.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order><item sku="A"/><item sku="B"/><item sku="C"/></order>');
$limit = 2;
$items = count($order->item);
echo $items > $limit ? "Слишком много позиций\n" : "Можно обработать\n";
echo 'missing=', count($order->missing), "\n";

Слишком много позиций
missing=0

Это бизнес-лимит после разбора, а не защита памяти при получении огромного XML. Ограничивать размер входа нужно раньше. Для подсчёта по условию сначала создайте XPath-выборку, проверьте её и вызовите обычный count на массиве.

<?php
declare(strict_types=1);

foreach (['<catalog><product>Desk</product></catalog>', '<invoice number="42"/>'] as $text) {
    $xml = new SimpleXMLElement($text);
    if ($xml->getName() !== 'catalog') {
        echo 'Нужен catalog; получен ', $xml->getName(), "\n";
        continue;
    }
    echo 'Каталог принят: ', (string) $xml->product, "\n";
}

Каталог принят: Desk
Нужен catalog; получен invoice

getName без аргументов читает локальное имя узла. Проверка помогает выбрать обработчик, но не проверяет пространства имён и всю схему: два разных протокола могут иметь корень catalog. Пример ниже добавляет URI формата.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<v:catalog xmlns:v="urn:vendor:v2"><v:product/></v:catalog>');
$namespaces = $xml->getNamespaces();
$accepted = $xml->getName() === 'catalog' && in_array('urn:vendor:v2', $namespaces, true);
echo $accepted ? "Формат v2\n" : "Неизвестный формат\n";

Формат v2

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

<?php
declare(strict_types=1);

$product = new SimpleXMLElement('<product><sku>0012</sku><name>Desk</name></product>');
$sku = (string) $product->sku;
$labels = ['0012' => 'Стол письменный'];
echo 'Артикул ', $sku, ': ', $labels[$sku], "\n";

Артикул 0012: Стол письменный

(string) вызывает строковое представление SimpleXMLElement. Артикул — идентификатор, поэтому сохраняем ведущие нули; (int) превратил бы его в 12 и изменил ключ поиска. Следующий пример объясняет предел: строковое представление не собирает текст всех вложенных тегов.

<?php
declare(strict_types=1);

$note = new SimpleXMLElement('<note>Hello <b>team</b>!</note>');
echo (string) $note, "\n";
echo (string) $note->b, "\n";
$element = dom_import_simplexml($note);
echo $element->textContent, "\n";

Hello !
team
Hello team!

SimpleXML рассчитан прежде всего на структурированные данные. Для произвольного текста с вложенной разметкой DOM точнее выражает задачу. Показать полученный текст в HTML безопасно можно после htmlspecialchars, а не после одного приведения к string.

<?php
declare(strict_types=1);

$product = new SimpleXMLElement('<product sku="A1"><name>Desk</name></product>');
$snapshot = $product->__debugInfo();
echo $snapshot['@attributes']['sku'], "\n";
echo (string) $snapshot['name'], "\n";

A1
Desk

@attributes — диагностическое представление атрибутов данного простого документа. Не стройте универсальный импортёр на обещании такой формы: для бизнес-данных явно извлекайте и проверяйте нужные поля.

<?php
declare(strict_types=1);

class OrderXml extends SimpleXMLElement {
    public function __debugInfo(): ?array {
        return ['root' => $this->getName(), 'items' => count($this->item)];
    }
}
$order = new OrderXml('<order><item>A</item><item>B</item><internal>fixture-only</internal></order>');
echo json_encode($order->__debugInfo(), JSON_THROW_ON_ERROR), "\n";
echo (string) $order->internal, "\n";

{"root":"order","items":2}
fixture-only

Отладочная сводка исключила internal, но поле осталось в XML. Это демонстрационные данные без секрета. Реальный журнал должен выбирать безопасные поля явно; скрытие в debugInfo не является защитой хранения.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog xmlns:a="urn:active" xmlns:spare="urn:spare"><a:product/></catalog>');
$map = $xml->getDocNamespaces();
if ($map === false) { throw new RuntimeException('Нет списка'); }
foreach ($map as $prefix => $uri) { echo $prefix, '=', $uri, "\n"; }

a=urn:active
spare=urn:spare

Возвращается обычный PHP-массив, его значения уже строки. Метод лишь исследует объявления; не делает запросов по URI и не регистрирует XPath-префиксы.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog xmlns:a="urn:main"><extension xmlns:e="urn:extra"><e:value>9</e:value></extension></catalog>');
$root = $xml->extension[0]->getDocNamespaces(true);
$local = $xml->extension[0]->getDocNamespaces(true, false);
if ($root === false || $local === false) { throw new RuntimeException('Нет списка'); }
echo implode(',', array_keys($root)), "\n";
echo implode(',', array_keys($local)), "\n";

a,e
e

[0] выбирает конкретный extension, а не представление списка его одноимённых соседей. Первый вызов снова рассматривает весь документ; второй — объявления выбранной ветки. Унаследованное родительское объявление не обязано быть повторно записано на extension. Не теряйте контекст при вырезании фрагментов.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog xmlns:p="urn:product" xmlns:unused="urn:unused"><p:product/></catalog>');
echo count($xml->getNamespaces()), "\n";
foreach ($xml->getNamespaces(true) as $prefix => $uri) {
    echo $prefix, '=', $uri, "\n";
}

0
p=urn:product

unused объявлен, но не применён к имени элемента/атрибута. Чтобы прочитать p:product, используем children с URI, а не обычное ->product.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<product xmlns:s="urn:sync" s:id="remote-8"><name>Desk</name></product>');
$map = $xml->getNamespaces();
echo $map['s'], "\n";
echo (string) $xml->attributes($map['s'])['id'], "\n";

urn:sync
remote-8

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

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog xmlns="urn:shop"><product>Desk</product></catalog>');
if (!$xml->registerXPathNamespace('s', 'urn:shop')) {
    throw new RuntimeException('Не зарегистрирован prefix');
}
$products = $xml->xpath('/s:catalog/s:product');
if (!is_array($products)) { throw new RuntimeException('Ошибка XPath'); }
echo (string) $products[0], "\n";
echo count($xml->xpath('/catalog/product')), "\n";

Desk
0

В XPath 1.0 имена без префикса означают элементы без namespace. Даже когда в XML нет двоеточия, xmlns на корне меняет имя каждого такого элемента. Свой s решает задачу без удаления xmlns.

<?php
declare(strict_types=1);

$documents = [
    '<catalog xmlns:a="urn:shop"><a:product>Desk</a:product></catalog>',
    '<catalog xmlns:b="urn:shop"><b:product>Lamp</b:product></catalog>',
];
foreach ($documents as $text) {
    $xml = new SimpleXMLElement($text);
    $xml->registerXPathNamespace('s', 'urn:shop');
    $matches = $xml->xpath('/catalog/s:product');
    if (!is_array($matches)) { throw new RuntimeException('Ошибка XPath'); }
    foreach ($matches as $product) { echo (string) $product, "\n"; }
}

Desk
Lamp

Меняется буква в документе, а смысл URI остаётся. При реальном изменении версии URI код должен осознанно поддержать новый формат: регистрировать старое сокращение недостаточно.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog><product active="1">Desk</product><product active="0">Lamp</product></catalog>');
$products = $xml->xpath('/catalog/product[@active="1"]');
if (!is_array($products)) { throw new RuntimeException('Ошибка запроса'); }
foreach ($products as $product) { echo (string) $product, "\n"; }

Desk

@active обозначает атрибут, а не дочерний тег active. Кавычки и скобки относятся к XPath. Путь здесь фиксирован в исходном коде, а не построен из пользовательской строки.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog><product sku="A&amp;B">Desk</product><product sku="C">Lamp</product></catalog>');
$wantedSku = 'A&B';
foreach ($xml->product as $product) {
    if ((string) $product['sku'] === $wantedSku) {
        echo (string) $product, "\n";
    }
}

Desk

Пользовательское значение вообще не становится программой XPath. Для маленькой выборки такой проход понятен; при большом документе учитывайте стоимость прохода и подходящий формат хранения.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<catalog><product/><product/></catalog>');
$warning = false;
set_error_handler(function (int $level, string $message) use (&$warning): bool {
    $warning = true;
    return true;
});
try { $result = $xml->xpath('count(/catalog/product)'); }
finally { restore_error_handler(); }
var_dump($result === false, $warning);
echo count($xml->xpath('/catalog/product')), "\n";

bool(true)
bool(true)
2

Этот пример версии 8.5+ намеренно перехватывает предупреждение. Для нашего количества достаточно count массива выборки. Обработчик ограничен try/finally и не скрывает ошибки остальной программы.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog/>');
$product = $catalog->addChild('product');
$product->addChild('name', 'Desk');
$product->addAttribute('sku', 'A1');
echo $catalog->asXML();

<?xml version="1.0"?>
<catalog><product sku="A1"><name>Desk</name></product></catalog>

addChild("product") создаёт пустой элемент и возвращает именно его: поэтому следующая стрелка добавляет name внутрь нового товара. addChild("name", "Desk") задаёт имя тега и его текст двумя разными аргументами. Добавление в дерево ещё не записывает файл.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog/>');
$name = 'Desk & Lamp <set>';
$product = $catalog->addChild('product');
if ($product === null) { throw new RuntimeException('Не создан товар'); }
$product->addChild('name', htmlspecialchars($name, ENT_XML1 | ENT_QUOTES, 'UTF-8'));
echo (string) $product->name, "\n";
echo $product->name->asXML(), "\n";

Desk & Lamp <set>
<name>Desk &amp; Lamp &lt;set&gt;</name>

ENT_XML1 выбирает XML-правила сущностей. На входе предполагается корректный UTF-8 и допустимые XML-символы: экранирование не исправляет запрещённые управляющие байты. Для обычного присваивания $product->name = $name предварительно экранировать не нужно.

<?php
declare(strict_types=1);

$product = new SimpleXMLElement('<product sku="A1"/>');
$product->addChild('s:available', '5', 'urn:stock');
echo $product->asXML();

<?xml version="1.0"?>
<product sku="A1"><s:available xmlns:s="urn:stock">5</s:available></product>

Первый аргумент задаёт префикс и локальное имя, второй — остаток текстом, третий — URI пространства имён. В результате видно объявление xmlns:s. Префикс можно переименовать, принадлежность элемента определяется URI urn:stock.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order/>');
$order->addAttribute('number', '42');
$order->addAttribute('status', 'new');
$order['status'] = 'paid';
echo $order->asXML();

<?xml version="1.0"?>
<order number="42" status="paid"/>

addAttribute создаёт новый атрибут; name и value передаются отдельными строками. Для изменения существующего status используем квадратные скобки. Возврат метода void не нужно присваивать как новый узел.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order/>');
$order->addAttribute('source', 'A&B');
$order->addAttribute('s:id', 'remote9', 'urn:sync');
echo $order->asXML();

<?xml version="1.0"?>
<order xmlns:s="urn:sync" source="A&amp;B" s:id="remote9"/>

addAttribute сам экранирует амперсанд в значении source. Не передавайте заранее A&B, иначе получите двойное экранирование. URI urn:sync отличает служебный id от обычного id; для чтения нужен attributes("urn:sync").

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog><product sku="A1">Desk</product></catalog>');
$text = $catalog->product->asXML();
if ($text === false) { throw new RuntimeException('Не сериализован'); }
echo $text, "\n";

<product sku="A1">Desk</product>

Вызов сделан на product, поэтому возвращается эта ветка, а не весь catalog. Для простого текста Desk нужен (string), для передачи структуры — XML.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order number="42" status="new"/>');
$order['status'] = 'paid';
$path = __DIR__ . '/result.xml';
if (!$order->asXML($path)) {
    throw new RuntimeException('Не удалось сохранить подтверждение');
}
echo file_get_contents($path);

<?xml version="1.0"?>
<order number="42" status="paid"/>

При переданном имени файла asXML возвращает bool, а XML находится в файле. Без имени возвращается строка XML. Пример пишет только result.xml в своей учебной папке; после ручного запуска файл можно открыть редактором. Повторный запуск заменит именно этот результат.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog><product sku="A1">Desk</product></catalog>');
$text = $catalog->product->saveXML();
if ($text === false) { throw new RuntimeException('Не сериализован'); }
echo $text, "\n";

<product sku="A1">Desk</product>

Вызов сделан на product, поэтому возвращается эта ветка, а не весь catalog. Для простого текста Desk нужен (string), для передачи структуры — XML.

<?php
declare(strict_types=1);

$order = new SimpleXMLElement('<order number="42" status="new"/>');
$order['status'] = 'paid';
$path = __DIR__ . '/result.xml';
if (!$order->saveXML($path)) {
    throw new RuntimeException('Не удалось сохранить подтверждение');
}
echo file_get_contents($path);

<?xml version="1.0"?>
<order number="42" status="paid"/>

При переданном имени файла saveXML возвращает bool, а XML находится в файле. Без имени возвращается строка XML. Пример пишет только result.xml в своей учебной папке; после ручного запуска файл можно открыть редактором. Повторный запуск заменит именно этот результат.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><item>Desk</item><item>Lamp</item></order>');
$xml->rewind();
echo (string) $xml->current(), "\n";
$xml->next();
echo (string) $xml->current(), "\n";
$xml->rewind();
echo (string) $xml->current(), "\n";

Desk
Lamp
Desk

Объект содержит документ и состояние обхода. rewind не загружает файл заново и не отменяет изменения узлов.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><item>Desk</item></order>');
$xml->asXML();
$xml->getName();
var_dump($xml->valid());
$xml->rewind();
var_dump($xml->valid());

bool(false)
bool(true)

Пример отмечает изменение 8.4+. После изучения документа курсор по-прежнему не установлен: только явный rewind переводит его к ребёнку.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog><product>Desk</product></catalog>');
$catalog->rewind();
if ($catalog->valid()) {
    echo 'В обработке: ', (string) $catalog->current(), "\n";
}
$catalog->next();
if (!$catalog->valid()) { echo "Все товары обработаны\n"; }

В обработке: Desk
Все товары обработаны

Курсор — текущая позиция ручного обхода. rewind ставит его на первого ребёнка, valid проверяет наличие текущего ребёнка, next сдвигает дальше. valid не проверяет синтаксис XML и не сообщает, прошёл ли товар бизнес-проверку; для обычного списка короче foreach.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog/>');
$catalog->rewind();
if (!$catalog->valid()) { echo "В выгрузке нет товаров; прежний каталог не меняем\n"; }
while ($catalog->valid()) {
    echo 'Обработан: ', (string) $catalog->current(), "\n";
    $catalog->next();
}

В выгрузке нет товаров; прежний каталог не меняем

Условие проверяется до первого чтения current. Пустая выгрузка корректна как XML, но её смысл определяет договор: здесь она не является командой удалить каталог. Тело while не выполняется ни разу.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><item>Desk</item><item>Lamp</item></order>');
$xml->rewind();
echo (string) $xml->current(), "\n";
echo (string) $xml->current(), "\n";

Desk
Desk

Курсор остаётся на том же item. Это удобно, когда несколько проверок относятся к одной позиции.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog><product sku="A1">Desk</product></catalog>');
$catalog->rewind();
$product = $catalog->current();
$product['processed'] = 'yes';
echo $product->asXML(), "\n";
$catalog->next();
try { $catalog->current(); }
catch (Error $error) { echo "Текущего товара больше нет: сначала проверяйте valid\n"; }

<product sku="A1" processed="yes">Desk</product>
Текущего товара больше нет: сначала проверяйте valid

current возвращает представление текущего узла, а не независимую копию: изменение атрибута входит в каталог. Здесь намеренно показана ошибка чтения после конца; рабочий цикл проверяет valid до current.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><item>Desk</item></order>');
$xml->rewind();
echo $xml->getName(), "\n";
echo $xml->key(), "\n";

order
item

Оба метода вызываются у $xml, но отвечают о разных уровнях: сам объект и текущая позиция его итератора.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><item>Desk</item><item>Lamp</item></order>');
$groups = [];
for ($xml->rewind(); $xml->valid(); $xml->next()) {
    $groups[$xml->key()][] = (string) $xml->current();
}
echo implode(', ', $groups['item']), "\n";

Desk, Lamp

Вторые квадратные скобки [] добавляют в список, сохраняя повторения. array с одним значением на имя тега потерял бы данные. Такая группировка всё ещё не универсальный XML→array: смешанное содержимое/порядок разных тегов требуют другой модели.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><item>Desk</item><item>Lamp</item></order>');
$xml->rewind();
$xml->next();
if ($xml->valid()) { echo (string) $xml->current(), "\n"; }

Lamp

Результат next не печатаем: метод лишь изменил позицию. Документ и содержимое товаров остались прежними.

<?php
declare(strict_types=1);

$catalog = new SimpleXMLElement('<catalog><product>Desk</product><product>Lamp</product><product>Chair</product></catalog>');
$catalog->rewind();
for ($done = 0; $done < 2 && $catalog->valid(); $done++) {
    echo 'Подготовлен товар: ', (string) $catalog->current(), "\n";
    $catalog->next();
}
if ($catalog->valid()) { echo 'Следующий товар: ', (string) $catalog->current(), "\n"; }

Подготовлен товар: Desk
Подготовлен товар: Lamp
Следующий товар: Chair

next перемещает текущую позицию и не возвращает новый товар. Лимит две позиции относится только к обработке; SimpleXML уже держит весь XML в памяти. Для потока большого файла нужен XMLReader, а для продолжения после перезапуска — отдельный устойчивый ключ/протокол.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><delivery><city>Tula</city></delivery><comment>Call first</comment></order>');
for ($xml->rewind(); $xml->valid(); $xml->next()) {
    echo $xml->key(), ':', $xml->hasChildren() ? 'branch' : 'leaf', "\n";
}

delivery:branch
comment:leaf

Вложенный city делает delivery веткой. Текст Call first не делает comment веткой, но значение в нём есть.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<response><status>ready</status><details><code>200</code></details></response>');
for ($xml->rewind(); $xml->valid(); $xml->next()) {
    if ($xml->hasChildren()) { echo $xml->key(), " требует разбора\n"; }
    else { echo $xml->key(), '=', (string) $xml->current(), "\n"; }
}

status=ready
details требует разбора

Если обрабатывать только getChildren, текстовый status легко пропустить. Условия разделяют два вида узлов согласно формату ответа, не превращают все значения в массивы.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<order><delivery><city>Tula</city><street>Central</street></delivery></order>');
$xml->rewind();
$delivery = $xml->getChildren();
if ($delivery !== null) {
    foreach ($delivery as $name => $value) {
        echo $name, '=', (string) $value, "\n";
    }
}

city=Tula
street=Central

delivery — объект выбранной ветки. Этот вызов не означает «все потомки документа одним массивом» и не преобразует данные в PHP-массив.

<?php
declare(strict_types=1);

$xml = new SimpleXMLElement('<response><status>ready</status></response>');
var_dump($xml->getChildren());
$xml->rewind();
$leaf = $xml->getChildren();
echo (string) $leaf, "\n";
echo count($leaf), "\n";
var_dump($xml->hasChildren());

NULL
ready
0
bool(false)

До rewind возвращается null. После него объект status существует и содержит ready, но вложенных элементов нет. Это объясняет, зачем RecursiveIterator разделяет hasChildren и getChildren.