xml_set_processing_instruction_handler

(PHP 4, PHP 5, PHP 7)

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

Описание

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

Задает обработчик инструкций препроцессора (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 в случае успешного завершения или false в случае возникновения ошибки.

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

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