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-коде, который вы вставляете посредством PI в XML-документы. Если это произойдёт, остаток PHP-кода будет воспринят как простые символьные данные.

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

parser

Ссылка на XML-анализатор, для которого устанавливается обработчик.

handler

handler - строка содержащая имя функции, которая должна быть определена на момент вызова функции xml_parse() из анализатора parser.

Функция с именем handler должна принимать три аргумента:

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

parser: Первый аргумент parser является ссылкой на XML-анализатор вызывающий обработчик.
target: Второй аргумент target содержит цель применения PI.
data: Третий аргумент data содержит PI-данные.

Если в качестве обработчика передана пустая строка или false, этот обработчик отключается.

Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.

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

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

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

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

add a note

User Contributed Notes

There are no user contributed notes for this page.