SimpleXMLElement::__construct

(PHP 5, PHP 7, PHP 8)

SimpleXMLElement::__construct — Erstellt ein neues SimpleXMLElement-Objekt

Beschreibung

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

Erstellt ein neues SimpleXMLElement-Objekt.

Parameter-Liste

data: Ein wohlgeformter XML-String, oder der Pfad oder URL zu einem XML-Dokument, wenn data_is_url true ist.
options: Optional zu verwenden, um weitere Libxml Parameter anzugeben, die das Lesen von XML-Dokumenten betreffen. Optionen, die die Ausgabe von XML-Dokumenten betreffen (z. B. LIBXML_NOEMPTYTAG) werden stillschweigend ignoriert.

Hinweis:
Es kann erforderlich sein, die Option LIBXML_PARSEHUGE zu übergeben, um tief verschachteltes XML oder sehr große Textknoten verarbeiten zu können.
data_is_url: Standardmäßig ist data_is_url false. Verwenden Sie true, um data als Pfad oder URL zu einem XML-Dokument an Stelle eines Daten-Strings anzugeben.
ns: Namensraum-Präfix oder -URI.
is_prefix: true, wenn ns ein Präfix ist, false, wenn es ein URI ist; der Standardwert ist false.

Rückgabewerte

Gibt ein SimpleXMLElement-Objekt zurück, das data repräsentiert.

Fehler/Exceptions

Erzeugt eine E_WARNING-Fehlermeldung für jeden gefundenen Fehler in den XML-Daten und wirft zusätzlich eine Exception, wenn die XML-Daten nicht geparst werden konnten.

Tipp

libxml_use_internal_errors() kann verwendet werden, um alle XML-Fehler zu unterdrücken, und libxml_get_errors(), um danach über diese zu iterieren.

Beispiele

Hinweis:
Die aufgeführten Beispiele binden möglicherweise example.php ein, das die XML-Zeichenkette enthält, die im ersten Beispiel über die grundlegende Verwendung zu finden ist.

Beispiel #1 Erstellen eines SimpleXMLElement-Objekts


<?php

include 'example.php';

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

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

PHP: Behind the Parser

Beispiel #2 Erstellen eines SimpleXMLElement-Objekts von einer URL


<?php

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

?>

Siehe auch

Grundlegende SimpleXML Verwendung
simplexml_load_string() - Übersetzt einen XML-String in ein Objekt
simplexml_load_file() - Übersetzt eine XML-Datei in ein Objekt
Behandlung von XML-Fehlern
libxml_use_internal_errors() - Disable libxml errors and allow user to fetch error information as needed

add a note

User Contributed Notes 7 notes

down

ahmad dot mayahi at gmail dot com ¶

7 years ago


You won't be able to load an XML file without root element:

//This will throw an exception
$xml = new SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?>', null, false);

//Here is the solution
$xml = new SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?><root></root>', null, false);

down

tudor at culise dot net ¶

16 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

rowan dot collins at gmail dot com ¶

7 years ago


The manual doesn't really explain what the $ns argument (and the accompanying $is_prefix) are for.

What they do is similar to the ->children() method: they set the context of the returned object to that namespace, so that access via ->elementName and ['attributeName'] refer to elements and attributes in that namespace.

In particular, they do *not* change the namespaces which exist on the document.

See this example:

<?php
// This XML contains two elements called <child>
// One is in the namespace http://example.com, with local prefix 'ws'
// The other has no namespace (no prefix, and no default namespace declared)
$xml = '<ws:example xmlns:ws="http://example.com"><child>Not in namespace</child><ws:child>In example namespace</ws:child></ws:example>';

$sx0 = new SimpleXMLElement($xml, 0, false);
$sx1 = new SimpleXMLElement($xml, 0, false, 'http://example.com');
$sx2 = new SimpleXMLElement($xml, 0, false, 'ws', true);

echo "
    Without: {$sx0->child}
    By namespace: {$sx1->child}
    By prefix: {$sx2->child}
";
?>

Output:

 Without: Not in namespace
 By namespace: In example namespace
 By prefix: In example namespace

down

kumarldh at gmail dot com ¶

13 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

bertolini dot cedric at me dot com ¶

9 years 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.

down

-2

Phil Cross ¶

9 years ago


It's worth noting, that you need to typecast dynamic property names to string in order to retrieve there value, for example:

<?php 
    $xml = new SimpleXMLElement('records.xml', 0, true);

    // This will work as expected because its a hard coded property value
    foreach($xml as $record){
        echo $record->id;    // Will output the ID fine
    }

    // Dynamic properties require typecasting to string
    $xml_field = 'id';
    foreach($xml as $record){

        // This will dump a SimpleXMLElement object
        var_dump($record->$xml_field);

        // This will output the value as expected
        echo (string)$record->$xml_field;
    }
?>

down

-2

uramihsayibok, gmail, com ¶

14 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