Forum und email

unserialize

(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.

Warning

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.

Note: 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.

Example#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.

Example#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().