serialize

(PHP 4, PHP 5, PHP 7)

serialize — Génère une représentation stockable d'une valeur

Description

string serialize ( mixed $value )

Retourne un tableau en chaine de caractère.

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

Pour récupérer une variable linéarisée et retrouver une valeur PHP, utilisez unserialize().

Liste de paramètres

value

La valeur à linéariser. serialize() accepte tous les types sauf les ressources. Vous pouvez même linéariser un tableau qui contient des références sur lui-même. Les références cycliques dans des tableaux/objets 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'attribut ; les attributs protégés seront préfixés avec un astérisque '*'. Ces valeurs préfixées ont des caractères nuls des deux cotés.

Valeurs de retour

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

Notez que cette chaîne est une chaîne binaire qui peut inclure des octets nuls, et doit donc être stockée et gérée comme telle. Par exemple, la sortie de la fonction serialize() doit généralement être stockée dans un champ de type BLOB d'une base de données, plutôt que dans un champ de type CHAR ou TEXT.

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 ! */
    }
}
?>

Notes

Note:
Notez que de nombreux 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, où des objets internes peuvent être linéarisés alors qu'ils n'implémentent pas l'interface ou n'exposent pas les méthodes magiques prévues à cet effet. On pourra notamment citer ArrayObject avant PHP 5.2.0.

Avertissement

Lorsque la fonction serialize() linéarise des objets, l'anti-slash de fin n'est pas inclus dans l'espace de nom du nom de la classe et ce, pour un maximum de compatibilité.

Voir aussi

unserialize() - Crée une variable PHP à partir d'une valeur linéarisée
var_export() - Retourne le code PHP utilisé pour générer une variable
json_encode() - Retourne la représentation JSON d'une valeur
La linéarisation d'objets
__sleep()
__wakeup()

Rechercher une fonction PHP

Version en cache

21/11/2024 18:49:25 Cette version de la page est en cache (à la date du 21/11/2024 18:49:25) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.serialize.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

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.

Table des matières Haut