4.9.0

Added

• Add new @pure annotations to the following (#605):
  • Ramsey\Uuid\Codec\CodecInterface::encode()
  • Ramsey\Uuid\Codec\CodecInterface::encodeBinary()
  • Ramsey\Uuid\Codec\CodecInterface::decode()
  • Ramsey\Uuid\Codec\CodecInterface::decodeBytes()
  • Ramsey\Uuid\Fields\FieldsInterface::getBytes()
  • Ramsey\Uuid\Math\CalculatorInterface::add()
  • Ramsey\Uuid\Math\CalculatorInterface::subtract()
  • Ramsey\Uuid\Math\CalculatorInterface::multiply()
  • Ramsey\Uuid\Math\CalculatorInterface::divide()
  • Ramsey\Uuid\Math\CalculatorInterface::fromBase()
  • Ramsey\Uuid\Math\CalculatorInterface::toBase()
  • Ramsey\Uuid\Math\CalculatorInterface::toHexadecimal()
  • Ramsey\Uuid\Math\CalculatorInterface::toInteger()
  • Ramsey\Uuid\Nonstandard\Uuid
  • Ramsey\Uuid\Rfc4122\Fields::isMax()
  • Ramsey\Uuid\Rfc4122\FieldsInterface::getVersion()
  • Ramsey\Uuid\Rfc4122\FieldsInterface::isNil()
  • Ramsey\Uuid\Type\Time::getSeconds()
  • Ramsey\Uuid\Type\Time::getMicroseconds()
  • Ramsey\Uuid\Type\TypeInterface::toString()
  • Ramsey\Uuid\UuidInterface::getBytes()
  • Ramsey\Uuid\UuidInterface::toString()
  • Ramsey\Uuid\Validator\ValidatorInterface::validate()

Fixed

• Restore the @pure annotations that were removed in 4.8.0 (#603).

---

Full Changelog: 4.8.1...4.9.0

4.8.1

Fixed

• This tagged release ensures the stable documentation build matches the current stable release.

Full Changelog: 4.8.0...4.8.1

4.8.0

Deprecated

The following will be removed in ramsey/uuid 5.0.0:

• Ramsey\Uuid\Codec\OrderedTimeCodec is deprecated; please migrate to version 6 UUIDs.
• Ramsey\Uuid\Codec\TimestampFirstCombCodec is deprecated; please migrate to version 7 UUIDs.
• Ramsey\Uuid\Codec\TimestampLastCombCodec is deprecated; please use Ramsey\Uuid\Codec\StringCodec instead.
• Ramsey\Uuid\Generator\CombGenerator is deprecated; please migrate to version 7 UUIDs.

Fixed

• Allow brick/math version ^0.13; fixed in #589.
• Update call to str_getcsv() to avoid deprecation notice in PHP 8.4; fixed in #590.
• Hexadecimal is never an empty string; fixed in #593.
• Update docblocks for Uuid::fromBytes(), Uuid::fromString(), Uuid::fromDateTime(), Uuid::fromHexadecimal(), and Uuid::fromInteger() to note that each can throw InvalidArgumentException, addressing PHPStan errors occurring at call sites; fixed in #552.
• getVariant() for MaxUuid now correctly returns Uuid::RESERVED_FUTURE, as specified in RFC 9562, section 5.10.
• getVariant() for NilUuid now correctly returns Uuid::RESERVED_NCS, as specified in RFC 9562, section 5.9.

New Contributors

• @staabm made their first contribution in #552
• @Chris53897 made their first contribution in #568
• @jrfnl made their first contribution in #584
• @PNardman made their first contribution in #590
• @axlon made their first contribution in #593
• @derrabus made their first contribution in #589

Full Changelog: 4.7.6...4.8.0

4.7.6

Fixed

• Allow brick/math version ^0.12.

4.7.5

Fixed

• Protect against UUIDv7 collisions within the same millisecond, as reported in #518 and fixed in #522.
• Improve the return type hint for UuidInterface::compareTo().

4.7.4

Fixed

• Allow brick/math version ^0.11.
• Add explicit Stringable interface to UuidInterface.
• Fix namespace conflict reported in #490.
• Fix unserialize error with OrderedTimeCodec reported in #494.

4.7.3

Fixed

• The original 4.7.2 tag accidentally pointed to a commit in the 5.x branch. I have replaced the 4.7.2 tag with a new tag that points to the correct commit, but I am creating this tag to help notify users and automated processes who might have already updated to the bad 4.7.2 tag (#487).

4.7.2

Fixed

• Amend Psalm assertion syntax on Uuid::isValid() to prevent incorrect type inference (#486).
• Re-tagged with the correct commit hash, since the first tag was pointing to a commit in the 5.x branch (#487).

4.7.1

Fixed

• Allow the use of ramsey/collection ^2.0 with ramsey/uuid.

4.7.0

Added

• Add Uuid::fromHexadecimal() and UuidFactory::fromHexadecimal(). These methods are not required by the interfaces.

Fixed

• Ignore MAC addresses consisting of all zeroes (i.e., 00:00:00:00:00:00).