3.9.7

Fixed

• Add #[ReturnTypeWillChange] to Uuid::jsonSerialize() method.

4.6.0

Added

• Add support for version 8, custom UUIDs, as defined in draft-ietf-uuidrev-rfc4122bis-00, section 5.8. While still an Internet-Draft, version 8 is stable and unlikely to change in any way that breaks compatibility.
  • Use Ramsey\Uuid\Uuid::uuid8() to generate version 8 UUIDs.
  • Version 8 UUIDs are of type Ramsey\Uuid\Rfc4122\UuidV8.
  • The constant Ramsey\Uuid\Uuid::UUID_TYPE_CUSTOM exists for version 8 UUIDs.

Fixed

• Ensure monotonicity of version 7 UUIDs.

4.5.1

Fixed

• Update RFC 4122 validator to recognize version 6 and 7 UUIDs.

4.5.0

Added

• Promote version 6, reordered time UUIDs from the Nonstandard namespace to the Rfc4122 namespace. Version 6 UUIDs are defined in New UUID Formats, section 5.1. While still an Internet-Draft version 6 is stable and unlikely to change in any way that breaks compatibility.
• Add support for version 7, Unix Epoch time UUIDs, as defined in New UUID Formats, section 5.2. While still an Internet-Draft, version 7 is stable and unlikely to change in any way that breaks compatibility.
  • Use Ramsey\Uuid\Uuid::uuid7() to generate version 7 UUIDs.
  • Version 7 UUIDs are of type Ramsey\Uuid\Rfc4122\UuidV7.
  • The constant Ramsey\Uuid\Uuid::UUID_TYPE_UNIX_TIME exists for version 7 UUIDs.
• Add Ramsey\Uuid\Converter\Time\UnixTimeConverter and Ramsey\Uuid\Generator\UnixTimeGenerator to support version 7 UUID generation.
• Add support for max UUIDs through Ramsey\Uuid\Uuid::MAX and Ramsey\Uuid\Rfc4122\MaxUuid.

Changed

• The lowest version of brick/math allowed is now ^0.8.8.

Deprecated

The following will be removed in ramsey/uuid 5.0.0:

• Ramsey\Uuid\Nonstandard\UuidV6 is deprecated in favor of Ramsey\Uuid\Rfc4122\UuidV6.
• Ramsey\Uuid\Uuid::UUID_TYPE_PEABODY; use Ramsey\Uuid\Uuid::UUID_TYPE_REORDERED_TIME instead.

Fixed

• For Ramsey\Uuid\Uuid::isValid(), Psalm now asserts the UUID is a non-empty-string when it is valid.
• Nil UUIDs are properly treated as RFC 4122 variants, and getVariant() now returns a 2 when called on a nil UUID.

4.4.0

Changed

• Allow brick/math 0.10.
• Remove dev dependency to moontoast/math.
• Un-deprecate UuidInterface::getUrn().

4.3.1

Deprecated

The following will be removed in ramsey/uuid 5.0.0:

• Ramsey\Uuid\Generator\RandomLibAdapter

4.3.0

Changed

• Remove support for PHP 7.2, 7.3, and 7.4. This is not a BC break, since
  Composer will do the right thing for your environment and select a compatible
  version of this library.
• Require ext-ctype extension. For applications that run in environments where
  the ext-ctype is not present, please require a polyfill, such as
  symfony/polyfill-ctype.
• Use iterable<UuidBuilderInterface> instead of BuilderCollection types.
• Use iterable<NodeProviderInterface> instead of NodeProviderCollection types.

Deprecated

The following will be removed in ramsey/uuid 5.0.0:

• Ramsey\Uuid\Builder\BuilderCollection
• Ramsey\Uuid\Provider\Node\NodeProviderCollection
• Dependency on ramsey/collection

Fixed

• Support valid UUIDs in uppercase in LazyUuidFromString.

4.2.3

Fixed

• Switch back to ^8.0 in the PHP version requirement.

4.1.3

Fixed

• Switch back to ^8.0 in the PHP version requirement.

4.0.3

Fixed

• Switch back to ^8.0 in the PHP version requirement.