Simple-Serializer

, _(*1)

Introduction

Simple-Serializer allows you to serialize your objects into a requested output format such as JSON. The library is written to work with DTO objects in the REST services., _(*2)

Built-in features include:, _(*3)

(de-)serialize object graphs
supports boolean, integer, double, DateTime<format>, array, T, array<T>, null types, where "T" - is some PHP object.
configurable via YAML
three unserialize mode (non-strict, medium strict, strict)

Unserialize mode: Non-Strict mode - serializer does not check incoming parameters Medium Strict - serializer extra check incoming parameters and if they exist throw InvalidArgumentException Strict - serializer extra check incoming parameters completely as expected if there are extra arguments or missing some, it throws an exception., _(*4)

Some Restrictions:, _(*5)

object must have configuration for serialize/unserialize

Possible TODO list:, _(*6)

(de-)serialize object graphs of any complexity including circular references
configurable via PHP, XML, or annotations
custom integrates with Doctrine ORM, et. al.

It should be noted that Simple-Serializer is realy simple library with minimum configuration, but it provides wide opportunity for create REST API., _(*7)

, _(*8)

Installation

To install Simple-Serializer with Composer just add the following to your composer.json file:, _(*9)

    // composer.json
    {
        // ...
        require: {
            // ...
            "opensoft/simple-serializer": "dev-master"
        }
    }

Then, you can install the new dependencies by running Composer's update command from the directory where your composer.json file is located:, _(*10)

$ php composer.phar update

Configuration

MyBundle\Resources\config\serializer\ClassName.yml
    Fully\Qualified\ClassName:
        properties:
            some-property:
                expose: true
                type: string
                serialized_name: foo
                since_version: 1.0
                until_version: 2.0
                groups: ['get','patch']

expose
- true
- false (default)
type
- integer
- boolean
- double
- string
- array
- T - fully qualified class name
- array<T>
- DateTime
- DateTime<format>
- format could be name of DateTime constant (COOKIE, ISO8601), string or empty (default format is ISO8601)
serialized_name
- default value is equal name property
since_version
- string
until_version
- string
groups
- array
null_skipped
- true
- false (default)

Serializing Objects

Most common usage is probably to serialize objects. This can be achieved very easily:, _(*11)

    <?php
    //get Serializer
    $serializer = $this->getSerializer();
    $string = $serializer->serialize($object);
    //Serialize array of the objects
    $string = $serializer->serialize(array($object));
    //Serialize specific groups
    $serializer->setGroups(array('get'));
    $string = $serializer->serialize($object);
    //Serialize specific version
    $serializer->setVersion('1.0');
    $string = $serializer->serialize($object);

Deserializing Objects

You can also unserialize objects from JSON representation. For example, when accepting data via an API., _(*12)

    <?php
    //get Fully\Qualified\ClassName
    $object = $this->getClassName();
    //get Serializer
    $serializer = $this->getSerializer();
    $object = $serializer->unserialize($jsonData, $object);
    //Unserialize array of the objects
    $objects = $serializer->unserialize($jsonData, array($object));
    //Unserialize specific groups
    $serializer->setGroups(array('get'));
    $object = $serializer->unserialize($jsonData, $object);
    //Unserialize specific version
    $serializer->setVersion('1.0');
    $object = $serializer->unserialize($jsonData, $object);
    //Strict unserialize mode
    $serializer->setStrictUnserializeMode(2);
    $object = $serializer->unserialize($jsonData, $object);
    //Medium Strict unserialize mode
    $serializer->setStrictUnserializeMode(1);
    $object = $serializer->unserialize($jsonData, $object);
    //Non-Strict unserialize mode
    $serializer->setStrictUnserializeMode(0);
    $object = $serializer->unserialize($jsonData, $object);