New in Symfony 6.2: New Uid Features

The Uid component provides an object-oriented API to generate and represent UIDs such as UUID and ULID. In Symfony 6.2 we're adding some features to it.

MaxUuid and MaxUlid

Contributed by
Nicolas Grekas
in #47515.

In Symfony 6.2 we're introducing two new classes called MaxUlid and MaxUuid which represent the highest possible value of both UUID and ULID. You can use those objects to get the max values string representation, to compare them to other UID objects, etc.

If you are curious, these are the maximum values possible:

Max UUID: 'FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF'
Max ULID: '7ZZZZZZZZZZZZZZZZZZZZZZZZZ'

Time-based Uid Interface

Contributed by
Barney Hanlon
in #47507.

Some UIDs include a date/time as part of their value. In Symfony 6.2 we're introducing the following interface so you can get this date/time value more easily:

interface TimeBasedUidInterface
{
    public function getDateTime(): \DateTimeImmutable;
}

The interface is only implemented by the UID types/versions that include a date/time, which are: Ulid, UuidV1, and UuidV6.

Uid Conversion to Hexadecimal Values

Contributed by
Aurimas Niekis
in #45945.

UIDs include lots of methods to convert their value into different formats (toBase32(), toBase58(), toRfc4122(), etc.) In Symfony 6.2 we're introducing a new toHex() method which returns the binary value as an hexadecimal string:

use Symfony\Component\Uid\Uuid;

$uuid = Uuid::v4()
// e.g. (string) $uuid = 'd6b3345b-2905-4048-a83c-b5988e765d98'
$hex = $uuid->toHex();
// $hex = '0xd6b3345b29054048a83cb5988e765d98'

The hexadecimal string returned by toHex() is ready to use in other parts of your application, such as storing or querying UIDs in binary format in the database.

UuidV7 and UuidV8 Support

Contributed by
Nicolas Grekas
in #47525.

The UUID specification continues adding new formats to generate values suited for different scenarios. They recently added UUID Version 7 and UUID Version 8 formats and Symfony 6.2 adds support for them:

use Symfony\Component\Uid\Uuid;

$uuid = Uuid::v7();
// e.g. (string) $uuid = '017f22e2-79b0-7cc3-98c4-dc0c0c07398f'
$uuid = Uuid::v8();
// e.g. (string) $uuid = '216fff40-98d9-81e3-a5e2-0800200c9a66'

Conceptually, UUID v7 is very similar to ULID: they're monotonic, sortable, unguessable, and embed a ms-unix-timestamp.

            <hr style="margin-bottom: 5px" />
            <div style="font-size: 90%">
                <a href="https://symfony.com/sponsor">Sponsor</a> the Symfony project.
            </div>

https://symfony.com/blog/new-in-symfony-6-2-new-uid-features?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Creată 3y | 17 nov. 2022, 17:20:14


Autentifică-te pentru a adăuga comentarii

Alte posturi din acest grup

Symfony 6.4.24 released

Symfony 6.4.24 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in you

31 iul. 2025, 13:10:32 | Symfony
Symfony 7.2.9 released

Symfony 7.2.9 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

31 iul. 2025, 13:10:31 | Symfony
Symfony 7.3.2 released

Symfony 7.3.2 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

31 iul. 2025, 13:10:30 | Symfony
A Week of Symfony #969 (July 21–27, 2025)

This week, development focused on the upcoming Symfony 7.4 and 8.0 releases. We added new features such as the ObjectMapperAwareInterface, improved value transformers in JsonStreamer, and enabled load

27 iul. 2025, 09:30:15 | Symfony
SymfonyCon Amsterdam 2025: Community Evening - Let’s Celebrate 20 Years of Symfony Together!

Symfony is turning 20 and we’re throwing a party you won’t want to miss! 🥳

Join us for an unforgettable evening of drinks, music, and great company at the Kanarie Club in Amsterdam!

This year

23 iul. 2025, 15:10:02 | Symfony
A Week of Symfony #968 (July 14–20, 2025)

This week, the upcoming Symfony 7.4 version improved the Serializer component by adding more prefix support to the accessor, added more code to make the JsonPath component RFC compliant, and added sup

20 iul. 2025, 08:20:04 | Symfony
A Week of Symfony #967 (July 7–13, 2025)

This week, Symfony unveiled the Symfony AI initiative, a set of components and bundles designed to bring powerful AI capabilities directly into your PHP applications. In addition, we published travel

13 iul. 2025, 09:20:11 | Symfony