# Zend_Serializer_Adapter

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.

## Zend_Serializer_Adapter_PhpSerialize

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.

## Zend_Serializer_Adapter_Igbinary

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.

## Zend_Serializer_Adapter_Wddx

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:

### 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.

## Zend_Serializer_Adapter_Json

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:

### Options Zend_Serializer_Adapter_Json

Option | Type de donnée | Valeur par défaut | Description
--- | --- | --- | ---
cycleCheck | booléen | false | Voyez
objectDecodeType | Zend_Json::TYPE_* | Zend_Json::TYPE_ARRAY | Voyez
enableJsonExprFinder | booléen | false | Voyez

## Zend_Serializer_Adapter_Amf 0 et 3

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.

## Zend_Serializer_Adapter_PythonPickle

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:

### 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:

### 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:

### 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`

## Zend_Serializer_Adapter_PhpCode

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.