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).
    To Top