xml_set_notation_decl_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

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

xml_set_notation_decl_handler(XMLParser $parser, callable $handler): true

Задаёт обработчик объявления обозначений для XML-анализатора parser.

Раздел объявления обозначений является частью DTD документа и имеет следующий формат:

<!NOTATION <parameter>name</parameter>
{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?>

Смотрите » раздел 4.7 спецификации XML 1.0 для более полного описания обозначений (нотаций).

parser

Парсер XML.

handler

Если передаётся значение null или пустая строка, то обработчик возвращается в состояние по умолчанию.

Если параметр handler является типом callable, то в качестве обработчика устанавливается callable.

Если параметр handler является строкой (string), то это может быть имя метода объекта, заданного с помощью функции xml_set_object().

Сигнатура обработчика должна быть:

handler(
    XMLParser $parser,
    string $notation_name,
    string|false $base,
    string $system_id,
    string|false $public_id
): void

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

Функция всегда возвращает true.

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

There are no user contributed notes for this page.