(PHP 4, PHP 5, PHP 7, PHP 8)
xml_set_processing_instruction_handler — Affecte les gestionnaires d'instructions de traitement
$parser, callable|string|null $handler): true
Affecte le gestionnaire d'instructions exécutables de l'analyseur
XML parser.
Une instruction de traitement a la forme suivante :
<?target data ?>
Le code PHP est délimité par l'instruction de traitement
<?php.
Ainsi, il est possible d'avoir du code PHP dans un document XML.
Cependant, la balise de fin de l'instruction de traitement
(?>) ne doit pas faire partie des données.
Si une balise de fin de l'instruction de traitement existe dans le code
PHP imbriqué, le reste du code PHP et la "vraie" balise de fin de
l'instruction de traitement, seront traités comme des données de caractères.
parserhandler
Si null est passé, le gestionnaire est réinitialisé à son état par défaut.
Une chaîne vide réinitialisera également le gestionnaire, cependant cette fonctionnalité est dépréciée à partir de PHP 8.4.0.
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().
Cette fonctionnalité est dépréciée à partir de PHP 8.4.0.
À 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 :
parsertargetdata
Retourne toujours true.
| Version | Description |
|---|---|
| 8.4.0 |
Passer une string non-callable à
handler est désormais obsolète,
utiliser un callable adéquat pour les méthodes, ou null pour réinitialiser le gestionnaire.
|
| 8.4.0 |
La validité de handler en tant que callable
est désormais vérifiée lors de la définition du gestionnaire au lieu d'être vérifiée lors de son appel.
|
| 8.0.0 |
parser attend une instance de XMLParser
désormais; auparavent, une resource xml était attendue.
|