Forum und email

serialize

(PHP 4, PHP 5, PECL axis2:0.1.0-0.1.1)

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. Toutes les autres références seront perdues.

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é enlevée en PHP 4 et restaure les propriétés et les méthodes. Merci de voir la section sur la linéarisation d'objets des classes et objets pour plus d'informations.
Il n'est pas possible de linéariser les objets internes de PHP.

Example#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().