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 entier, double, string, array ou object. Si la chaîne passée ne peut être délinéarisée, cette fonction retourne FALSE.

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 in 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 échoue, 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 à tableau vide
        
$session_data = array();
    }
}
?>

Voir aussi serialize().