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, ein XML-Dokument, das durch ein SimpleXMLElement-Objekt repräsentiert wird, als string zu exportieren.

Die Methode SimpleXMLElement::saveXML() verstehen

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

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

Dabei ist $node ein optionaler Parameter, der einen zu exportierenden Kindknoten angibt. Wird er weggelassen, 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 den XML-string bei Erfolg zurück oder false bei einem Fehler. (Hinweis: Die Nullable-Parameter-Syntax ?SimpleXMLElement erfordert PHP 7.1 oder höher.)

Verwendungsbeispiel

Das folgende Beispiel demonstriert die string-Ausgabe und das Speichern in eine Datei, einschließlich grundlegender Fehlerbehandlung:

<?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 und einem darin enthaltenen title-Kindelement repräsentiert. 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 eine Datei erfordert Schreibberechtigungen für das Zielverzeichnis.)

Fazit

Die Methode SimpleXMLElement::saveXML() ist ein unverzichtbares Werkzeug für die Arbeit mit XML in PHP. Sie bietet eine unkomplizierte Möglichkeit, XML-Daten als string mithilfe objektorientierter Syntax zu exportieren. Durch das Verstehen der Parameter und Rückgabewerte können Entwickler XML-Dokumente in ihren Anwendungen zuverlässig verwalten.

Übungen