array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'class.serializable.php', 1 => 'Serializable', 2 => 'Das Serializable-Interface', ), 'up' => array ( 0 => 'reserved.interfaces.php', 1 => 'Vordefinierte Interfaces und Klassen', ), 'prev' => array ( 0 => 'arrayaccess.offsetunset.php', 1 => 'ArrayAccess::offsetUnset', ), 'next' => array ( 0 => 'serializable.serialize.php', 1 => 'Serializable::serialize', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'language/predefined/serializable.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.serializable.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Das Serializable-Interface

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

Einführung

Interface für benutzerdefiniertes Serialisieren.

Die Klassen, die dieses Interface implementieren, unterstützen __sleep und __wakeup nicht mehr. Die Methode serialize wird immer aufgerufen, wenn eine Instanz serialisiert werden muss. Dabei wird weder __destruct() aufgerufen noch irgend ein anderer Nebeneffekt erzeugt, es sei denn, ein solcher wird in der Methode serialize explizit erzeugt. Wenn die Daten deserialisiert werden, ist die Klasse bekannt und die passende unserialize()-Methode wird anstelle des Konstruktors __construct() aufgerufen. Falls notwendig, kann der Standardkonstruktor innerhalb von unserialize() aufgerufen werden.

Warnung

Seit PHP 8.1.0 erzeugt eine Klasse, die Serializable implementiert, ohne gleichzeitig auch __serialize() und __unserialize() zu implementieren, eine Deprecated- (veraltet) Warnung.

Interface-Übersicht

interface Serializable {
/* Methoden */
public serialize(): ?string
public unserialize(string $data): void
}

Beispiele

Beispiel #1 Grundlegende Verwendung

<?php
class obj implements Serializable {
private $data;
public function __construct() {
$this->data = "Meine private-Daten";
}
public function serialize() {
return serialize($this->data);
}
public function unserialize($data) {
$this->data = unserialize($data);
}
public function getData() {
return $this->data;
}
}

$obj = new obj;
$ser = serialize($obj);

var_dump($ser);

$newobj = unserialize($ser);

var_dump($newobj->getData());
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

string(42) "C:3:"obj":27:{s:19:"Meine private-Daten";}"
string(19) "Meine private-Daten"

Inhaltsverzeichnis