xml_set_end_namespace_decl_handler

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

xml_set_end_namespace_decl_handler — Set up end namespace declaration handler

Опис

xml_set_end_namespace_decl_handler(XMLParser $parser, callable|string|null $handler): true

Set a handler to be called when leaving the scope of a namespace declaration. This will be called, for each namespace declaration, after the handler for the end tag of the element in which the namespace was declared.

Застереження

This event is not supported under libXML, so a registered handler wouldn't be called.

Параметри

parser

XML-парсер.

handler

Якщо задано null, обробник буде скинуто до його початкового стану.

Увага

Якщо задано порожній рядок, обробник також буде скинуто, проте така дія застаріла, починаючи з PHP 8.4.0.

Якщо параметр handler має тип callable, то обробником стане функція/метод, що має таку назву виклику.

Параметр handler може мати тип string, якщо це назва метода об'єкта, встановленого функцією xml_set_object().

Увага

Це є застарілим, починаючи з PHP 8.4.0.

Увага

Починаючи з PHP 8.4.0, назва виклику перевіряється на правильність під час встановлення обробника, а не під час його виклику. Це означає, що функцію xml_set_object() потрібно викликати перед встановленням назви метода, як зворотнього виклику. Однак, оскільки ця поведінка також є застарілою, починаючи з PHP 8.4.0, рекомендується використовувати правильну назву виклику (callable) методу.

The signature of the handler must be:

handler(XMLParser $parser, string|false $prefix)

parser: XML-парсер, що викликає обробника.
prefix: The prefix is a string used to reference the namespace within an XML object. false if no prefix exists.

Значення, що повертаються

Завжди повертає true.

Журнал змін

Версія	Опис
8.4.0	Використання не-callable рядків (string) як параметра `handler` тепер є застарілим. Необхідно задавати правильну назву виклику методів або `null` для скидання обробника.
8.4.0	Правильність параметра `handler`, як назви виклику (callable) тепер перевіряється на правильність під час встановлення обробника, а не під час його виклику.
8.0.0	Тепер параметр `parser` має бути примірником XMLParser. Раніше очікувався `xml`-resource.

Прогляньте також

xml_set_start_namespace_decl_handler() - Set up start namespace declaration handler