xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5, PHP 7, PHP 8)
xml_set_unparsed_entity_decl_handler — Встановлення оброблювача нерозібраних оголошень сутностей
Опис
xml_set_unparsed_entity_decl_handler(XMLParser $parser, callable $handler): true
Задає функцію обробник нерозібраних оголошень для XML-аналізатора parser
Обработчикhandler
буде викликано, якщо XML-аналізатор виявить NDATA-оголошення зовнішньої сутності вигляду:
name publicId systemId} NDATAnotationName
Смотрите» розділ 4.2.2 XML 1.0 специфікаціїщоб отримати точне визначення позначень зовнішніх сутностей.
Список параметрів
parser
Парсер XML.
handler
Якщо передається значення null
або порожній рядок, обробник повертається в стан за замовчуванням.
Якщо параметр handler
є типом callable, то як оброблювач встановлюється callable.
Якщо параметр handler
є рядком (string), це може бути ім'я методу об'єкта, заданого за допомогою функції xml_set_object()
Сигнатура оброблювача має бути:
handler( XMLParser $parser, string $entity_name, string|false $base, string $system_id, string|false $public_id, string|false $notation_name): void
parser
XML-парсер, що викликає оброблювач.
entity_name
Ім'я сутності, яку потрібно дати визначення.
base
Це основа для дозволу системного ідентифікатора (system_id
) Зовнішньої сутності.
system_id
Системний ідентифікатор зовнішньої сутності
public_id
Загальнодоступний ідентифікатор зовнішньої сутності.
notation_name
Ім'я позначення цієї сутності (дивіться xml_set_notation_decl_handler()
Значення, що повертаються
Функція завжди повертає true
список змін
Версия | Опис |
---|---|
8.0.0 | Параметрparser чекає на екземпляр XMLParser; раніше очікувався коректний xml ресурс (Resource). |