strval
unset
Fonctions de gestion des variables
PHP Manual

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

### Liste de paramètres

`str`

  La chaîne linéarisée.

  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.

  > Note: unserialize_callback_func directive
  > Il est possible de définir une fonction de rappel 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.

### Valeurs de retour

La valeur convertie est retournée par la fonction, et peut être de type booléen, entier, nombre décimal, chaîne de caractères, tableau ou objet.

Si la chaîne passée ne peut être délinéarisée, cette fonction retourne `FALSE` et une erreur `E_NOTICE` est émise.

### Historique

Version | Description
--- | ---
4.2.0 | La directive unserialize_callback_func devient disponible.

### Exemples

Exemple #1 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($_SERVER['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();
}
}
?>`

Exemple #2 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', 'mycallback');
function mycallback($classname)
{
// Incluez simplement un fichier contenant votre définition de classe
// vous saurez quelle classe grâce à $classname
}
?>`

### Notes

Avertissement

`FALSE` est retourné dans les cas où une erreur survient et si vous tentez de délinéariser une valeur linéarisé égale à `FALSE`. Il est possible d'intercepter ce cas spécial en comparant `str` avec serialize(false) ou en attrapant l'erreur `E_NOTICE` émise.

### Voir aussi

- serialize() - Linéarise une variable
- Auto-chargement d'objets
- unserialize_callback_func

strval
unset
Fonctions de gestion des variables
PHP Manual