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 ( XMLParser$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 в случае возникновения ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр parser ожидает экземпляр XMLParser; ранее ожидался ресурс (resource).
|