Установка обработчика неразобранных объявлений сущностей

Описание

bool xml_set_unparsed_entity_decl_handler ( resource $parser , callback $handler )

Задает функцию обработчик неразобранных объявлений сущностей для XML анализатора parser.

Обработчик handler будет вызван, если XML анализатор обнаружит NDATA объявление внешней сущности вида:

<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
        NDATA <parameter>notationName</parameter>

См. » раздел 4.2.2 XML 1.0 спецификации, чтобы получить точное определение обозначений внешних сущностей.

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

parser

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

handler

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

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

handler ( resource $parser , string $entity_name , string $base , string $system_id , string $public_id , string $notation_name )

parser: Первый аргумент parser является ссылкой на XML анализатор вызывающий обработчик.
entity_name: Имя сущности, которой требуется дать определение.
base: Это основа для разрешения системного идентификатора (system_id) внешней сущности. На данный момент в качестве этого аргумента всегда передается пустая строка.
system_id: Системный идентификатор внешней сущности.
public_id: Общедоступный идентификатор внешней сущности.
notation_name: Имя обозначения этой сущности (см. xml_set_notation_decl_handler()).

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

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

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

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