wddx_serialize_value — Funktion · PHP-Referenz

Signatur

wddx_serialize_value(mixed $var, string $comment = ""): string|false

Beschreibung

wddx_serialize_value() wandelt einen einzelnen PHP-Wert (Skalar, Array oder Objekt) in ein WDDX-konformes XML-Paket um. WDDX (Web Distributed Data eXchange) ist ein XML-basiertes Format, das den Datenaustausch zwischen verschiedenen Programmiersprachen und Systemen ermöglichen soll.

Die Funktion eignet sich für einfache Anwendungsfälle, bei denen genau ein Wert serialisiert werden soll. Sollen mehrere Werte in einem einzigen Paket gebündelt werden, empfiehlt sich stattdessen die Kombination aus wddx_packet_start(), wddx_add_vars() und wddx_packet_end().

Der optionale Parameter comment erlaubt es, dem erzeugten WDDX-Paket einen lesbaren Kommentar (z. B. eine Beschreibung des Inhalts) beizufügen, der im Header-Element des XML erscheint.

Achtung: Die WDDX-Erweiterung wurde mit PHP 7.4 als veraltet markiert und in PHP 8.0 vollständig entfernt. Für neue Projekte sollten stattdessen standardisierte Formate wie JSON (json_encode()) oder XML-Bibliotheken wie SimpleXML verwendet werden.

Parameter

Name	Typ	Default	Beschreibung
$var Pflicht	mixed		Der zu serialisierende Wert. Kann ein Skalar (Integer, Float, String, Boolean), ein Array oder ein Objekt sein.
$comment	string	""	Optionaler Kommentartext, der im Header-Element des erzeugten WDDX-Pakets erscheint. Dient der Dokumentation des Paketinhalts.

Rückgabewert

Typ

string|false

Beschreibung

Gibt bei Erfolg den WDDX-Paket-String (valides XML) zurück. Im Fehlerfall wird false zurückgegeben.

Beispiele

Einfachen String serialisieren

<?php
// Einen einfachen String als WDDX-Paket erzeugen
$wddx = wddx_serialize_value('Hallo Welt', 'Meine Begrüßung');
echo $wddx;

<wddxPacket version='1.0'><header comment='Meine Begrüßung'/><data><string>Hallo Welt</string></data></wddxPacket>

Array serialisieren und ausgeben

<?php
// Ein assoziatives Array als WDDX-Paket serialisieren
$data = [
    'name'  => 'Max Mustermann',
    'alter' => 30,
    'aktiv' => true,
];

$wddx = wddx_serialize_value($data, 'Benutzerdaten');

if ($wddx !== false) {
    // Ergebnis z. B. zur Übertragung an ein anderes System verwenden
    echo $wddx;
} else {
    echo 'Serialisierung fehlgeschlagen.';
}

<wddxPacket version='1.0'><header comment='Benutzerdaten'/><data><struct><var name='name'><string>Max Mustermann</string></var><var name='alter'><number>30</number></var><var name='aktiv'><boolean value='true'/></var></struct></data></wddxPacket>

// Wichtig · Fallstricke

Deprecation: wddx_serialize_value() wurde in PHP 7.4 als veraltet (deprecated) markiert und ist seit PHP 8.0 nicht mehr verfügbar. In modernen Projekten sollte json_encode() für die Datenserialisierung verwendet werden.

Ressource-Typen können nicht serialisiert werden und führen zu einem Fehler. Zirkuläre Referenzen in Arrays oder Objekten können ebenfalls zu unerwarteten Ergebnissen oder Fehlern führen.

Das WDDX-Format wird heute kaum noch eingesetzt und ist kein offiziell gepflegter Standard mehr – ein weiterer Grund, auf JSON oder andere moderne Formate zu migrieren.

Siehe auch

wddx_deserialize wddx_serialize_vars wddx_packet_start wddx_add_vars wddx_packet_end json_encode serialize