PHP - SAX Парсер Пример: Пособие для Начинающих

Здравствуйте, будущие маги PHP! Сегодня мы отправимся в увлекательное путешествие в мир парсинга SAX в PHP. Не волнуйтесь, если вы раньше не слышали о SAX - к концу этого руководства вы будете парсить XML, как профессионал!

PHP - SAX Parser Example

Что такое SAX парсинг?

Прежде чем погрузиться в код, давайте поговорим о том, что такое парсинг SAX. SAX означает "Простая API для XML". Это способ чтения XML документов, который особенно полезен, когда вы имеете дело с большими файлами или когда вы хотите обрабатывать XML по мере чтения, вместо того чтобы загружать весь документ в память.

Представьте, что вы читаете книгу. SAX парсинг похож на чтение книги page за page, понимая каждую страницу по мере чтения, вместо того чтобы пытаться запомнить всю книгу сразу. Замечательно, правда?

Начало работы с SAX в PHP

PHP делает парсинг SAX breeze с помощью встроенного XML парсера. Давайте начнем с простого примера:

<?php
$parser = xml_parser_create();
xml_parse($parser, "<book><title>PHP для Начинающих</title></book>");
xml_parser_free($parser);
?>

В этом коде мы создаем парсер, парсим простой XML строку и затем высвобождаем парсер. Но это еще не делает много. Чтобы наш парсер стал полезным, нам нужно告诉他, что делать при встрече с различными частями XML. Вот где наши хендлер функции приходят в дело!

XML Элемент Хендлер

Функция xml_set_element_handler() позволяет нам указать, что происходит, когда парсер встречает начало и конец элемента. Давайте посмотрим, как это работает:

<?php
function start_element($parser, $element_name, $element_attrs) {
echo "Начальный Элемент: $element_name<br>";
}

function end_element($parser, $element_name) {
echo "Конечный Элемент: $element_name<br>";
}

$parser = xml_parser_create();
xml_set_element_handler($parser, "start_element", "end_element");

$xml = "<book><title>PHP для Начинающих</title><author>John Doe</author></book>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

Этот скрипт выведет:

Начальный Элемент: BOOK
Начальный Элемент: TITLE
Конечный Элемент: TITLE
Начальный Элемент: AUTHOR
Конечный Элемент: AUTHOR
Конечный Элемент: BOOK

Как видите, наша функция start_element вызывается при встрече с открывающим тегом, а end_element вызывается для закрывающих тегов.

Хендлер Character Data

Что насчет текста между тегами? Вот где xml_set_character_data_handler() становится полезным:

<?php
function char_data($parser, $data) {
echo "Character Data: " . trim($data) . "<br>";
}

$parser = xml_parser_create();
xml_set_character_data_handler($parser, "char_data");

$xml = "<book><title>PHP для Начинающих</title><author>John Doe</author></book>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

Это выведет:

Character Data: PHP для Начинающих
Character Data: John Doe

Хендлер Processing Instruction

Иногда XML документы содержат инструкции по обработке. Это специальные инструкции для приложения, обрабатывающего XML. Мы можем обработать их с помощью xml_set_processing_instruction_handler():

<?php
function pi_handler($parser, $target, $data) {
echo "Инструкция по обработке - Цель: $target, Данные: $data<br>";
}

$parser = xml_parser_create();
xml_set_processing_instruction_handler($parser, "pi_handler");

$xml = "<?xml version='1.0'?><?php echo 'Hello, World!'; ?><root>Some content</root>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

Это выведет:

Инструкция по обработке - Цель: php, Данные: echo 'Hello, World!'

Хендлер по умолчанию

Наконец, xml_set_default_handler() позволяет нам обрабатывать любую XML данные, которые не были пойманы другими хендлерами:

<?php
function default_handler($parser, $data) {
echo "Хендлер по умолчанию: " . htmlspecialchars($data) . "<br>";
}

$parser = xml_parser_create();
xml_set_default_handler($parser, "default_handler");

$xml = "<?xml version='1.0'?><root>Some content</root>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

Это выведет:

Хендлер по умолчанию: <?xml version='1.0'?>
Хендлер по умолчанию: <root>Some content</root>

Объединение всего вместе

Теперь, когда мы видели каждый хендлер в действии, давайте объединим их в более completo пример:

<?php
function start_element($parser, $element_name, $element_attrs) {
echo "Начальный Элемент: $element_name<br>";
if (!empty($element_attrs)) {
echo "Атрибуты: ";
print_r($element_attrs);
echo "<br>";
}
}

function end_element($parser, $element_name) {
echo "Конечный Элемент: $element_name<br>";
}

function char_data($parser, $data) {
if (trim($data) !== '') {
echo "Character Data: " . trim($data) . "<br>";
}
}

function pi_handler($parser, $target, $data) {
echo "Инструкция по обработке - Цель: $target, Данные: $data<br>";
}

function default_handler($parser, $data) {
$data = trim($data);
if (!empty($data)) {
echo "Хендлер по умолчанию: " . htmlspecialchars($data) . "<br>";
}
}

$parser = xml_parser_create();

xml_set_element_handler($parser, "start_element", "end_element");
xml_set_character_data_handler($parser, "char_data");
xml_set_processing_instruction_handler($parser, "pi_handler");
xml_set_default_handler($parser, "default_handler");

$xml = <<<XML
<?xml version='1.0'?>
<?php echo 'Hello, World!'; ?>
<library>
<book id="1">
<title>PHP для Начинающих</title>
<author>John Doe</author>
</book>
<book id="2">
<title>Advanced PHP Techniques</title>
<author>Jane Smith</author>
</book>
</library>
XML;

xml_parse($parser, $xml);
xml_parser_free($parser);
?>

Этот comprehensive пример демонстрирует все хендлеры, о которых мы говорили. Попробуйте запустить его и посмотрите, какой вы получите вывод!

Заключение

Поздравления! Вы только что сделали свои первые шаги в мир парсинга SAX с PHP. Помните, что практика делает perfect, так что не бойтесь экспериментировать с различными структурами XML и смотреть, как ваш парсер обрабатывает их.

Парсинг SAX - это мощный инструмент в вашем наборе PHP, особенно при работе с большими XML документами. Он позволяет вам обрабатывать XML эффективно и на ходу, что может быть настоящей палочкой-выручалочкой в некоторых ситуациях.

Продолжайте программировать, продолжайте учиться и, самое главное, получайте удовольствие! Before you know it, you'll be parsing XML like a seasoned pro. Until next time, happy coding!

Хендлер Функция	Назначение
xml_set_element_handler()	Обработка начала и конца XML элементов
xml_set_character_data_handler()	Обработка текстовых данных между XML тегами
xml_set_processing_instruction_handler()	Обработка инструкций по обработке XML
xml_set_default_handler()	Обработка любой XML данных, не caught другими хендлерами

Credits: Image by storyset

Предыдущий учебник:

PHP - Простой XML-анализатор

Следующий учебник:

PHP - Пример DOM-анализатора