Fonctions de gestion des variables
PHP Manual

serialize

(PHP 4, PHP 5)

serializeLinéarise une variable

Description

string serialize ( mixed $value )

Linéarise une variable.

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

Liste de paramètres

value

La valeur à linéariser. 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:

Les attributs privés d'un objet auront le nom de la classe préfixé au nom de l'attributs; les attributs protégés seront préfixé avec un astérisque '*'. Ces valeurs préfixées ont des caractèrs nuls des deux cotés.

Valeurs de retour

Retourne une chaîne contenant une représentation linéaire de value, pour stockage.

Exemples

Exemple #1 Exemple avec serialize()

<?php
// $session_data contient un tableau multidimensionnel , 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), $_SERVER['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 ! */
    
}
}
?>

Historique

Version Description
4.0.7 Le processus de linéarisation a été corrigé.

Notes

Note:

Notez que la plupart des objets internes de PHP ne peuvent être linéarisés. Cependant, ceux qui le peuvent implémentent l'interface Serializable ou définissent les méthodes magiques __sleep() et __wakeup(). Si une classe interne n'utilise pas une de ces techniques, alors elle ne peut être linéarisée de manière sûre.

Il existe des exceptions historiques à cette règle, des objets internes peuvent être linéarisés alors qu'ils n'implémentent pas l'interface ou n'utilise pas les méthodes magiques prévues à cet effet. On pourra citer ArrayObject avant PHP 5.2.0.

Voir aussi


Fonctions de gestion des variables
PHP Manual