xml_set_processing_instruction_handler

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

xml_set_processing_instruction_handler — Установка обработчика инструкций препроцессора (PI)

Описание

xml_set_processing_instruction_handler(XMLParser $parser, callable $handler): true

Задаёт обработчик инструкций препроцессора (PI) для XML-анализатора. parser.

Инструкции имеют следующий формат:

<?target
data
?>

Предостережение

PHP-код разграничивается инструкцией обработки <?php. Таким образом, в XML-документе можно располагать PHP-код. Однако конечный тег PI (?>) не должен быть частью данных. Если завершающий тег PI является частью встроенного PHP-кода, то остальная часть PHP-кода и "настоящий" тег PI end будут рассматриваться как символьные данные.

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

parser

Парсер XML.

handler

Если передаётся значение null или пустая строка, то обработчик возвращается в состояние по умолчанию.

Если параметр handler является типом callable, то в качестве обработчика устанавливается callable.

Если параметр handler является строкой (string), то это может быть имя метода объекта, заданного с помощью функции xml_set_object().

Сигнатура обработчика должна быть:

handler(XMLParser $parser, string $target, string $data): void

parser: XML-парсер, вызывающий обработчик.
target: Цель применения PI.
data: PI-данные.

Возвращаемые значения

Функция всегда возвращает true.

Список изменений

Версия	Описание
8.0.0	Параметр `parser` ожидает экземпляр XMLParser; ранее ожидался корректный `xml` ресурс (resource).

add a note

User Contributed Notes

There are no user contributed notes for this page.