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.
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_urlvautTRUE. -
options -
Optionnellement utilisé pour spécifier des paramètres Libxml additionnels.
-
data_is_url -
Par défaut,
data_is_urlvautFALSE. UtilisezTRUEpour spécifier que le paramètredataest 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 -
TRUEsinsest un préfix,FALSEsinon. 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 4 notes
tudor at culise dot net ¶
6 years ago
bertolini dot cedric at me dot com ¶
1 month ago
It's worth noting that the behavior of SimpleXmlElement::__construct is not exactly the same as simplexml_load_string, regarding libxml_use_internal_errors().
In my case,
<?php
libxml_use_internal_errors(true);
new \SimpleXmlElement($data);
?>
was still throwing error. But as soon as I switched to
<?php
libxml_use_internal_errors(true);
simplexml_load_string($data);
?>
everything worked fine and I stopped getting an error.
kumarldh at gmail dot com ¶
3 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();
}
?>
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.
