Les adaptateurs Zend_Serializer servent à changer les méthodes
de sérialisation facilement.
Chaque adaptateurs possède ses propres atouts et inconvénients. Dans certains cas, certains
types PHP (objets) ne peuvent être représentés sous forme de chaines. Dans ce cas, ces types
seront convertis vers un type sérialisable (par exemple, les objets seront convertis en tableaux).
Ci ceci échoue, une exception Zend_Serializer_Exception sera alors envoyée.
Voici une liste des adaptateurs disponibles.
Cet adaptateur utilise les fonctions PHP un/serialize et
constitue un bon choix d'adaptateur par défaut.
Aucune option de configuration n'existe pour cet adaptateur.
Igbinary est un logiciel Open Source crée par Sulake Dynamoid Oy. C'est un remplaçant du sérialiseur utiliser par PHP. Au lieu d'utiliser une représentation textuelle (couteuse en temps et en poids), igbinary représente les structures de données PHP dans un format binaire compact. Les gains sont importants lorsqu'un système de stockage comme memcache est utilisé pour les données sérialisées.
L'extension PHP igbinary est requise pour l'utilisation de cet adaptateur.
Aucune option de configuration n'existe pour cet adaptateur.
WDDX (Web Distributed Data eXchange) est à la fois un langage de programmation, une plateforme et un mecanisme de transport de données entre différents environnements.
Cet adaptateur utilise simplement les fonctions PHP wddx_*(). Veuillez lire le manuel PHP afin de vérifier la disponibilité et l'installation de ces fonctions.
Aussi, l'extension PHP SimpleXML est utilisée
pour vérifier si une valeur NULL retournée par
wddx_unserialize() est basée sur une donnée sérialisée
NULL ou au contraire des données non valides
Les options disponibles sont:
Tableau 131. Options Zend_Serializer_Adapter_Wddx
| Option | Type de donnée | Valeur par défaut | Description |
|---|---|---|---|
| comment | chaine | Un commentaire qui apparait dans l'en-tête du paquet. |
L'adaptateur JSON acréer un pont vers
Zend_Json et/ou ext/json (l'extension json de PHP).
Pour plus d'informations, lisez le manuel de Zend_Json.
Les options disponibles sont:
Tableau 132. Options Zend_Serializer_Adapter_Json
| Option | Type de donnée | Valeur par défaut | Description |
|---|---|---|---|
| cycleCheck | booléen | false | Voyez cette section |
| objectDecodeType | Zend_Json::TYPE_* | Zend_Json::TYPE_ARRAY | Voyez this section |
| enableJsonExprFinder | booléen | false | Voyez la section intitulée « JSON Expressions » |
Les adaptateurs AMF, Zend_Serializer_Adapter_Amf0
et Zend_Serializer_Adapter_Amf3, sont un pont vers le sérialiseur
du composant Zend_Amf. Veuillez lire la documentation de Zend_Amf documentation pour plus
d'informations.
Aucune option de configuration n'existe pour cet adaptateur.
Cet adaptateur convertit des types PHP vers une chaine Python Pickle Grâce à lui, vous pouvez lire en Python des données sérialisées de PHP et inversement.
Les options disponibles sont:
Tableau 133. Options Zend_Serializer_Adapter_PythonPickle
| Option | Type de donnée | Valeur par défaut | Description |
|---|---|---|---|
| protocol | entier (0 | 1 | 2 | 3) | 0 |
La version du protocole Pickle pour serialize
|
Le transtypage (PHP vers Python) se comporte comme suit:
Tableau 134. Le transtypage (PHP vers Python)
| Type PHP | Type Python |
|---|---|
| NULL | None |
| booléen | booléen |
| entier | entier |
| flottant | flottant |
| chaine | chaine |
| tableau | liste |
| tableau associatif | dictionnaire |
| objet | dictionnaire |
Le transtypage (Python vers PHP) se comporte comme suit:
Tableau 135. Transtypage (Python vers PHP):
| Type Python | Type PHP |
|---|---|
| None | NULL |
| booléen | booléen |
| entier | entier |
| long |
entier
| flottant
| chaine
| Zend_Serializer_Exception
|
| flottant | flottant |
| chaine | chaine |
| octets | chaine |
| chaine Unicode | chaine UTF-8 |
| list | tableau |
| tuple | tableau |
| dictionnaire | tableau associatif |
| Tout autre type | Zend_Serializer_Exception |
Cet adaptateur génère une chaine représentant du code analysable par PHP via var_export().A la désérialisation, les données seront exécutées par eval.
Aucune option de configuration n'existe pour cet adaptateur.
Désérialiser des objets
Les objets seront sérialisés en utilisant la méthode magique__set_state Si la classe ne propose pas cette méthode, une erreur fatale aboutira.
Utilisation de eval()
L'adaptateur PhpCode utilise eval()
pour désérialiser. Ceci mène à des problèmes de performance et de sécurité, un nouveau processus
sera crée. Typiquement, vous devriez utiliser l'adaptateur
PhpSerialize à moins que vous ne vouliez que les données sérialisées
ne soient analysables à l'oeil humain.