aboutcoders/enum-serializer-bundle

A symfony bundle to serialize/deserialize enumerations of type myclabs/php-enum with jms/serializer

AbcEnumSerializerBundle

A symfony bundle to serialize/deserialize enumerations of type myclabs/php-enum with jms/serializer., _(*1)

Build Status: , _(*2)

Note: At this point json is the only supported format., _(*3)

Installation

Add the AbcEnumSerializerBundle to your composer.json file:, _(*4)

php composer.phar require aboutcoders/enum-serializer-bundle

Include the bundle in the AppKernel.php class:, _(*5)

``` php, <sub>(*6)</sub>

app/AppKernel.php

public function registerBundles() { $bundles = array( ... new Abc\Bundle\EnumSerializerBundle\AbcEnumSerializerBundle(), ); }, <sub>(*7)</sub>

## Usage

Define the enum as defined by [myclabs/php-enum](https://github.com/myclabs/php-enum):

``` php
namespace Acme;

use MyCLabs\Enum\Enum;

class MyEnum
{
    const VALUE_1;
    const VALUE_2;
}

In order to serialize/deserialize the enumeration you can register the type in app/config.yml, <sub>(*8)</sub>

``` yaml, <sub>(*9)</sub>

app/config/config.yml

abc_enum_serializer: serializer: types: - Acme\MyEnum, <sub>(*10)</sub>

or you can register the enum within the service container and tag it with with the tag `abc.enum`

``` yaml
services:
    my_enum:
        class: Acme\MyEnum
        tags:
            - { name: abc.enum }

Note, this service should be declared private and should never be instantiated, since this would lead to an exception. The only purpose of this service is to provide the fully qualified name of the class that needs to be registered as enum type., <sub>(*11)</sub>

Finally you can configure the type in case you use it as a member variable, <sub>(*12)</sub>

``` php use JMS\Serializer\Annotation\Type;, <sub>(*13)</sub>

class MyExample {, <sub>(*14)</sub>

/**
 * @Type("Acme\MyEnum")
 */
private $myEnum;

}, <sub>(*15)</sub>

or serialize/deserialize it directly referencing the type:

``` php

$serializer = $container->get('jms_serializer');

$data = $serializer->serialize($subject, 'json');

$enum = $this->serializer->deserialize($data, MyExample::class, 'json');

ToDo

• Add support for the formats XML and YAML