Upgrade

3.x to 4.0

• In UuidFactory and UlidFactory: $clock on all methods was renamed to $timestamp

• In UuidFactory and SequenceFactory for UUIDv1, UUIDv2, UUIDv6 $clockSequence param was added between $node and $timestamp / $clock

2.x to 3.0

• Interface changes:

  • Rfc4122Variant10xxUuid was renamed to Variant10xxUuid and it no longer extends Rfc4122Uuid

  • UuidV2, UuidV6, UuidV7, UuidV8, MaxUuid no longer implement Rfc4122Uuid

    • If you strictly check for standard UUIDs, use Rfc9562Uuid

    • UuidV2 is no longer considered RFC-based UUID because neither RFC explains them

• V3/V5 namespaces were moved to the Arokettu\Uuid\Namespaces\UuidNamespace enum:

  <?php
  
  // v2:
  use Arokettu\Uuid\UuidFactory;
  use Arokettu\Uuid\UuidNamespaces;
  
  $uuid = UuidFactory::v5(UuidNamespaces::url(), 'http://example.com');
  var_dump($uuid->toString()); // 8c9ddcb0-8084-5a7f-a988-1095ab18b5df
  
  // v3:
  use Arokettu\Uuid\Namespaces\UuidNamespace;
  use Arokettu\Uuid\UuidFactory;
  
  $uuid = UuidFactory::v5(UuidNamespace::URL, 'http://example.com');
  var_dump($uuid->toString()); // 8c9ddcb0-8084-5a7f-a988-1095ab18b5df
  

• UuidV7Sequence renamed to UuidV7ShortSequence

1.x to 2.0

• Deprecated interface was removed:

  <?php
  
  use Arokettu\Uuid\Rfc4122Variant10xxUuid;
  use Arokettu\Uuid\Rfc4122Variant1Uuid
  
  if ($uuid instanceof Rfc4122Variant1Uuid) {
      // ...
  }
  
  // replace with
  
  if ($uuid instanceof Rfc4122Variant10xxUuid) {
      // ...
  }
  

• Deprecated sequences were removed:

  <?php
  
  use Arokettu\Uuid\SequenceFactory;
  use Arokettu\Uuid\UlidFactory;
  use Arokettu\Uuid\UuidFactory;
  
  // UUIDv7:
  
  $seq = UuidFactory::v7Sequence();
  
  // replace with
  
  $seq = SequenceFactory::v7();
  
  // ULID:
  
  $seq = UlidFactory::sequence();
  
  // replace with
  
  $seq = SequenceFactory::ulid();