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).
To Top