Manuel PHP
Précédent |  | Suivant

# unserialize

(PHP 3 >= 3.0.5, PHP 4, PHP 5)

unserialize -- Crée une variable PHP à partir d'une valeur linéarisée

## Description

mixed unserialize ( string str )

unserialize() prend une variable linéarisée (voir serialize()) et la convertit en variable PHP. La valeur convertie est retournée par la fonction, et peut être de type boolean, entier, float, string, array ou object. Si la chaîne passée ne peut être délinéarisée, cette fonction retourne `FALSE` et une erreur `E_NOTICE` est émise.

Avertissement
`FALSE` est retourné dans les cas ou il y a une erreur et dans la délinéarisation de la valeur linéarisée `FALSE`. Il est possible d'attraper ce cas spécial en comparant `str` avec `serialize(false)` ou en attrapant l'erreur `E_NOTICE` émise.

> Directive `unserialize_callback_func` : Il est possible de définir une fonction de callback qui sera appelée si une classe indéfinie est utilisée lors de la délinéarisation (ce qui évitera de voir l'objet recevoir le type d'objet incomplet object "`__PHP_Incomplete_Class`"). Utilisez dans votre fichier `php.ini` ou le fichier `.htaccess`, ou encore avec la fonction ini_set(), pour définir une fonction `unserialize_callback_func()`. Chaque fois qu'une classe non-définie sera instanciée, cette fonction sera appelée. Pour désactiver cette fonctionnalité, laissez la simplement vide. Notez aussi que cette directive n'est disponible que depuis PHP 4.2.0.

Si la variable délinéarisée est un objet, après avoir réussi à le reconstruire, PHP appellera automatiquement la méthode `__wakeup()` si elle existe.

Exemple 1. Exemple avec la directive `unserialize_callback_func`

`<?php $serialized_object='O:1:"a":1:{s:5:"value";s:3:"100";}'; // directive unserialize_callback_func disponible depuis PHP 4.2.0 ini_set('unserialize_callback_func','moncallback'); // configure votre fonction de callback : moncallback function moncallback($classname) { // Incluez simplement un fichier contenant votre définition de classe // vous saurez quelle classe grâce à $classname } ?>`

> Note : En PHP 3, les méthodes ne sont pas préservées lors de la délinéarisation d'un objet. Cette limitation a été levée en PHP 4 et stocke désormais les méthodes et les membres. Voyez le chapitre sur la Linéarisation des objets du chapitre Classes et Objets.

Exemple 2. Exemple avec unserialize()

`<?php
// Ici, on utilise <function>unserialize</function> pour charger les données de sessions
// depuis la base de données, dans $session_data. Cet exemple complète
// celui fourni avec <function>serialize</function>.
$conn = odbc_connect("webdb", "php", "chicken");
$stmt = odbc_prepare($conn, "SELECT data FROM sessions WHERE id = ?");
$sqldata = array($PHP_AUTH_USER);
if (!odbc_execute($stmt, &$sqldata) || !odbc_fetch_into($stmt, &$tmp)) {
// si la préparation ou la lecture échouent, on crée un tableau vide
$session_data = array();
} else {
// les données sauvées sont dans $tmp[0].
$session_data = unserialize($tmp[0]);
if (!is_array($session_data)) {
// Erreur... initialisation d'un tableau vide
$session_data = array();
}
}
?>`

Voir aussi serialize().

Précédent | Sommaire | Suivant
strval | Niveau supérieur | unset