Installation¶

1. Using Composer (recommended)¶

To install JMSSerializerBundle with Composer just add the following to your composer.json file:

// composer.json
{
    // ...
    require: {
        // ...
        "jms/serializer-bundle": "dev-master"
    }
}

If you?re using the Symfony Standard Edition, also make sure that you increase the versions for jms/di-extra-bundle to 1.3.*, and jms/security-extra-bundle to 1.4.*.

Then, you can install the new dependencies by running Composer?s update command from the directory where your composer.json file is located:

$ php composer.phar update

Now, Composer will automatically download all required files, and install them for you. All that is left to do is to update your AppKernel.php file, and register the new bundle:

<?php

// in AppKernel::registerBundles()
$bundles = array(
    // ...
    new JMS\SerializerBundle\JMSSerializerBundle(),
    // ...
);

2. Using the deps file (Symfony 2.0.x)¶

First, checkout a copy of the code. Just add the following to the deps file of your Symfony Standard Distribution:

[JMSSerializerBundle]
    git=git://github.com/schmittjoh/JMSSerializerBundle.git
    target=bundles/JMS/SerializerBundle

Then register the bundle with your kernel:

<?php

// in AppKernel::registerBundles()
$bundles = array(
    // ...
    new JMS\Serializer\JMSSerializerBundle($this),
    // ...
);

This bundle also requires the Metadata library (you need the 1.1 version, not the 1.0 version which ships with the Symfony Standard Edition.):

[metadata]
    git=http://github.com/schmittjoh/metadata.git
    version=1.1.0

Make sure that you also register the namespaces with the autoloader:

<?php

// app/autoload.php
$loader->registerNamespaces(array(
    // ...
    'JMS'              => __DIR__.'/../vendor/bundles',
    'Metadata'         => __DIR__.'/../vendor/metadata/src',
    // ...
));

Now use the vendors script to clone the newly added repositories into your project:

$ php bin/vendors install