SimpleXMLElement::__construct

(PHP 5, PHP 7, PHP 8)

SimpleXMLElement::__construct Crée un nouvel objet SimpleXMLElement

Description

final public SimpleXMLElement::__construct ( string $data , int $options = 0 , bool $data_is_url = false , string $ns = "" , bool $is_prefix = false )

Crée un nouvel objet SimpleXMLElement.

Liste de paramètres

data

Une chaîne de caractères XML bien formée ou le chemin d'accès ou un URL pointant à un document XML si data_is_url vaut true.

options

Optionnellement utilisé pour spécifier des paramètres Libxml additionnels, qui affecte la lecture de documents XML. Les options affectant la sortie des documents XML (par exemple LIBXML_NOEMPTYTAG) sont ignorée silencieusement.

Note:

Il peut être nécessaire de passer LIBXML_PARSEHUGE pour pouvoir traiter des nœuds de texte profondément imbriqués ou très volumineux.

data_is_url

Par défaut, data_is_url vaut false. Utilisez true pour spécifier que le paramètre data est un chemin d'accès ou un URL pointant à un document XML au lieu d'une chaîne de caractères de données.

ns

Préfixe d'espace de noms ou URI.

is_prefix

true si ns est un préfix, false sinon. Valeur par défaut : false.

Valeurs de retour

Retourne un objet SimpleXMLElement représentant les données data.

Erreurs / Exceptions

Produit un message d'erreur de type E_WARNING pour chaque erreur trouvée dans les données XML et lance également une exception si les données XML ne peuvent être analysées.

Astuce

Utilisez la fonction libxml_use_internal_errors() pour supprimer toutes les erreurs XML et la fonction libxml_get_errors() pour les parcourir.

Historique

Version Description
5.2.0 Ajout des paramètres ns et is_prefix.
5.1.2 Ajout des paramètres options et data_is_url.

Exemples

Note:

Les exemples listés incluent parfois example.php, ceci fait référence à la chaine XML du premier exemple de l'utilisation de base.

Exemple #1 Crée un objet SimpleXMLElement

<?php

include 'example.php';

$sxe = new SimpleXMLElement($xmlstr);
echo 
$sxe->movie[0]->title;

?>

L'exemple ci-dessus va afficher :

PHP: Behind the Parser

Exemple #2 Crée un objet SimpleXMLElement à partir d'un URL

<?php

$sxe 
= new SimpleXMLElement('http://example.org/document.xml'NULLTRUE);
echo 
$sxe->asXML();

?>

Voir aussi