xml_set_processing_instruction_handler

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

xml_set_processing_instruction_handler — Affecte les gestionnaires d'instructions exécutables

Description

xml_set_processing_instruction_handler(XMLParser $parser, callable $handler): true

Affecte le gestionnaire d'instructions exécutables de l'analyseur XML parser.

Une instruction exécutable a la forme suivante : 

<?
target data
?>
Vous pouvez mettre du code PHP entre ces balises, mais soyez conscient d'une des limitations des instructions exécutables de XML : la balise de fin d'instruction exécutable (?>) ne peut être échappée, ce qui fait que cette séquence NE DOIT JAMAIS apparaître dans le code PHP placé dans le document PHP. Si un tel texte apparaît, la balise de fin d'instruction exécutable sera reconnue, et le reste du code sera considéré comme des données brutes (et donc, pas exécutées).

Liste de paramètres

parser

Une référence à l'analyseur XML à définir comme fonction d'analyse d'instructions (PI).

handler

handler est une chaîne qui contient le nom d'une fonction qui existe lorsque xml_parse() est appelé pour créer parser.

La fonction handler doit accepter trois paramètres :

handler(XMLParser $parser, string $target, string $data)
parser
Le premier paramètre, parser, est une référence sur l'analyseur XML qui appelle cette fonction.
target
Le second paramètre, target, contient l'application cible.
data
Le troisième paramètre, data, contient le code sous la forme d'une chaîne.

Si un gestionnaire reçoit une chaîne vide, ou false, c'est qu'il est désactivé.

Note: À la place d'un nom de fonction, un tableau contenant une référence d'objet et un nom de méthode peut aussi être utilisé.

Valeurs de retour

Retourne toujours true.

Historique

Version Description
8.0.0 parser attend une instance de XMLParser désormais; auparavent, une resource xml était attendue.