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 SymfonyComponentUidUuid;
$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 SymfonyComponentUidUuid;
$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.
Symfony Blog