unserialize

(PHP 3 >= 3.0.5, 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.

Avertissement

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.

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

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

Rechercher une fonction PHP

<- unpack unset ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

5 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Références

Manuel PHP : http://be2.php.net, unserialize

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :
Références

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-4152
Document créé le 28/09/06 03:05, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/php-rf-function.unserialize.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02