serialize

(PHP 3>= 3.0.5, PHP 4 , PHP 5)

serialize --  Linéarise une variable

Description

string serialize ( mixed value )

serialize() retourne une chaîne contenant une représentation linéaire de value, pour stockage.

C'est une technique pratique pour stocker ou passer des valeurs de PHP entre scripts, sans perdre ni leur structure, ni leur type.

Pour récupérer une variable linéarisée, et retrouver une variable, utilisez unserialize(). serialize() acceptent tous les types sauf les ressources. Vous pouvez linéariser un tableau qui contient une référence sur lui-même. Les références dans ce tableau/objet seront également stockées.

Lors de la linéarisation d'un objet, PHP tentera d'appeler la fonction membre __sleep() avant de linéariser. Cela permet à l'objet de faire un dernier nettoyage, etc. avant d'être linéarisé. De même, lorsque l'objet est restauré en utilisant unserialize(), la fonction membre __wakeup() est appelée.

Note : Ceci ne fonctionne pas correctement avant la version 4.0.7.

Note : En PHP 3, les propriétés de l'objet seront linéarisées, mais les méthodes seront perdues. Cette limitation a été enlève en PHP 4 et restaure les propriétés et les méthodes. Merci de voir la section sur la linéarisations d'objets des classes et objets pour plus d'informations.

Il n'est pas possible de linéariser les objets internes de PHP.

Exemple 1. Exemple avec serialize()

<?php
// $session_data contient un tableau multi-dimensionnel , avec les
// informations de session de l'utilisateur courant. On utilise serialize()
// pour les stocker dans une base de données

$conn = odbc_connect("webdb", "php", "chicken");
$stmt = odbc_prepare($conn,
      
"UPDATE sessions SET data = ? WHERE id = ?");
$sqldata = array(serialize($session_data), $PHP_AUTH_USER);
if (!
odbc_execute($stmt, &$sqldata)) {
    
$stmt = odbc_prepare($conn,
     
"INSERT INTO sessions (id, data) VALUES(?, ?)");
    if (!
odbc_execute($stmt, &$sqldata)) {
        
/* Un problème est survenu ! */
    
}
}
?>

Voir aussi unserialize().