PHP Conference Nagoya 2025

    SimpleXMLElement::asXML

    (PHP 5, PHP 7, PHP 8)

    SimpleXMLElement::asXML — Liefert einen wohlgeformten XML-String, der auf einem SimpleXML-Element basiert

    Beschreibung

    public SimpleXMLElement::asXML(?string $filename = null): string|bool

    Die asXML-Methode formatiert den Inhalt des Elternobjekts als XML Version 1.0.

    Parameter-Liste

    filename

    Falls ein String-Wert angegeben wird, schreibt die Funktion die Daten in die Datei, anstatt sie direkt zurückzugeben.

    Rückgabewerte

    Ist der Parameter filename nicht angegeben, gibt die Funktion bei erfolgreicher Umwandlung einen String zurück oder false bei einem Fehler. Ist der Parameter angegeben, wird true zurückgegeben, wenn die Datei erfolgreich erstellt werden konnte; ansonsten ist der Rückgabewert false.

    Changelog

    Version Beschreibung
    8.0.0 filename ist jetzt nullable (akzeptiert den NULL-Wert).

    Beispiele

    Beispiel #1 XML erstellen

    <?php
    $string     = <<<XML
    <a>
    <b>
    <c>text</c>
    <c>zeugs</c>
    </b>
    <d>
    <c>code</c>
    </d>
    </a>
    XML;

    $xml = new SimpleXMLElement($string);

    echo     $xml->asXML();

    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    <?xml version="1.0"?>
<a>
 <b>
  <c>text</c>
  <c>stuff</c>
 </b>
 <d>
  <c>code</c>
 </d>
</a>

    asXML lässt sich ebenfalls auf Xpath-Ergebnisse anwenden:

    Beispiel #2 Anwendung von asXML() auf SimpleXMLElement::xpath()-Ergebnisse

    <?php
    // Fortsetzung des obigen Beispiels

    /* Suche nach <a><b><c> */
    $result = $xml->xpath('/a/b/c');

    foreach (    $result as $node) {
    echo     $node->asXML();
    }
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    <c>text</c><c>stuff</c>

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    33
    andreas dot theissen at t-online dot de
    12 years ago
    To prevent asXML from encoding vowels unwantedly, simply use an approriate XML header with encoding in advance.

    If you do so, asXML will happily leave your vowels (and the header) entirely untouched.

    <?php

    $xmlstr     =
    '<?xml version="1.0" encoding="UTF-8"?>
    <keys>
    <key lang="en">&lt;Insert&gt;</key>
    <key lang="de">&lt;Einfügen&gt;</key>
    </keys>'    ;

    $sxe = new SimpleXMLElement($xmlstr);

    $output = $sxe->asXML();

    ?>

    $xmlstr and $output are identical now.

    The subsequent use of html_entity_decode() (as proposed in the very beginning in another post) has several drawbacks:

    1. It is slow
    2. It is expensive
    3. If there are already encoded arrow brackets or double quotes in your source for instance (as shown in the above example), markup will be broken.
    up
    9
    oleg dot pavlin at gmail dot com
    12 years ago
    Function asXML decodes special chars like ø, æ and others to &#xE6;, &#xF8;

    To get normal output use without quoting:

    $xml = html_entity_decode($xml, ENT_NOQUOTES, 'UTF-8');
    ＋add a note
    To Top