xml_set_element_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_element_handler — Встановлення обробника початкового та кінцевого елементів

Опис

xml_set_element_handler(XMLParser $parser, callable $start_handler, callable $end_handler): true

Встановлює функцію обробник елементів для XML-аналізатора parser

Параметрstart_handler викликається при відкритті нового XML-елемента. Параметр end_handler викликається під час закриття XML-елемента.

Список параметрів

parser

Парсер XML.

start_handler

Якщо передається значення null або порожній рядок, обробник повертається в стан за замовчуванням.

Якщо параметр handler є типом callable, то як оброблювач встановлюється callable.

Якщо параметр handler є рядком (string), це може бути ім'я методу об'єкта, заданого за допомогою функції xml_set_object()

Сигнатура оброблювача має бути:

start_element_handler(XMLParser $parser, string $name, array $attributes): void

parser

XML-парсер, що викликає оброблювач.

name

Містить ім'я елемента, якого викликається даний обробник. Якщо для цього синтаксичного аналізатора діє приведення до одного регістру, то ім'я елемента буде у верхньому регістрі.

attributes

Асоціативний масив із атрибутами елемента. Масив порожній, якщо елемент не має атрибутів. Ключами цього масиву є імена атрибутів, значення - значення атрибутів. Імена атрибутів наводяться до одного регістру за тими ж критеріями, як і імена елементів. Значення атрибутів не наводяться до одного регістру. Порядок отримання атрибутів attributes ідентичний порядку оголошення атрибутів.

end_element

Якщо передається значення null або порожній рядок, обробник повертається в стан за замовчуванням.

Якщо параметр handler є типом callable, то як оброблювач встановлюється callable.

Якщо параметр handler є рядком (string), це може бути ім'я методу об'єкта, заданого за допомогою функції xml_set_object()

Сигнатура оброблювача має бути:

end_element_handler(resource $parser, string $name): void

parser

XML-парсер, що викликає оброблювач.

name

Містить ім'я елемента, якого викликається даний обробник. Якщо для цього синтаксичного аналізатора діє приведення до одного регістру, то ім'я елемента буде у верхньому регістрі.

Значення, що повертаються

Функція завжди повертає true

список змін

Версия	Опис
8.0.0	Параметрparser чекає на екземпляр XMLParser; раніше очікувався коректний xml ресурс (Resource).