Table Of Contents


You can obtain free community support for example through stackoverflow, or also through the Symfony2 mailing list.

If you think you found a bug, please create a ticket in the bug tracker.

Continuous Inspections

If you take code quality seriously, try out the new continuous inspection service.


Custom De-/Serialization Handlers


This allows you to change the way of how a specifc type is being de-/serialized.

Any handler must implement either the SerializationHandlerInterface, or DeserializationHandlerInterface, or both. This bundle already comes with some handlers which you find in the Serializer/Handler folder, and which you can use as a starting point.

Custom handlers are normal services, and thus can have dependencies on any other service available in the dependency injection container.


After you have written your handler, you can write a service definition. Such as the following:

<service id="acme_foo.serializer.my_handler"

The Handler Factory

What is left to do is to publish our new handler to this bundle. So it gets picked up, and wired correctly. In order to do this, this bundle uses a configuration system similar to that of the SecurityBundle. Each handler needs a corresponding definition factory:


namespace Acme\FooBundle\DependencyInjection\Factory;

use JMS\SerializerBundle\DependencyInjection\HandlerFactoryInterface;

class MyHandlerFactory implements HandlerFactoryInterface
    public function getConfigKey()
        return 'acme_foo_my';

    public function getType(array $config)

    public function addConfiguration(ArrayNodeDefinition $builder)

    public function getHandlerId(ContainerBuilder $container, array $config)
        return 'acme_foo.serializer.my_handler';

This factory is responsible for setting up the configuration for your handler in the addConfiguration method, and then process that configuration in the getHandlerId method.

The last thing left to do, is to add this factory to this bundle. This is done by adding a configureSerializerExtension to your bundle class:


namespace Acme\FooBundle;

use Acme\FooBundle\DependencyInjection\Factory\FooFactory;
use JMS\SerializerBundle\DependencyInjection\JMSSerializerExtension;
use Symfony\Component\HttpKernel\Bundle\Bundle;

class AcmeFooBundle extends Bundle
    public function configureSerializerExtension(JMSSerializerExtension $ext)
        $ext->addHandlerFactory(new FooFactory());

Enabling Your Handler

TODO: Add example config

Tip: The order in which the handlers are listed in the “handlers” section defines in which they are called while processing.