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

<?php
declare(strict_types=1);

$parser = xml_parser_create();
$status = xml_parse($parser, '<order number="42"/>', true);
echo $status === 1 ? "Заказ 42: XML принят\n" : "Заказ 42: исправьте XML\n";

Заказ 42: XML принят

create создаёт пустое состояние; parse получает конкретный документ и признак конца. Число 1 означает синтаксически завершённый XML, но ещё не подтверждает оплату, наличие товара или соответствие XSD.

<?php
foreach (['<status>paid</status>', '<status>sent</status>'] as $xml) {
    $parser = xml_parser_create('UTF-8');
    echo xml_parse($parser, $xml, true) === 1 ? "XML принят
" : "Ошибка XML
";
    unset($parser);
}

XML принят
XML принят

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

<?php
$parser = xml_parser_create_ns('UTF-8', '|');
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_element_handler($parser, function ($p, $name, $attrs) {
    echo $name, "
";
}, null);
xml_parse($parser, '<root xmlns:s="urn:shop" xmlns:c="urn:crm"><s:id/><c:id/></root>', true);

root
urn:shop|id
urn:crm|id

Имена передаются как URI + разделитель + локальное имя. Префиксы s/c не являются устойчивой идентичностью поля. | выбран, чтобы двоеточия URI не путались с разделителем.

<?php
$parser = xml_parser_create_ns('UTF-8', '|');
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_element_handler($parser, function ($p, $name, $attrs) {
    echo $name, ':', $attrs['id'], "
";
}, null);
xml_parse($parser, '<item xmlns="urn:shop" id="7"/>', true);

urn:shop|item:7

Default namespace относится к элементу, но не к непрефиксному атрибуту id. Обычный xml_parser_create не даёт такого раскрытия namespace.

<?php
declare(strict_types=1);

$text = '';
$parser = xml_parser_create();
xml_set_character_data_handler($parser, function ($p, $part) use (&$text) {
    $text .= $part;
});
foreach (['<status>От', 'прав', 'лен</status>'] as $chunk) {
    if (xml_parse($parser, $chunk, false) !== 1) {
        throw new RuntimeException('Повреждён ответ доставки');
    }
}
if (xml_parse($parser, '', true) !== 1) {
    throw new RuntimeException('Ответ не завершён');
}
echo 'Доставка: ', $text, "\n";

Доставка: Отправлен

Все три части идут одному parser. .= дописывает текст; use (&$text) позволяет обработчику менять внешнюю переменную. final=true проверяет, что документ закончен. Только после этого выводим собранный статус.

<?php
declare(strict_types=1);

$parser = xml_parser_create();
if (xml_parse($parser, '<status>Отправлен', false) === 1) {
    echo "Часть получена; ждём продолжение\n";
}
if (xml_parse($parser, '', true) !== 1) {
    echo "Ответ оборван: статус не обновлён\n";
}

Часть получена; ждём продолжение
Ответ оборван: статус не обновлён

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

<?php
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
$values = [];
$index = [];
$status = xml_parse_into_struct($parser, '<order><id>42</id></order>', $values, $index);
if ($status !== 1) { throw new RuntimeException('Ошибка XML'); }
foreach ($values as $row) {
    echo $row['tag'], ':', $row['type'], ':', $row['level'], "
";
}
echo $values[$index['id'][0]]['value'], "
";

order:open:1
id:complete:2
order:close:1
42

values — плоская последовательность, index хранит номера её записей для каждого имени. & в сигнатуре означает, что функция заполняет переданные переменные; при вызове знак & не пишется.

<?php
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
$values = $index = [];
$status = xml_parse_into_struct($parser, '<catalog><item sku="A">2</item><item sku="B">7</item></catalog>', $values, $index);
if ($status !== 1) { throw new RuntimeException('Ошибка XML'); }
foreach ($index['item'] as $position) {
    $row = $values[$position];
    echo $row['attributes']['sku'], '=', $row['value'], "
";
}

A=2
B=7

Атрибуты находятся внутри attributes, не рядом с tag. Нельзя присваивать все товары одному ключу item: последний затрёт предыдущие. Сложное дерево требует обработки open/close/complete/cdata, а не предположения о фиксированной паре индексов.

<?php
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_element_handler($parser, function ($p, $name, $attrs) {
    echo $name, ':', $attrs['sku'], "
";
}, null);
xml_parse($parser, '<Item sku="aB"/>', true);

Item:aB

По умолчанию имена тегов/атрибутов становятся прописными; значения атрибутов не меняются. Значение 0 работает и в базовых версиях до изменения bool-договора PHP 8.3.

<?php
$parser = xml_parser_create();
try {
    xml_parser_set_option($parser, -100, 1);
} catch (ValueError $error) {
    echo "Неизвестная опция
";
}
try {
    xml_parser_set_option($parser, XML_OPTION_TARGET_ENCODING, 'NOT-A-CHARSET');
} catch (ValueError $error) {
    echo "Кодировка не поддерживается
";
}

Неизвестная опция
Кодировка не поддерживается

Идентификаторы опций — константы, а не произвольные числа. Ошибка аргумента не является ошибкой XML-документа и не читается через xml_get_error_code.

<?php
$parser = xml_parser_create();
echo xml_parser_get_option($parser, XML_OPTION_CASE_FOLDING) ? "Регистр меняется
" : "Регистр сохранён
";
echo xml_parser_get_option($parser, XML_OPTION_TARGET_ENCODING), "
";

Регистр меняется
UTF-8

Получаем настройку именно этого объекта. С PHP 8.3 логические опции возвращают bool; раньше это могло быть целое 0/1.

<?php
$parser = xml_parser_create();
$previous = xml_parser_get_option($parser, XML_OPTION_CASE_FOLDING);
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
echo xml_parser_get_option($parser, XML_OPTION_CASE_FOLDING) ? "on
" : "off
";
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, $previous);
echo xml_parser_get_option($parser, XML_OPTION_CASE_FOLDING) ? "on
" : "off
";

off
on

Сохранение/возврат опции не отменяет уже выполненный разбор. Опции лучше определять до первого xml_parse, чтобы значения имён не менялись посреди импорта.

<?php
$parser = xml_parser_create();
set_error_handler(function ($severity, $message) {
    if ($severity === E_DEPRECATED) { echo "Устаревший вызов
"; return true; }
    return false;
});
try {
    var_dump(xml_parser_free($parser));
} finally {
    restore_error_handler();
}
var_dump(xml_parse($parser, '<ok/>', true));

Устаревший вызов
bool(true)
int(1)

Учебный обработчик принимает только ожидаемую deprecation. Объект остаётся пригодным: с PHP 8.0 free не освобождает его. На PHP 8.2–8.4 сообщение об устаревании отсутствует.

<?php
$parser = xml_parser_create();
var_dump(xml_parse($parser, '<ok/>', true));
unset($parser);
echo isset($parser) ? "Переменная есть
" : "Ссылка удалена
";

int(1)
Ссылка удалена

unset удаляет эту ссылку, объект освобождается после исчезновения всех ссылок. Обработчики/замыкания могут удерживать другие объекты; не храните завершённые парсеры бесконечно.

<?php
function opened($parser, $name, $attributes) {
    echo 'start:', $name, "
";
}
function closed($parser, $name) {
    echo 'end:', $name, "
";
}
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_element_handler($parser, 'opened', 'closed');
echo "До parse
";
$ok = xml_parse($parser, '<order><item/></order>', true);
echo 'После parse:', $ok, "
";

До parse
start:order
start:item
end:item
end:order
После parse:1

При регистрации передаём имена без (). Вызовы opened/closed делает xml_parse, пока читает документ. Даже самозакрывающийся item создаёт события начала и конца. function лишь объявляет обработчик; регистрация его тоже не исполняет.

<?php
$count = 0;
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_element_handler($parser, function ($p, $name, $attributes) use (&$count) {
    if ($name === 'item') {
        echo $attributes['sku'], "
";
        $count++;
    }
}, null);
xml_parse($parser, '<catalog><item sku="A"/><item sku="B"/></catalog>', true);
echo 'Товаров:', $count, "
";

A
B
Товаров:2

Замыкание function(...) получает аргументы от парсера. use (&$count) даёт ему доступ к внешнему счётчику с сохранением изменений; без & была бы захвачена отдельная копия. null отключает ненужный end-handler. В реальном импорте наличие sku проверяют до чтения ключа.

<?php
$text = '';
$parser = xml_parser_create();
xml_set_character_data_handler($parser, function ($p, $data) use (&$text) {
    $text .= $data;
});
xml_parse($parser, '<title>Paper ', false);
xml_parse($parser, '&amp; pen</title>', true);
echo $text, "
";

Paper & pen

Оператор .= дописывает кусочек. Присваивание = оставляло бы только последнюю порцию. Даже один цельный вход может вызвать callback несколько раз — на сущностях, Unicode и внутренних границах; размер события не является размером элемента.

<?php
$depth = 0;
$titleDepth = null;
$title = '';
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_element_handler($parser,
    function ($p, $name, $attrs) use (&$depth, &$titleDepth, &$title) {
        $depth++;
        if ($name === 'title') { $titleDepth = $depth; $title = ''; }
    },
    function ($p, $name) use (&$depth, &$titleDepth, &$title) {
        if ($titleDepth === $depth) { echo $title, "
"; $titleDepth = null; }
        $depth--;
    }
);
xml_set_character_data_handler($parser, function ($p, $data) use (&$titleDepth, &$title) {
    if ($titleDepth !== null) { $title .= $data; }
});
xml_parse($parser, '<item><title>Buy <b>today</b> now</title><qty>2</qty></item>', true);

Buy today now

titleDepth запоминает глубину выбранного title. Текст вложенного b включён, qty после закрытия title — нет. Не делайте trim каждого кусочка: исчезнут нужные разделяющие пробелы. Сценарий предполагает, что title не вложены друг в друга; для произвольной схемы нужен стек буферов.

<?php
$parser = xml_parser_create();
xml_set_processing_instruction_handler($parser, function ($p, $target, $data) {
    echo $target, ':', $data, "
";
});
xml_parse($parser, '<?shop mode="compact"?><order/>', true);

shop:mode="compact"

<?shop ...?> — инструкция обработки. Парсер передаёт имя shop и содержимое как строки; он не исполняет программу, не запускает оболочку и не загружает файлы.

<?php
$modes = [];
$parser = xml_parser_create();
xml_set_processing_instruction_handler($parser, function ($p, $target, $data) use (&$modes) {
    if ($target === 'shop' && $data === 'mode="compact"') { $modes[] = 'compact'; }
});
xml_parse($parser, '<?unknown ignore?><?shop mode="compact"?><order/>', true);
echo implode(',', $modes), "
";

compact

Разрешённый смысл определяет приложение. Чужую PI нельзя передавать eval. XML-декларация <?xml ...?> — отдельная часть формата, не произвольная исполняемая PI; ?> внутри содержимого завершает инструкцию.

<?php
$parts = '';
$parser = xml_parser_create();
xml_set_default_handler($parser, function ($p, $data) use (&$parts) { $parts .= $data; });
xml_set_element_handler($parser, function ($p, $n, $a) {}, function ($p, $n) {});
xml_set_character_data_handler($parser, function ($p, $data) {});
xml_parse($parser, '<order><!--batch 42--></order>', true);
echo $parts, "
";

<!--batch 42-->

Специальные обработчики забирают элементы/обычный текст; default получает оставшееся. Части тоже накапливаются, число вызовов не фиксируется.

<?php
declare(strict_types=1);

$comments = '';
$parser = xml_parser_create();
xml_set_default_handler($parser, function ($p, $part) use (&$comments) { $comments .= $part; });
xml_set_default_handler($parser, null);
if (xml_parse($parser, '<order><!--internal note--></order>', true) !== 1) {
    throw new RuntimeException('Повреждён заказ');
}
echo $comments === '' ? "Заказ прочитан; комментарий не попал в отчёт\n" : $comments;

Заказ прочитан; комментарий не попал в отчёт

null отменяет именно регистрацию обработчика. Комментарий остаётся в XML, но этот сборщик его уже не получает. Пустая строка для сброса устарела с PHP 8.4.

<?php
$parser = xml_parser_create_ns('UTF-8', '|');
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_start_namespace_decl_handler($parser, function ($p, $prefix, $uri) {
    echo 'ns:', $prefix === false ? '(default)' : $prefix, '=', $uri, "
";
});
xml_set_element_handler($parser, function ($p, $name, $attrs) { echo 'tag:', $name, "
"; }, null);
xml_parse($parser, '<s:item xmlns:s="urn:shop"/>', true);

ns:s=urn:shop
tag:urn:shop|item

Сначала парсер сообщает объявленную связь, затем вызывает start элемента. Обработчик получает префикс и URI отдельно.

<?php
$parser = xml_parser_create_ns();
xml_set_start_namespace_decl_handler($parser, function ($p, $prefix, $uri) {
    echo $prefix === false ? 'default' : $prefix;
    echo '=', $uri, "
";
});
xml_parse($parser, '<item xmlns="urn:shop"/>', true);

default=urn:shop

Для отсутствующего префикса контракт допускает false; не требуйте string во всех параметрах callback. namespace URI — имя словаря, а не адрес для автоматического чтения.

<?php
$ends = [];
$parser = xml_parser_create_ns();
xml_set_end_namespace_decl_handler($parser, function ($p, $prefix) use (&$ends) { $ends[] = $prefix; });
xml_parse($parser, '<s:item xmlns:s="urn:shop"/>', true);
if (XML_SAX_IMPL === 'libxml') {
    echo count($ends) === 0 ? "libxml: событие не вызывается
" : "Неожиданный результат
";
} else {
    echo 'Expat: событий=', count($ends), "
";
}

libxml: событие не вызывается

Ожидаемый вывод относится к используемой сборке PHP 8.5.11 с libxml. В Expat событие предусмотрено после end-element; это не проверка Expat на данной машине.

<?php
$depth = 0;
$parser = xml_parser_create_ns('UTF-8', '|');
xml_set_end_namespace_decl_handler($parser, null);
xml_set_element_handler($parser,
    function ($p, $name, $attrs) use (&$depth) { $depth++; },
    function ($p, $name) use (&$depth) { $depth--; }
);
xml_parse($parser, '<s:root xmlns:s="urn:shop"><s:item/></s:root>', true);
echo 'Глубина после документа:', $depth, "
";

Глубина после документа:0

Для собственного namespace-стека связывайте объявления с глубиной и снимайте их по end-element, а не ожидайте неподдерживаемое событие. Здесь показан минимальный счётчик области, не полная таблица повторных объявлений.

<?php
declare(strict_types=1);

$parser = xml_parser_create();
xml_set_external_entity_ref_handler($parser, function ($p, $open, $base, $system, $public) {
    echo 'Неизвестная зависимость: ', $system, "\n";
    return false;
});
$xml = '<!DOCTYPE order [<!ENTITY terms SYSTEM "urn:shop:unknown">]><order>&terms;</order>';
if (xml_parse($parser, $xml, true) !== 1
    && xml_get_error_code($parser) === XML_ERROR_EXTERNAL_ENTITY_HANDLING) {
    echo "Заказ отклонён: согласуйте словарь условий с поставщиком\n";
}

Неизвестная зависимость: urn:shop:unknown
Заказ отклонён: согласуйте словарь условий с поставщиком

false у этого callback имеет специальный смысл: отказ обработки внешней сущности. Сеть и файлы не открываются. Следующий пример разрешает только один собственный ID с заранее известным содержимым.

<?php
$known = ['urn:shop:terms' => '<terms>Prepaid</terms>'];
$terms = '';
$parser = xml_parser_create();
xml_set_external_entity_ref_handler($parser, function ($p, $open, $base, $system, $public) use ($known, &$terms) {
    if (!isset($known[$system])) { return false; }
    $child = xml_parser_create();
    xml_set_character_data_handler($child, function ($inner, $data) use (&$terms) { $terms .= $data; });
    return xml_parse($child, $known[$system], true) === 1;
});
$xml = '<!DOCTYPE order [<!ENTITY terms SYSTEM "urn:shop:terms">]><order>&terms;</order>';
$ok = xml_parse($parser, $xml, true);
if ($ok !== 1) { throw new RuntimeException('Ошибка внешней сущности'); }
echo $terms, "
";

Prepaid

ID сопоставляется с известным содержимым, не с произвольным путём из XML. Новый parser нужен потому, что исходный сейчас активен. true не вставляет строку автоматически в обычный text-handler родителя: приложение само сохраняет полученные данные. Пример намеренно разрешает одну фиксированную зависимость и не устанавливает такой загрузчик ребёнку.

<?php
$parser = xml_parser_create();
xml_set_notation_decl_handler($parser, function ($p, $name, $base, $system, $public) {
    echo $name, '=', $system, "
";
});
xml_parse($parser, '<!DOCTYPE item [<!NOTATION jpeg SYSTEM "image/jpeg">]><item/>', true);

jpeg=image/jpeg

NOTATION обозначает формат неразбираемого ресурса. Этот callback сообщает объявление; он не загружает изображение и не проверяет его MIME по содержимому.

<?php
$names = [];
$parser = xml_parser_create();
xml_set_notation_decl_handler($parser, function ($p, $name, $base, $system, $public) use (&$names) {
    $names[$name] = $public;
});
xml_parse($parser, '<!DOCTYPE item [<!NOTATION drawing PUBLIC "-//Example//Drawing//EN">]><item/>', true);
echo $names['drawing'], "
";

-//Example//Drawing//EN

У PUBLIC-нотации системный ID может отсутствовать. Поэтому callback в примере не навязывает string всем необязательным параметрам; нижняя библиотека передаёт отсутствие как false.

<?php
$parser = xml_parser_create();
xml_set_unparsed_entity_decl_handler($parser, function ($p, $name, $base, $system, $public, $notation) {
    echo $name, ':', $system, ':', $notation, "
";
});
$xml = '<!DOCTYPE item [<!NOTATION jpeg SYSTEM "image/jpeg"><!ENTITY logo SYSTEM "logo.jpg" NDATA jpeg>]><item/>';
var_dump(xml_parse($parser, $xml, true));

logo:logo.jpg:jpeg
int(1)

NDATA связывает внешнюю сущность с нотацией. logo.jpg не открывается: читается декларация. Неразбираемую сущность нельзя вставить в текст документа обычной ссылкой &logo;.

<?php
$entities = [];
$selected = '';
$parser = xml_parser_create();
xml_set_unparsed_entity_decl_handler($parser, function ($p, $name, $base, $system, $public, $notation) use (&$entities) {
    $entities[$name] = ['system' => $system, 'notation' => $notation];
});
xml_set_element_handler($parser, function ($p, $name, $attrs) use (&$selected) {
    if ($name === 'ITEM') { $selected = $attrs['IMAGE']; }
}, null);
$xml = '<!DOCTYPE item [<!NOTATION jpeg SYSTEM "image/jpeg"><!ENTITY cover SYSTEM "cover.jpg" NDATA jpeg><!ATTLIST item image ENTITY #IMPLIED>]><item image="cover"/>';
if (xml_parse($parser, $xml, true) !== 1) { throw new RuntimeException('Ошибка XML'); }
echo $entities[$selected]['system'], "
";

cover.jpg

Имя сущности приходит в атрибуте IMAGE и связывается с таблицей объявлений. Реальное приложение проверит существование ключей и разрешённые пути. XML Parser не проводит полную DTD-валидацию такой бизнес-связи.

<?php
declare(strict_types=1);

class OrderItems {
    public array $skus = [];
    public function opened($parser, $name, $attributes): void {
        if ($name === 'ITEM') { $this->skus[] = $attributes['SKU']; }
    }
}
$items = new OrderItems();
$parser = xml_parser_create();
xml_set_element_handler($parser, [$items, 'opened'], null);
if (xml_parse($parser, '<order><item sku="A1"/><item sku="B2"/></order>', true) !== 1) {
    throw new RuntimeException('Повреждён заказ');
}
echo 'К комплектации: ', implode(', ', $items->skus), "\n";

К комплектации: A1, B2

Класс объединяет список SKU и действие добавления. public позволяет читать список; $this обозначает данный OrderItems. Callable [$items, opened] связывает метод с этим объектом. Новый импорт получает другой объект. В учебном XML SKU известны; полноценный обработчик ниже проверяет их наличие.

<?php
class LegacyCounter {
    public $count = 0;
    public function opened($p, $name, $attrs) { $this->count++; }
}
$counter = new LegacyCounter();
$parser = xml_parser_create();
$deprecated = false;
set_error_handler(function ($severity, $message) use (&$deprecated) {
    if ($severity === E_DEPRECATED) { $deprecated = true; return true; }
    return false;
});
try {
    xml_set_object($parser, $counter);
    xml_set_element_handler($parser, 'opened', null);
} finally { restore_error_handler(); }
xml_parse($parser, '<item/>', true);
echo $deprecated ? "Нужен callable вместо старой связки
" : "Старое окружение
";
echo $counter->count, "
";

Нужен callable вместо старой связки
1

Фактический результат PHP 8.5: код ещё работает с deprecation, которую пример специально перехватывает. Исправление — предыдущий пример. В PHP 8.4 проверка строкового метода происходит сразу, поэтому даже старый порядок требует сначала xml_set_object.

<?php
foreach (['<order/>', '<order></item>'] as $xml) {
    $parser = xml_parser_create();
    $status = xml_parse($parser, $xml, true);
    $code = xml_get_error_code($parser);
    echo $status === 1 && $code === XML_ERROR_NONE ? "OK
" : "Ошибка XML
";
}

OK
Ошибка XML

Код не равен возвращаемому xml_parse: parse даёт 1/0, getter — причину. При ошибке обработчики могли уже получить часть документа.

<?php
declare(strict_types=1);

$xml = file_get_contents(__DIR__ . '/broken-order.xml');
$parser = xml_parser_create();
if (xml_parse($parser, $xml, true) !== 1) {
    $line = xml_get_current_line_number($parser);
    echo 'broken-order.xml, строка ', $line, ': ',
        xml_error_string(xml_get_error_code($parser)) ?? 'Unknown', "\n";
    echo explode("\n", $xml)[$line - 1], "\n";
    echo 'Колонка: ', xml_get_current_column_number($parser),
        '; байт: ', xml_get_current_byte_index($parser), "\n";
    echo "Заказ отклонён: закрывайте item перед order\n";
}

broken-order.xml, строка 2: Mismatched tag
<item></order>
Колонка: 15; байт: 22
Заказ отклонён: закрывайте item перед order

Здесь короткий учебный файл целиком безопасен для показа. line указывает место обнаружения; вычитаем 1 для индекса массива строк. Колонка и байт — диагностическая позиция backend, не всегда первый неверный символ. В журнале реального сервиса не публикуйте закрытые данные документа.

<?php
declare(strict_types=1);

$parser = xml_parser_create();
xml_parse($parser, '<order></item>', true);
echo xml_error_string(xml_get_error_code($parser)), "\n";

Mismatched tag

Передаём именно код, полученный от parser, как требует контракт xml_error_string. В нашей libxml-сборке подстановка XML_ERROR_TAG_MISMATCH напрямую дала другое описание: набор экспортированных констант нельзя считать универсальной таблицей номеров backend. Английская формулировка также может отличаться. Здесь сопоставьте открывающий order и закрывающий item.

<?php
$description = xml_error_string(-100);
if ($description === null || $description === 'Unknown') {
    echo "Неизвестный код ошибки
";
} else {
    echo $description, "
";
}

Неизвестный код ошибки

По официальному договору неизвестный код может дать null или Unknown. Строка не является устойчивым идентификатором ошибки.

<?php
declare(strict_types=1);

$xml = file_get_contents(__DIR__ . '/broken-order.xml');
$parser = xml_parser_create();
if (xml_parse($parser, $xml, true) !== 1) {
    $line = xml_get_current_line_number($parser);
    echo 'broken-order.xml, строка ', $line, ': ',
        xml_error_string(xml_get_error_code($parser)) ?? 'Unknown', "\n";
    echo explode("\n", $xml)[$line - 1], "\n";
    echo 'Колонка: ', xml_get_current_column_number($parser),
        '; байт: ', xml_get_current_byte_index($parser), "\n";
    echo "Заказ отклонён: закрывайте item перед order\n";
}

broken-order.xml, строка 2: Mismatched tag
<item></order>
Колонка: 15; байт: 22
Заказ отклонён: закрывайте item перед order

Здесь короткий учебный файл целиком безопасен для показа. line указывает место обнаружения; вычитаем 1 для индекса массива строк. Колонка и байт — диагностическая позиция backend, не всегда первый неверный символ. В журнале реального сервиса не публикуйте закрытые данные документа.

<?php
$parser = xml_parser_create();
xml_set_element_handler($parser, function ($p, $name, $attrs) {
    if ($name === 'ITEM') {
        echo 'Строка:', xml_get_current_line_number($p), "
";
        echo 'Колонка:', xml_get_current_column_number($p), "
";
        echo 'Байт:', xml_get_current_byte_index($p), "
";
    }
}, null);
xml_parse($parser, "<root>
<item/>
</root>", true);

Строка:2
Колонка:6
Байт:12

Getter внутри callback связывает бизнес-событие с позицией парсера. Она может указывать после части прочитанного тега, а не на его <; сохраните её как диагностическую отметку, не как универсальную границу substr.

<?php
declare(strict_types=1);

$xml = file_get_contents(__DIR__ . '/broken-order.xml');
$parser = xml_parser_create();
if (xml_parse($parser, $xml, true) !== 1) {
    $line = xml_get_current_line_number($parser);
    echo 'broken-order.xml, строка ', $line, ': ',
        xml_error_string(xml_get_error_code($parser)) ?? 'Unknown', "\n";
    echo explode("\n", $xml)[$line - 1], "\n";
    echo 'Колонка: ', xml_get_current_column_number($parser),
        '; байт: ', xml_get_current_byte_index($parser), "\n";
    echo "Заказ отклонён: закрывайте item перед order\n";
}

broken-order.xml, строка 2: Mismatched tag
<item></order>
Колонка: 15; байт: 22
Заказ отклонён: закрывайте item перед order

Здесь короткий учебный файл целиком безопасен для показа. line указывает место обнаружения; вычитаем 1 для индекса массива строк. Колонка и байт — диагностическая позиция backend, не всегда первый неверный символ. В журнале реального сервиса не публикуйте закрытые данные документа.

<?php
$parser = xml_parser_create();
xml_set_element_handler($parser, function ($p, $name, $attrs) {
    if ($name === 'ITEM') {
        echo 'Строка:', xml_get_current_line_number($p), "
";
        echo 'Колонка:', xml_get_current_column_number($p), "
";
        echo 'Байт:', xml_get_current_byte_index($p), "
";
    }
}, null);
xml_parse($parser, "<root>
<item/>
</root>", true);

Строка:2
Колонка:6
Байт:12

Getter внутри callback связывает бизнес-событие с позицией парсера. Она может указывать после части прочитанного тега, а не на его <; сохраните её как диагностическую отметку, не как универсальную границу substr.

<?php
declare(strict_types=1);

$xml = file_get_contents(__DIR__ . '/broken-order.xml');
$parser = xml_parser_create();
if (xml_parse($parser, $xml, true) !== 1) {
    $line = xml_get_current_line_number($parser);
    echo 'broken-order.xml, строка ', $line, ': ',
        xml_error_string(xml_get_error_code($parser)) ?? 'Unknown', "\n";
    echo explode("\n", $xml)[$line - 1], "\n";
    echo 'Колонка: ', xml_get_current_column_number($parser),
        '; байт: ', xml_get_current_byte_index($parser), "\n";
    echo "Заказ отклонён: закрывайте item перед order\n";
}

broken-order.xml, строка 2: Mismatched tag
<item></order>
Колонка: 15; байт: 22
Заказ отклонён: закрывайте item перед order

Здесь короткий учебный файл целиком безопасен для показа. line указывает место обнаружения; вычитаем 1 для индекса массива строк. Колонка и байт — диагностическая позиция backend, не всегда первый неверный символ. В журнале реального сервиса не публикуйте закрытые данные документа.

<?php
$parser = xml_parser_create();
xml_set_element_handler($parser, function ($p, $name, $attrs) {
    if ($name === 'ITEM') {
        echo 'Строка:', xml_get_current_line_number($p), "
";
        echo 'Колонка:', xml_get_current_column_number($p), "
";
        echo 'Байт:', xml_get_current_byte_index($p), "
";
    }
}, null);
xml_parse($parser, "<root>
<item/>
</root>", true);

Строка:2
Колонка:6
Байт:12

Getter внутри callback связывает бизнес-событие с позицией парсера. Она может указывать после части прочитанного тега, а не на его <; сохраните её как диагностическую отметку, не как универсальную границу substr.

<?php
declare(strict_types=1);

$xml = file_get_contents(__DIR__ . '/broken-order.xml');
$parser = xml_parser_create();
if (xml_parse($parser, $xml, true) !== 1) {
    $line = xml_get_current_line_number($parser);
    echo 'broken-order.xml, строка ', $line, ': ',
        xml_error_string(xml_get_error_code($parser)) ?? 'Unknown', "\n";
    echo explode("\n", $xml)[$line - 1], "\n";
    echo 'Колонка: ', xml_get_current_column_number($parser),
        '; байт: ', xml_get_current_byte_index($parser), "\n";
    echo "Заказ отклонён: закрывайте item перед order\n";
}

broken-order.xml, строка 2: Mismatched tag
<item></order>
Колонка: 15; байт: 22
Заказ отклонён: закрывайте item перед order

Здесь короткий учебный файл целиком безопасен для показа. line указывает место обнаружения; вычитаем 1 для индекса массива строк. Колонка и байт — диагностическая позиция backend, не всегда первый неверный символ. В журнале реального сервиса не публикуйте закрытые данные документа.