(PHP 5, PHP 7, PHP 8)
simplexml_load_file — Übersetzt eine XML-Datei in ein Objekt
$filename
,$class_name
= SimpleXMLElement::class,$options
= 0,$namespace_or_prefix
= "",$is_prefix
= false
Die Funktion wandelt das übergebene wohlgeformte (well-formed) XML-Dokument in ein Objekt um.
filename
Der Pfad zur XML-Datei.
class_name
Der optionale Parameter class_name
kann
verwendet werden, wenn simplexml_load_file() ein
Objekt der spezifischen Klasse zurückgeben soll. Die gewählte Klasse
sollte von der Klasse SimpleXMLElement abgeleitet sein.
options
Bitweises OR
von libxml-Konstanten für weitere Optionen.
namespace_or_prefix
Ein Namensraum-Präfix oder URI.
is_prefix
true
, wenn namespace_or_prefix
ein Präfix ist,
false
, wenn er ein URI ist. Der Standardwert ist false
.
Gibt ein Objekt der Klasse SimpleXMLElement
zurück, dessen Eigenschaften die Daten des XML-Dokuments enthalten.
Bei einem Fehler wird false
zurückgegeben.
Diese Funktion kann sowohl das
boolsche false
zurückliefern, als auch einen nicht-boolschen Wert, welcher zu false
ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
Generiert eine Fehlermeldung vom Typ E_WARNING
für
jeden in den XML-Daten gefundenen Fehler.
libxml_use_internal_errors() kann hier verwendet werden, um alle XML-Fehlermeldungen auszublenden, und libxml_get_errors(), um danach darüber zu iterieren.
Beispiel #1 Ein XML-Dokument auswerten
<?php
// Die Datei test.xml enthält ein XML-Dokument mit einem Wurzel-Element
// und mindestens einem Element /[root]/title.
if (file_exists('test.xml')) {
$xml = simplexml_load_file('test.xml');
print_r($xml);
} else {
exit('Konnte test.xml nicht öffnen.');
}
?>
Das Skript gibt nach erfolgreichem Laden folgendes aus:
SimpleXMLElement Object ( [title] => Beispiel-Titel ... )
Ab diesem Punkt können $xml->title
und andere
Elemente verwendet werden.