(PHP 4, PHP 5)
serialize — Linéarise une variable
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().
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.
Retourne une chaîne contenant une représentation linéaire
de value, pour stockage.
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 ! */
}
}
?>
| Version | Description |
|---|---|
| 4.0.7 | Le processus de linéarisation a été corrigé. |
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.