xml_set_unparsed_entity_decl_handler - Установка обработчика неразобранных объявлений сущностей
Вернуться к: Функции парсера XML
xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5, PHP 7)
xml_set_unparsed_entity_decl_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
в случае возникновения ошибки.
Вернуться к: Функции парсера XML