3.9.1

Fixed

• Fix RandomNodeProvider behavior on 32-bit systems. The RandomNodeProvider
  was converting a 6-byte string to a decimal number, which is a 48-bit,
  unsigned integer. This caused problems on 32-bit systems and has now been
  resolved.

3.9.0

Added

• Add function API as convenience. The functions are available in the
  Ramsey\Uuid namespace.
  • v1(int|string|null $node = null, int|null $clockSeq = null): string
  • v3(string|UuidInterface $ns, string $name): string
  • v4(): string
  • v5(string|UuidInterface $ns, string $name): string

Changed

• Use paragonie/random-lib instead of ircmaxell/random-lib. This is a
  non-breaking change.
• Use a high-strength generator by default, when using RandomLibAdapter. This
  is a non-breaking change.

Deprecated

These will be removed in ramsey/uuid version 4.0.0:

• MtRandGenerator, OpenSslGenerator, and SodiumRandomGenerator are
  deprecated in favor of using the default RandomBytesGenerator.

Fixed

• Set ext-json as a required dependency in composer.json.
• Use PHP_OS instead of php_uname() when determining the system OS, for
  cases when php_uname() is disabled for security reasons.

3.8.0

Added

• Support discovery of MAC addresses on FreeBSD systems
• Use a polyfill to provide PHP ctype functions when running on systems where the
  ctype functions are not part of the PHP build
• Disallow a trailing newline character when validating UUIDs
• Annotate thrown exceptions for improved IDE hinting

3.7.3

Fixed

• Gracefully handle cases where glob() returns false when searching
  /sys/class/net/*/address files on Linux
• Fix off-by-one error in DefaultTimeGenerator

Security

• Switch to random_int() from mt_rand() for better random numbers

3.7.2

Fixed

• Check sysfs on Linux to determine the node identifier; this provides a
  reliable way to identify the node on Docker images, etc.

3.7.1

Fixed

• Set the multicast bit for random nodes, according to RFC 4122, §4.5

Security

• Use random_bytes() when generating random nodes

3.7.0

Added

• Add the following UUID version constants:
  • Uuid::UUID_TYPE_TIME
  • Uuid::UUID_TYPE_IDENTIFIER
  • Uuid::UUID_TYPE_HASH_MD5
  • Uuid::UUID_TYPE_RANDOM
  • Uuid::UUID_TYPE_HASH_SHA1

3.6.1

Fixed

• Optimize UUID string decoding by using str_pad() instead of sprintf()

3.6.0

Added

• Add InvalidUuidStringException, which is thrown when attempting to decode an
  invalid string UUID; this does not introduce any BC issues, since the new
  exception inherits from the previously used InvalidArgumentException

Fixed

• Improve memory usage when generating large quantities of UUIDs (use str_pad()
  and dechex() instead of sprintf())

3.5.2

Fixed

• Improve test coverage