README

silex-jms-serializer-provider is a silex service provider that integrates JmsSerializer into silex.

Installation

Install the silex-jms-serializer-provider using composer. This project uses sematic versioning.

{
    "require": {
        "jdesrosiers/silex-jms-serializer-provider": "~1.0"
    }
}

Parameters

• serializer.srcDir: (string) The path to the jms/serializer component.
• serializer.annotationReader: (AnnotationReader) Set a custom AnnotationReader.
• serializer.cacheDir: (string) Set a directory for caching annotations.
• serializer.configureHandlers: (Closure) Override the default handlers.
• serializer.configureListeners: (Closure) Override the default listeners.
• serializer.objectConstructor: (ObjectConstructorInterface) Set a custom ObjectConstructor.
• serializer.namingStrategy: (string) Set the PropertyNamingStrategy
• serializer.namingStrategy.separator: (string) If CamelCase is chosen as the NamingStrategy, you can override the default separator.
• serializer.namingStrategy.lowerCase: (boolean) If CamelCase is chosen as the NamingStrategy, you can override the lowerCase option.
• serializer.serializationVisitors: (array<string:VisitorInterface>) Override the default serialization visitors.
• serializer.deserializationVisitors: (array<string:VisitorInterface>) Override the default deserialization visitors.
• serializer.includeInterfaceMetadata: (boolean) Whether to include the metadata from the interfaces
• serializer.metadataDirs: (arraystring:string) Sets a map of namespace prefixes to directories.

Services

• serializer: A Serializer object constructed with all of parameters given.
• serializer.builder: If all of the shortcuts provided are not sufficient, you can always get the SerializerBuilder object and add additional customizations before the Serializer object is constructed.
• serializer.propertyNamingStrategy: The PropertyNamingStrategy object that is generated by the provider. You shouldn't need to use it unless you are doing something fancy with the builder.

Registering

$app->register(new JDesrosiers\Silex\Provider\JmsSerializerServiceProvider(), array(
    "serializer.srcDir" => __DIR__ . "/vendor/jms/serializer/src",
));

Usage

The Serializer documentation can be found at http://jmsyst.com/libs/serializer.

$app->get("/foo", function () use ($app) {
    $foo = new Foo();
    return $app["serializer"]->serialize($foo, "json");
});

Using the Builder

You can use the builder directly to add additional customizations

$app->register(new JDesrosiers\Silex\Provider\JmsSerializerServiceProvider(), array(
    "serializer.srcDir" => __DIR__ . "/vendor/jms/serializer/src",
//    "serializer.namingStrategy" => "IdenticalProperty",
));
$app["serializer.builder"]->setPropertyNamingStrategy(new IdenticalPropertyNamingStrategy());

Adding Custom Handlers

$closure = Pimple::protect(
    function(JMS\Serializer\Handler\HandlerRegistry $registry) {
        $registry->registerHandler('serialization', 'MyObject', 'json',
            function($visitor, MyObject $obj, array $type) {
                return $obj->getName();
            }
        );
    }
);
$app->register(new JDesrosiers\Silex\Provider\JmsSerializerServiceProvider(), array(
    "serializer.srcDir" => __DIR__ . "/vendor/jms/serializer/src",
    "serializer.configureHandlers" => $closure,
));