Manuel PHP
PrécédentSuivant

unserialize

(PHP 3>= 3.0.5, PHP 4 )

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

Description

mixed unserialize ( string str [, string callback])

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 integer, double, string, array ou object. Les objets linéarisés perdent leurs méthodes.

Directive unserialize_callback_func : Il est possible de définir une fonction de callback qui sera appelée si une classe undé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 instantié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.

Note : Le paramètre callback est disponible depuis PHP 4.2.0.

Si la variable délinéarisée est un objet, après avoir réussi à le reconstruire, PHP appelera 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 :  moncallbackfunction

  function moncallback($classname) {
    // Incluez simplement in fichier contenant votre d&eacute;finition de classe
    // vous saurez quelle classe gr&acirc;ce &agrave; $classname
  }
?>

Note : En PHP 3, les méthodes ne sont pas préservées lors de la délinéarisation d'un bojet. PHP 4 lève cette limitation, 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&eacute;es de sessions
// depuis la base de donn&eacute;es, dans $session_data. Cet exemple compl&egrave;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&eacute;paration ou la lecture &eacute;choue, on cr&eacute;e un tableau vide
    $session_data = array();
} else {
    // les donn&eacute;es sauv&eacute;es sont dasn $tmp[0].
    $session_data = unserialize ($tmp[0]);
    if (!is_array ($session_data)) {
    // Erreur... initialisation &agrave; tableau vide
    $session_data = array();
    }
}
?>

Voir aussi serialize().

PrécédentSommaireSuivant
strvalNiveau supérieurunset