Edit Report a Bug

SimpleXMLElement::__construct

(PHP 5 >= 5.0.1)

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.
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 re 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.

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', NULL, TRUE);
echo $sxe->asXML();

?>

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`.

Voir aussi

Utilisation de base SimpleXML
simplexml_load_string() - Convertit une chaîne XML en objet
simplexml_load_file() - Convertit un fichier XML en objet
Traitement des erreurs XML
libxml_use_internal_errors() - Désactive le rapport d'erreur libxml et les stocke pour lecture ultérieure

add a note

User Contributed Notes 3 notes

down

tudor at culise dot net ¶

6 years ago


This class is extendable, but it's too bad that its constructor cannot be overriden (PHP says it's a final method). Thus the class should be wrapped using the delegation principle rather that extended.

down

kumarldh at gmail dot com ¶

2 years ago


Using libxml_use_internal_errors() may suppress errors but Exception still requires decent handling. I used following code snippet.





<?php


libxml_use_internal_errors(true);


try{


    $xmlToObject = new SimpleXMLElement($notSoWellFormedXML);


} catch (Exception $e){


    echo 'Please try again later...';


    exit();


}


?>

down

uramihsayibok, gmail, com ¶

4 years ago


As I was filling out a bug report, I realized why (speculation here) the constructor is final: so that functions like simplexml_load_file and simplexml_load_string can work. I imagine the PHP-ized code looks something like





<?php





function simplexml_load_file($filename, $class_name = "SimpleXMLElement", $options = 0, $ns = "", $is_prefix = false) {


    return new $class_name($filename, $options, true, $ns, $is_prefix);


}





?>





If we were to use a different $class_name and change the constructor's definition these functions wouldn't work.





There's no easy, sensible solution that keeps simplexml_load_file and simplexml_load_string.

add a note