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

Описание

bool xml_set_processing_instruction_handler ( resource $parser , callback $handler )

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

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

<?

target data

?>

Можно вставлять PHP код в тело тэга, но есть одно ограничение: завершающий тэг инструкций (?>) нельзя заключать в кавычки, таким образом эта последовательность символов не должна встречаться в PHP коде, который вы вставляете посредством PI в XML документы. Если это произойдет, остаток PHP кода будет воспринят как простые символьные данные.

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

parser

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

handler

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

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

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

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

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

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

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.