PHP Dokumentation: Function simplexml-load-file
12. Januar 2010 von werner
simplexml_load_file
(PHP 5)
simplexml_load_file — Übersetzt ein XML-File in ein Objekt
Beschreibung
Die Funktion wandelt das übergebene wohlgeformte (well-formed) XML-Dokument in ein Objekt um.
Parameter-Liste
- filename
Pfad zur XML-Datei.
Hinweis: Libxml 2 demaskiert den URI, wollen Sie also zum Beispiel b&c als Wert für den URI Parameter a verwenden, müssen Sie die Funktion wie folgt aufrufen: simplexml_load_file(rawurlencode('http://example.com/?a=' . urlencode('b&c'))). Seit PHP 5.1.0 wird Ihnen dieser Schritt von PHP abgenommen.
- class_name
Sie können den optionalen Parameter class_name verwenden, wenn simple_load_file() ein Objekt der spezifischen Klasse zurückgeben soll. Die gewählte Klasse sollte von der Klasse SimpleXMLElement abgeleitet sein.
- options
Seit PHP 5.1.0 und Libxml 2.6.0 können Sie zusätzlich den Parameter options verwenden, um weitere Libxml-Parameter anzugeben.
- ns
- is_prefix
Rückgabewerte
Gibt ein object der Klasse SimpleXMLElement zurück, dessen Eigenschaften die Daten des XML-Dokuments enthalten. Im Fehlerfall wird FALSE zurückgegeben.
Fehler/Exceptions
Generiert eine Fehlermeldung vom Typ E_WARNING für jeden in den XML-Daten gefundenen Fehler.
Verwendet libxml_use_internal_errors(), um alle XML-Fehlermeldungen auszublenden, und libxml_get_errors(), um danach darüber zu iterieren.
Beispiele
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 Sie $xml->title und andere Elemente verwenden.
Siehe auch
- simplexml_load_string() – Übersetzt einen XML-String in ein Objekt
- SimpleXMLElement::__construct – Creates a new SimpleXMLElement object
- Behandlung von XML-Fehlern
- libxml_use_internal_errors() – Disable libxml errors and allow user to fetch error information as needed