Zum Inhalt springen

registerXPathNamespace()

SimpleXMLElement::saveXML()

SimpleXML ist eine PHP-Erweiterung, die eine einfache und benutzerfreundliche API für die Arbeit mit XML-Dokumenten bereitstellt. Die Methode SimpleXMLElement::saveXML() ist eine der Kernfunktionen von SimpleXML. Sie ermöglicht es Ihnen, ein XML-Dokument, das durch ein SimpleXMLElement-Objekt dargestellt wird, als String zu exportieren.

Verständnis der Methode SimpleXMLElement::saveXML()

Die SimpleXMLElement::saveXML()-Methode exportiert ein XML-Dokument. Die Syntax für moderne PHP-Versionen lautet wie folgt:

php
saveXML ( ?SimpleXMLElement $node = null, int $options = 0 ) : string|false

Hierbei ist $node ein optionaler Parameter, der ein untergeordnetes Element angibt, das exportiert werden soll. Wenn er weggelassen wird, wird das gesamte Dokument exportiert. $options akzeptiert bitweise Flags aus den LIBXML_*-Konstanten (z. B. LIBXML_NOEMPTYTAG), um Formatierung und Ausgabeverhalten zu steuern. Die Methode gibt bei Erfolg den XML-String zurück oder false bei einem Fehler. (Hinweis: Die nullable-Parameter-Syntax ?SimpleXMLElement erfordert PHP 7.1 oder höher.)

Anwendungsbeispiel

Das folgende Beispiel zeigt die Ausgabe als String und das Speichern in einer Datei sowie eine grundlegende Fehlerbehandlung:

php
<?php

$xml = new SimpleXMLElement('<book><title>PHP Basics</title></book>');

// Return as a string
$xmlString = $xml->saveXML();
if ($xmlString !== false) {
    echo $xmlString;
}

// Save to a file
$xmlString = $xml->saveXML();
if ($xmlString !== false) {
    file_put_contents('output.xml', $xmlString);
    echo "XML saved successfully.";
} else {
    echo "Failed to save XML.";
}
?>

Im obigen Beispiel erstellen wir zunächst ein SimpleXMLElement-Objekt, das ein XML-Dokument mit einem book-Element darstellt, das ein untergeordnetes title-Element enthält. Anschließend rufen wir saveXML() ohne Argumente auf, um das XML als String abzurufen. Danach übergeben wir diesen String an file_put_contents(), um das Dokument direkt auf der Festplatte zu speichern. Die if-Prüfungen stellen sicher, dass mögliche false-Rückgaben korrekt behandelt werden. (Hinweis: Das Speichern in einer Datei erfordert Schreibrechte für das Zielverzeichnis.)

Fazit

Die SimpleXMLElement::saveXML()-Methode ist ein unverzichtbares Werkzeug für die Arbeit mit XML in PHP. Sie bietet einen unkomplizierten Weg, XML-Daten unter Verwendung einer objektorientierten Syntax als String zu exportieren. Durch das Verständnis ihrer Parameter und Rückgabewerte können Entwickler XML-Dokumente in ihren Anwendungen zuverlässig verwalten.

Praxis

Welche Funktion hat die registerXPathNamespace-Methode in PHP?

Finden Sie das nützlich?

Dual-run-Vorschau — vergleichen Sie mit den Symfony-Routen live.