PHPackages                             piotrgradzinski/uuid-extra-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. piotrgradzinski/uuid-extra-bundle

ActiveSymfony-bundle[Utility &amp; Helpers](/categories/utility)

piotrgradzinski/uuid-extra-bundle
=================================

Paramconverter, Normalizer and Form Type for Ramsey Uuid

4.3.0(2y ago)040.7kMITPHPPHP ^8.1

Since May 19Pushed 2y agoCompare

[ Source](https://github.com/piotrgradzinski/uuid-extra-bundle)[ Packagist](https://packagist.org/packages/piotrgradzinski/uuid-extra-bundle)[ Docs](https://github.com/piotrgradzinski/uuid-extra-bundle)[ RSS](/packages/piotrgradzinski-uuid-extra-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (13)Versions (2)Used By (0)

Uuid Extra Bundle
=================

[](#uuid-extra-bundle)

A convenient bundle for using ramsey/uuid in your project

[![Latest Stable Version](https://camo.githubusercontent.com/1240992a55b7b65e58465dfc1979131efc9d279e781a4821928300ad6180c610/68747470733a2f2f706f7365722e707567782e6f72672f656b726561746976652f757569642d65787472612d62756e646c652f762f737461626c652e706e67)](https://packagist.org/packages/ekreative/uuid-extra-bundle)[![License](https://camo.githubusercontent.com/086dbc48c666c846429ba4dd9f64fd449f273343ce5a45138d8f6eb85c02fb0b/68747470733a2f2f706f7365722e707567782e6f72672f656b726561746976652f757569642d65787472612d62756e646c652f6c6963656e73652e706e67)](https://packagist.org/packages/ekreative/uuid-extra-bundle)[![Build Status](https://camo.githubusercontent.com/6139c12481df0a011be1e578589674c83f22a14fc882e98887737e41a4646069/68747470733a2f2f7472617669732d63692e6f72672f656b726561746976652f757569642d65787472612d62756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/ekreative/uuid-extra-bundle)

Disclaimer
----------

[](#disclaimer)

This repository is a fork of [ekreative/uuid-extra-bundle](https://github.com/ekreative/uuid-extra-bundle) with some updates as the original project is not updated for some time now.

Install
-------

[](#install)

### Composer

[](#composer)

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

### AppKernel

[](#appkernel)

Include the bundle in your AppKernel

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

Config
------

[](#config)

No config needed

Param Converter
---------------

[](#param-converter)

Use just like any other param converter

```
/**
 * @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

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

Also works for optional params

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

Serializer
----------

[](#serializer)

Also like a normalizer should

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

Results in `"f13a5b20-9741-4b15-8120-138009d8e0c7"`

And the other way around

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

Results in `$uuid`

Works in your Objects etc.

Form Type
---------

[](#form-type)

Does everything you'd expect

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

And if your model has

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

It will automatically use the `UuidType`

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1089d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1a8f4af0d2a971ff7e52866b96c0ab73d3b5ec75044b85873f8f734b7786f599?d=identicon)[piotrgradzinski](/maintainers/piotrgradzinski)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (100 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (99 commits)")[![mcfedr](https://avatars.githubusercontent.com/u/704356?v=4)](https://github.com/mcfedr "mcfedr (52 commits)")[![Ocramius](https://avatars.githubusercontent.com/u/154256?v=4)](https://github.com/Ocramius "Ocramius (19 commits)")[![piotrgradzinski](https://avatars.githubusercontent.com/u/1607439?v=4)](https://github.com/piotrgradzinski "piotrgradzinski (3 commits)")[![nicholasruunu](https://avatars.githubusercontent.com/u/483658?v=4)](https://github.com/nicholasruunu "nicholasruunu (2 commits)")[![Toilal](https://avatars.githubusercontent.com/u/1165758?v=4)](https://github.com/Toilal "Toilal (2 commits)")[![smagolexandr](https://avatars.githubusercontent.com/u/17381289?v=4)](https://github.com/smagolexandr "smagolexandr (1 commits)")

---

Tags

normalizersymfonybundleconverteruuididentifierguidformparamconverterparamdenormalizerramsey

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/piotrgradzinski-uuid-extra-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/piotrgradzinski-uuid-extra-bundle/health.svg)](https://phpackages.com/packages/piotrgradzinski-uuid-extra-bundle)
```

###  Alternatives

[ekreative/uuid-extra-bundle

Paramconverter, Normalizer and Form Type for Ramsey Uuid

18168.6k](/packages/ekreative-uuid-extra-bundle)[pascaldevink/shortuuid

PHP 7.4+ library that generates concise, unambiguous, URL-safe UUIDs

5951.8M15](/packages/pascaldevink-shortuuid)[winzou/state-machine-bundle

Bundle for the very lightweight yet powerful PHP state machine

34010.4M15](/packages/winzou-state-machine-bundle)[gamez/ramsey-uuid-normalizer

Symfony Normalizer and Denormalizer for ramsey/uuid

16619.1k3](/packages/gamez-ramsey-uuid-normalizer)[norberttech/aceeditor-bundle

Bundle that integrate excellent JavaScript ace editor into Symfony Form.

28310.8k](/packages/norberttech-aceeditor-bundle)[pyyoshi/shortuuid-php

2226.1k](/packages/pyyoshi-shortuuid-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
