8.126 Fonctions de gestion des variables 
8 Référence des fonctions 
 Manuel PHP 
 . Introduction . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes pré-définies . debug_zval_dump . doubleval . empty . floatval . get_defined_vars . get_resource_type . gettype . import_request_variables . intval . is_array . is_bool . is_callable . is_double . is_float . is_int . is_integer . is_long . is_null . is_numeric . is_object . is_real . is_resource . is_scalar . is_string . isset . print_r . serialize . settype . strval ->unserialize . unset . var_dump . var_export
 
  | 
 
  8.126.36 unserialize()
     Crée une variable PHP à partir d'une valeur linéarisée
    [ Exemples avec unserialize ]   PHP 3>= 3.0.5, PHP 4 , PHP 5 
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
 .
     
| 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.
      
 | 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 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
 .
    
 |