Normalt

Normalt is a extension to Symfony Serializer than implements only the Normalization part. It comes with several different Normalizers that can be used to normalize from object to array and denormalize from array to object.

The main interaction is the Marshaller. This is a implementation of DenormalizerInterface and NormalizerInterface.

Getting Started

Each normalizer can be used on its own, but you can also use a NormalizerSet to use many different dependent on the type you are normalizing, just like when using the serializer.

use Normalt\Marshaller;
use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
use Symfony\Component\Serializer\Normalizer\CustomNormalizer;

$set = new Marshaller(array(
    new GetSetMethodNormalizer,
    new CustomNormalizer,
));

$normalized = $set->normalize(new MyObject);
$object = $set->denormalize($normalized);

Any normalizer that is used through the Marshaller will have an instance of it set if they implement Normalt\MarshallerAware. Same as if you have a Normalizer that implements SerializerAwareInterface and use the Serializer.

RecursiveReflectionNormalizer

It is a special normalizer that uses a list of normalizers, but instead of applying on an per object basis it traverses the properties and applies normalization to each. If a property contains an array this is also traversed.

This can be used together with DoctrineNormalizer to automatically convert from Entity to array and back again.

use Normalt\Normalizer\RecursiveReflectionNormalizer;
use Normalt\Normalizer\DoctrineNormalizer;

$normalizer = new RecursiveReflectionNormalizer(array(
    new DoctrineNormalizer($objectManager),
));


// Assuming this wraps an entity called MyModel.
// we would get the following array when normalized (assuming its identifier is 1
// array(
//    'model' => array('className' => 'MyModel', 1),
// )
class MyModelWrapper {
    protected $model;

    public function __construct()
    {
        $this->model = new MyModel;
    }
}

$normalizer->normalize(new MyModelWrapper);