unserialize
(PHP 4, PHP 5, PHP 7)
unserialize — Erzeugt aus einem gespeicherten Datenformat einen Wert in PHP
Beschreibung
unserialize() nimmt eine einzelne Variable aus einer serialisierten Datenmenge und wandelt sie in einen PHP-Wert zurück.
Unvertrauenswürdige Benutzereingaben sollten nicht an
unserialize() übergeben werden, unabhängig vom options
Wert von allowed_classes. Die Deserialisierung kann
durch Objektinstanziierung und Autoloading dazu führen, dass Code geladen
und ausgeführt wird, und ein böswilliger Anwender kann in der Lage sein das
auszunutzen. Es ist ein sicheres, standardisiertes Austauschformat wie JSON
(per json_decode() und json_encode())
zu verwenden, wenn serialisierte Daten an den Nutzer übergeben werden müssen.
Müssen extern gespeicherte serialisierte Daten unserialisiert werden, ist zu erwägen hash_hmac() zur Datenvalidierung zu verwenden. Es ist sicherzustellen, dass die Daten von niemandem außer einem selbst modifiziert wurden.
Parameter-Liste
-
str
-
Der serialisierte String.
Wenn die zu deserialisierende Variable ein Objekt ist, wird PHP nach der erfolgreichen Wiederherstellung des Objekts automatisch versuchen, die __wakeup-Methode aufzurufen (sofern diese existiert).
Hinweis: Die unserialize_callback_func-Direktive
Es ist möglich, eine Callback-Funktion anzugeben, die aufgerufen wird, wenn eine undefinierte Klasse während des Deserialisierens instanziiert werden soll (um dem Erhalt des unvollständigen object "__PHP_Incomplete_Class" vorzubeugen). Nutzen Sie Ihre php.ini, ini_set() oder .htaccess, um unserialize_callback_func festzulegen. Jedesmal, wenn eine undefinierte Klasse instanziiert werden soll, wird diese Funktion aufgerufen. Um dieses Feature abzuschalten, muss die Einstellung nur ungefüllt sein.
-
options
-
Optionen, die unserialize() als assoziatives Array zur Verfügung gestellt werden sollen.
Gültige Optionen Name Typ Beschreibung allowed_classes mixed Entweder ein Array von Klassennamen, die akzeptiert werden sollen, oder FALSE
um keine Klassen oderTRUE
um alle Klassen zu akzeptieren. Ist diese Option angegeben und unserialize() trifft auf ein Objekt einer Klasse, die nicht akzeptierbar ist, wird das Objekt statt dessen als __PHP_Incomplete_Class instantiiert. Das Auslassen dieser Option hat die gleiche Wirkung wie sie alsTRUE
anzugeben: PHP wird versuchen Objekte beliebiger Klassen zu instantiieren.
Rückgabewerte
Der konvertierte Wert wird zurückgegeben und kann vom Typ boolean, integer, float, string, array oder object sein.
Falls der übergebene String nicht deserialisierbar ist, wird FALSE
zurück
gegeben und E_NOTICE
produziert.
Changelog
Version | Beschreibung |
---|---|
7.1.0 |
Das allowed_classes Element von
options ) ist nun strikt typisiert, d.h. wird
etwas anderes als ein Array oder ein Boolean
übergeben, liefert unserialize() FALSE zurück, und
löst ein E_WARNING aus.
|
7.0.0 |
Der options Parameter wurde hinzugefügt.
|
5.6.0 | Die Manipulation der serialisierten Daten durch das Ersetzen von C: mit O: um die Objektinstanziierung ohne Aufruf des Konstruktors zu erzwingen, schlägt nun fehl. |
Beispiele
Beispiel #1 unserialize()-Beispiel
<?php
// Als Beispiel benutzen wir unserialize(), um Daten aus einer Datenbank in das
// $session_data-Array zu laden. Das Beispiel vervollständigt das unter
// serialize() beschriebene.
$conn = odbc_connect("webdb", "php", "chicken");
$stmt = odbc_prepare($conn, "SELECT data FROM sessions WHERE id = ?");
$sqldata = array($_SERVER['PHP_AUTH_USER']);
if (!odbc_execute($stmt, $sqldata) || !odbc_fetch_into($stmt, $tmp)) {
// wenn execute oder fetch fehlschlägt, initialisiere ein leeres Array
$session_data = array();
} else {
// die serialisierten Daten sollten nun in $tmp[0] stehen.
$session_data = unserialize($tmp[0]);
if (!is_array($session_data)) {
// etwas ging schief, also wieder ein leeres Array initialisieren
$session_data = array();
}
}
?>
Beispiel #2 unserialize_callback_func-Beispiel
<?php
$serialized_object='O:1:"a":1:{s:5:"value";s:3:"100";}';
ini_set('unserialize_callback_func', 'mycallback'); // Festlegen der callback_function
function mycallback($classname)
{
// einfach ein File einbinden, dass die Klassendefinitionen enthaelt
// Sie erhalten $classname, womit Sie herausfinden koennen, welche
// Klassendefinition benoetigt wird
}
?>
Anmerkungen
FALSE
wird sowohl im Fehlerfall als auch bei einem serialisierten
FALSE
-Wert zurückgegeben. Es ist möglich, diesen speziellen Fall
abzufangen, indem man str
mit
serialize(false) vergleicht oder prüft, ob ein
E_NOTICE
produziert wurde.
Siehe auch
- json_encode() - Gibt die JSON-Repräsentation eines Wertes zurück
- json_decode() - Dekodiert eine JSON-Zeichenkette
- hash_hmac() - Berechnet einen Hash mit Schlüssel unter Verwendung von HMAC
- serialize() - Erzeugt eine speicherbare Repräsentation eines Wertes
- Autoloading von Klassen
- unserialize_callback_func
- __wakeup
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-unserialize.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.