xml_set_default_handler

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

xml_set_default_handler — Affecte le gestionnaire XML par défaut

Description

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

Affecte le gestionnaire par défaut de l'analyseur XML parser.

Liste de paramètres

parser

Le parseur XML.

handler

Si null est passé, le gestionnaire est réinitialisé à son état par défaut.

Avertissement

Une chaîne vide réinitialisera également le gestionnaire, cependant cette fonctionnalité est dépréciée à partir de PHP 8.4.0.

Si handler est un callable, l'appelable est défini comme le gestionnaire.

Si handler est une string, il peut s'agir du nom d'une méthode d'un objet défini avec xml_set_object().

Avertissement

Cette fonctionnalité est dépréciée à partir de PHP 8.4.0.

Avertissement

À partir de PHP 8.4.0, la validité du callable est vérifiée lors de la configuration du gestionnaire, et non au moment de son appel. Cela signifie que xml_set_object() doit être appelé avant de définir une méthode sous forme de chaîne comme rappel. Cependant, comme ce comportement est également déprécié à partir de PHP 8.4.0, il est recommandé d'utiliser un callable approprié pour la méthode.

La signature du gestionnaire doit être :

handler(XMLParser $parser, string $data): void

parser: Le parseur XML appelant le gestionnaire.
data: data contient les caractères sous la forme d'une chaîne. Cela peut être une déclaration XML, un type de document, une entité ou d'autres données pour lesquelles aucun gestionnaire n'est prévu.

Valeurs de retour

Retourne toujours true.

Historique

Version	Description
8.4.0	Passing a non-callable string to `handler` is now deprecated, use a proper callable for methods, or `null` to reset the handler.
8.4.0	The validity of `handler` as a callable is now checked when setting the handler instead of checking when calling it.
8.0.0	`parser` attend une instance de XMLParser désormais; auparavent, une resource `xml` était attendue.