array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.xml-parser-set-option.php', 1 => 'xml_parser_set_option', 2 => 'Affecte les options d\'un analyseur XML', ), 'up' => array ( 0 => 'ref.xml.php', 1 => 'Fonctions d\'analyse de fichier XML', ), 'prev' => array ( 0 => 'function.xml-parser-get-option.php', 1 => 'xml_parser_get_option', ), 'next' => array ( 0 => 'function.xml-set-character-data-handler.php', 1 => 'xml_set_character_data_handler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/xml/functions/xml-parser-set-option.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

xml_parser_set_option

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

xml_parser_set_option — Affecte les options d'un analyseur XML

Description

xml_parser_set_option(XMLParser $parser, int $option, string|int|bool $value): bool

Affecte les options d'un analyseur XML.

Liste de paramètres

parser

Une référence vers un analyseur XML.

option

L'option à modifier. Voir ci-dessous.

Les options suivantes sont disponibles :
Options de l'analyseur XML
Option Type de données Description
XML_OPTION_CASE_FOLDING bool Contrôle la gestion de la casse des balises de cet analyseur XML. Par défaut, activé.
XML_OPTION_PARSE_HUGE bool Permet d'analyser des documents de plus de 10 Mo. Cette option ne doit être activée que si la taille du document est limitée, car cela pourrait sinon conduire à une attaque par déni de service (DoS). Cette option est uniquement disponible avec l'utilisation de libxml2.
XML_OPTION_SKIP_TAGSTART integer Spécifie combien de caractères doivent être éludés du début du nom de la balise.
XML_OPTION_SKIP_WHITE entier Élude ou non les valeurs contenant des caractères blancs.
XML_OPTION_TARGET_ENCODING string Modifie le codage à la cible utilisé par cet analyseur XML. Par défaut, c'est celui qui a été spécifié lors de l'appel de xml_parser_create(). Les codages supportés sont ISO-8859-1, US-ASCII et UTF-8.

value

La nouvelle valeur de l'option.

Valeurs de retour

Renvoie true en cas de succès ou false en cas d'échec.

Erreurs / Exceptions

Lève une ValueError lorsqu'une valeur invalide est passée à option.

Antérieur à PHP 8.0.0, passer une valeur invalide à option générait un avertissement E_WARNING et faisait retourner à la fonction la valeur false.

Historique

Version Description
8.4.0 Ajout de l'option XML_OPTION_PARSE_HUGE.
8.3.0 Le paramètre value accepte désormais également les booléens. Les options XML_OPTION_CASE_FOLDING et XML_OPTION_SKIP_WHITE sont désormais des options booléennes.
8.0.0 parser attend une instance de XMLParser désormais; auparavent, une resource xml était attendue.
8.0.0 Une exception ValueError est désormais lancée si l'option est invalide.