6.38 Fonctions de gestion des variables
6 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
|
6.38.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
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.
| Attention | |
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
. Le cas spécial peut
être analysé 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.
| 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
.
|