mcfedr/uuid-paramconverter

A sensi paramconverter for receiving uuids as url params

Uuid Extra Bundle

A convenient bundle for using ramsey/uuid in your project, _(*1)

, _(*2)

Install

Composer

php composer.phar require ekreative/uuid-extra-bundle

AppKernel

Include the bundle in your AppKernel, _(*3)

public function registerBundles()
{
    $bundles = array(
        ...
        new Ekreative\UuidExtraBundle\EkreativeUuidExtraBundle()

Config

No config needed, _(*4)

Param Converter

Use just like any other param converter, _(*5)

/**
 * @ParamConverter("uuid", class="Ramsey\Uuid\UuidInterface")
 * @Route("/simple/{uuid}")
 */
public function simpleAction(UuidInterface $uuid)
{
    return new Response($uuid->toString());
}

Most of the time its going to work automatically, as long as you use type hinting on your action, _(*6)

/**
 * @Route("/automatic/{uuid}")
 */
public function simpleAction(UuidInterface $uuid)
{
    return new Response($uuid->toString());
}

Also works for optional params, _(*7)

/**
 * @Route("/optional/{uuid}")
 */
public function simpleAction(UuidInterface $uuid = null)
{
    return new Response($uuid ? $uuid->toString() : 'no uuid');
}

Serializer

Also like a normalizer should, _(*8)

$this->serializer->serialize($uuid, 'json')

Results in "f13a5b20-9741-4b15-8120-138009d8e0c7", _(*9)

And the other way around, _(*10)

$this->serializer->denormalize('"f13a5b20-9741-4b15-8120-138009d8e0c7"', UuidInterface::class, 'json')

Results in $uuid, _(*11)

Works in your Objects etc., _(*12)

Form Type

Does everything you'd expect, _(*13)

->add('uuid', UuidType:class)

And if your model has, _(*14)

/**
 * @Assert\Uuid
 */
private $uuid;

It will automatically use the UuidType, _(*15)