mirror of
https://github.com/ramsey/uuid.git
synced 2026-06-14 15:56:48 +03:00
Ben Ramsey
582 lines
24 KiB
PHP
582 lines
24 KiB
PHP
<?php
|
|
|
|
namespace Ramsey\Uuid\Test;
|
|
|
|
use Mockery;
|
|
use PHPUnit\Framework\Attributes\DataProvider;
|
|
use PHPUnit\Framework\Attributes\PreserveGlobalState;
|
|
use PHPUnit\Framework\Attributes\RunInSeparateProcess;
|
|
use Ramsey\Uuid\Codec\TimestampFirstCombCodec;
|
|
use Ramsey\Uuid\Generator\CombGenerator;
|
|
use Ramsey\Uuid\Generator\DefaultTimeGenerator;
|
|
use Ramsey\Uuid\Rfc4122\UuidInterface;
|
|
use Ramsey\Uuid\Rfc4122\UuidV1;
|
|
use Ramsey\Uuid\Rfc4122\Version;
|
|
use Ramsey\Uuid\Type\Hexadecimal;
|
|
use Ramsey\Uuid\Type\Time;
|
|
use Ramsey\Uuid\Uuid;
|
|
use Ramsey\Uuid\UuidFactory;
|
|
use Ramsey\Uuid\Variant;
|
|
use stdClass;
|
|
|
|
/**
|
|
* These tests exist to ensure a seamless upgrade path from 3.x to 4.x. If any
|
|
* of these tests fail in 4.x, then it's because we've changed functionality
|
|
* in such a way that compatibility with 3.x is broken.
|
|
*
|
|
* Naturally, there are some BC-breaks between 3.x and 4.x, but these tests
|
|
* ensure that the base-level functionality that satisfies 80% of use-cases
|
|
* does not change. The remaining 20% of use-cases should refer to the README
|
|
* for details on the easiest path to transition from 3.x to 4.x.
|
|
*
|
|
* @codingStandardsIgnoreFile
|
|
*/
|
|
class ExpectedBehaviorTest extends TestCase
|
|
{
|
|
/**
|
|
* @param mixed[] $args
|
|
*/
|
|
#[DataProvider('provideStaticCreationMethods')]
|
|
public function testStaticCreationMethodsAndStandardBehavior(string $method, array $args): void
|
|
{
|
|
/** @var UuidInterface $uuid */
|
|
$uuid = Uuid::$method(...$args);
|
|
|
|
$this->assertIsInt($uuid->compareTo(Uuid::uuid1()));
|
|
$this->assertNotSame(0, $uuid->compareTo(Uuid::uuid4()));
|
|
$this->assertSame(0, $uuid->compareTo(clone $uuid));
|
|
$this->assertFalse($uuid->equals(new stdClass()));
|
|
$this->assertTrue($uuid->equals(clone $uuid));
|
|
|
|
$this->assertSame(
|
|
(string) $uuid->getHex(),
|
|
$uuid->getFields()->getTimeLow()->toString()
|
|
. $uuid->getFields()->getTimeMid()->toString()
|
|
. $uuid->getFields()->getTimeHiAndVersion()->toString()
|
|
. $uuid->getFields()->getClockSeqHiAndReserved()->toString()
|
|
. $uuid->getFields()->getClockSeqLow()->toString()
|
|
. $uuid->getFields()->getNode()->toString()
|
|
);
|
|
|
|
$this->assertStringStartsWith('urn:uuid:', $uuid->getUrn());
|
|
$this->assertSame('urn:uuid:' . (string) $uuid->getHex(), str_replace('-', '', $uuid->getUrn()));
|
|
$this->assertSame((string) $uuid->getHex(), str_replace('-', '', $uuid->toString()));
|
|
$this->assertSame((string) $uuid->getHex(), str_replace('-', '', (string) $uuid));
|
|
|
|
$this->assertSame(
|
|
$uuid->toString(),
|
|
$uuid->getFields()->getTimeLow()->toString() . '-'
|
|
. $uuid->getFields()->getTimeMid()->toString() . '-'
|
|
. $uuid->getFields()->getTimeHiAndVersion()->toString() . '-'
|
|
. $uuid->getFields()->getClockSeqHiAndReserved()->toString()
|
|
. $uuid->getFields()->getClockSeqLow()->toString() . '-'
|
|
. $uuid->getFields()->getNode()->toString()
|
|
);
|
|
|
|
$this->assertSame(
|
|
(string) $uuid,
|
|
$uuid->getFields()->getTimeLow()->toString() . '-'
|
|
. $uuid->getFields()->getTimeMid()->toString() . '-'
|
|
. $uuid->getFields()->getTimeHiAndVersion()->toString() . '-'
|
|
. $uuid->getFields()->getClockSeqHiAndReserved()->toString()
|
|
. $uuid->getFields()->getClockSeqLow()->toString() . '-'
|
|
. $uuid->getFields()->getNode()->toString()
|
|
);
|
|
|
|
$this->assertSame(Variant::Rfc4122, $uuid->getFields()->getVariant());
|
|
$this->assertSame(Version::tryFrom((int) substr($method, -1)), $uuid->getFields()->getVersion());
|
|
$this->assertSame(1, preg_match('/^\d+$/', (string) $uuid->getInteger()));
|
|
}
|
|
|
|
/**
|
|
* @return array<array{0: string, 1: mixed[]}>
|
|
*/
|
|
public static function provideStaticCreationMethods(): array
|
|
{
|
|
return [
|
|
['uuid1', []],
|
|
['uuid1', ['00000fffffff']],
|
|
['uuid1', [null, 1234]],
|
|
['uuid1', ['00000fffffff', 1234]],
|
|
['uuid1', ['00000fffffff', null]],
|
|
['uuid1', [268435455]],
|
|
['uuid1', [268435455, 1234]],
|
|
['uuid1', [268435455, null]],
|
|
['uuid3', [Uuid::NAMESPACE_URL, 'https://example.com/foo']],
|
|
['uuid4', []],
|
|
['uuid5', [Uuid::NAMESPACE_URL, 'https://example.com/foo']],
|
|
];
|
|
}
|
|
|
|
public function testUuidVersion1MethodBehavior(): void
|
|
{
|
|
/** @var UuidV1 $uuid */
|
|
$uuid = Uuid::uuid1('00000fffffff', 0x3fff);
|
|
|
|
$this->assertInstanceOf('DateTimeInterface', $uuid->getDateTime());
|
|
$this->assertSame('00000fffffff', $uuid->getFields()->getNode()->toString());
|
|
$this->assertSame('3fff', $uuid->getFields()->getClockSeq()->toString());
|
|
}
|
|
|
|
/**
|
|
* @param non-empty-string $uuid
|
|
*/
|
|
#[DataProvider('provideIsValid')]
|
|
public function testIsValid(string $uuid, bool $expected): void
|
|
{
|
|
$this->assertSame($expected, Uuid::isValid($uuid), "{$uuid} is not a valid UUID");
|
|
$this->assertSame($expected, Uuid::isValid(strtoupper($uuid)), strtoupper($uuid) . ' is not a valid UUID');
|
|
}
|
|
|
|
/**
|
|
* @return array<array{0: non-empty-string, 1: bool}>
|
|
*/
|
|
public static function provideIsValid(): array
|
|
{
|
|
return [
|
|
// RFC 4122 UUIDs
|
|
['00000000-0000-0000-0000-000000000000', true],
|
|
['ff6f8cb0-c57d-11e1-8b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-11e1-9b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-11e1-ab21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-11e1-bb21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-21e1-8b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-21e1-9b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-21e1-ab21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-21e1-bb21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-31e1-8b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-31e1-9b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-31e1-ab21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-31e1-bb21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-41e1-8b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-41e1-9b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-41e1-ab21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-41e1-bb21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-51e1-8b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-51e1-9b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-51e1-ab21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-51e1-bb21-0800200c9a66', true],
|
|
|
|
// Non RFC 4122 UUIDs
|
|
['ffffffff-ffff-ffff-ffff-ffffffffffff', true],
|
|
['00000000-0000-0000-0000-000000000000', true],
|
|
['ff6f8cb0-c57d-01e1-0b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-1b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-2b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-3b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-4b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-5b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-6b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-7b21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-db21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-eb21-0800200c9a66', true],
|
|
['ff6f8cb0-c57d-01e1-fb21-0800200c9a66', true],
|
|
|
|
// Other valid patterns
|
|
['{ff6f8cb0-c57d-01e1-fb21-0800200c9a66}', true],
|
|
['urn:uuid:ff6f8cb0-c57d-01e1-fb21-0800200c9a66', true],
|
|
|
|
// Invalid UUIDs
|
|
['ffffffffffffffffffffffffffffffff', false],
|
|
['00000000000000000000000000000000', false],
|
|
['0', false],
|
|
['foobar', false],
|
|
['ff6f8cb0c57d51e1bb210800200c9a66', false],
|
|
['gf6f8cb0-c57d-51e1-bb21-0800200c9a66', false],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @param non-empty-string $string
|
|
* @param numeric-string $integer
|
|
*/
|
|
#[DataProvider('provideFromStringInteger')]
|
|
public function testSerialization(string $string, ?int $version, int $variant, string $integer): void
|
|
{
|
|
$uuid = Uuid::fromString($string);
|
|
|
|
$serialized = serialize($uuid);
|
|
|
|
/** @var UuidInterface $unserialized */
|
|
$unserialized = unserialize($serialized);
|
|
|
|
$this->assertSame(0, $uuid->compareTo($unserialized));
|
|
$this->assertTrue($uuid->equals($unserialized));
|
|
$this->assertSame("\"{$string}\"", json_encode($uuid));
|
|
}
|
|
|
|
/**
|
|
* @param non-empty-string $string
|
|
* @param numeric-string $integer
|
|
*/
|
|
#[DataProvider('provideFromStringInteger')]
|
|
public function testFromBytes(string $string, ?int $version, int $variant, string $integer): void
|
|
{
|
|
/** @var non-empty-string $bytes */
|
|
$bytes = hex2bin(str_replace('-', '', $string));
|
|
|
|
/** @var UuidInterface $uuid */
|
|
$uuid = Uuid::fromBytes($bytes);
|
|
|
|
$this->assertSame($string, $uuid->toString());
|
|
$this->assertSame(Version::tryFrom($version ?? 0), $uuid->getFields()->getVersion());
|
|
$this->assertSame(Variant::from($variant), $uuid->getFields()->getVariant());
|
|
|
|
$components = explode('-', $string);
|
|
|
|
$this->assertSame($components[0], $uuid->getFields()->getTimeLow()->toString());
|
|
$this->assertSame($components[1], $uuid->getFields()->getTimeMid()->toString());
|
|
$this->assertSame($components[2], $uuid->getFields()->getTimeHiAndVersion()->toString());
|
|
$this->assertSame(
|
|
$components[3],
|
|
$uuid->getFields()->getClockSeqHiAndReserved()->toString()
|
|
. $uuid->getFields()->getClockSeqLow()->toString(),
|
|
);
|
|
$this->assertSame($components[4], $uuid->getFields()->getNode()->toString());
|
|
$this->assertSame($integer, (string) $uuid->getInteger());
|
|
$this->assertSame($bytes, $uuid->getBytes());
|
|
}
|
|
|
|
/**
|
|
* @param non-empty-string $string
|
|
* @param numeric-string $integer
|
|
*/
|
|
#[DataProvider('provideFromStringInteger')]
|
|
public function testFromInteger(string $string, ?int $version, int $variant, string $integer): void
|
|
{
|
|
$bytes = hex2bin(str_replace('-', '', $string));
|
|
|
|
/** @var UuidInterface $uuid */
|
|
$uuid = Uuid::fromInteger($integer);
|
|
|
|
$this->assertSame($string, $uuid->toString());
|
|
$this->assertSame(Version::tryFrom($version ?? 0), $uuid->getFields()->getVersion());
|
|
$this->assertSame(Variant::from($variant), $uuid->getFields()->getVariant());
|
|
|
|
$components = explode('-', $string);
|
|
|
|
$this->assertSame($components[0], $uuid->getFields()->getTimeLow()->toString());
|
|
$this->assertSame($components[1], $uuid->getFields()->getTimeMid()->toString());
|
|
$this->assertSame($components[2], $uuid->getFields()->getTimeHiAndVersion()->toString());
|
|
$this->assertSame(
|
|
$components[3],
|
|
$uuid->getFields()->getClockSeqHiAndReserved()->toString()
|
|
. $uuid->getFields()->getClockSeqLow()->toString(),
|
|
);
|
|
$this->assertSame($components[4], $uuid->getFields()->getNode()->toString());
|
|
$this->assertSame($integer, (string) $uuid->getInteger());
|
|
$this->assertSame($bytes, $uuid->getBytes());
|
|
}
|
|
|
|
/**
|
|
* @param non-empty-string $string
|
|
* @param numeric-string $integer
|
|
*/
|
|
#[DataProvider('provideFromStringInteger')]
|
|
public function testFromString(string $string, ?int $version, int $variant, string $integer): void
|
|
{
|
|
$bytes = hex2bin(str_replace('-', '', $string));
|
|
|
|
/** @var UuidInterface $uuid */
|
|
$uuid = Uuid::fromString($string);
|
|
|
|
$this->assertSame($string, $uuid->toString());
|
|
$this->assertSame(Version::tryFrom($version ?? 0), $uuid->getFields()->getVersion());
|
|
$this->assertSame(Variant::from($variant), $uuid->getFields()->getVariant());
|
|
|
|
$components = explode('-', $string);
|
|
|
|
$this->assertSame($components[0], $uuid->getFields()->getTimeLow()->toString());
|
|
$this->assertSame($components[1], $uuid->getFields()->getTimeMid()->toString());
|
|
$this->assertSame($components[2], $uuid->getFields()->getTimeHiAndVersion()->toString());
|
|
$this->assertSame(
|
|
$components[3],
|
|
$uuid->getFields()->getClockSeqHiAndReserved()->toString()
|
|
. $uuid->getFields()->getClockSeqLow()->toString(),
|
|
);
|
|
$this->assertSame($components[4], $uuid->getFields()->getNode()->toString());
|
|
$this->assertSame($integer, (string) $uuid->getInteger());
|
|
$this->assertSame($bytes, $uuid->getBytes());
|
|
}
|
|
|
|
/**
|
|
* @return array<array{0: non-empty-string, 1: int | null, 2: int, 3: numeric-string}>
|
|
*/
|
|
public static function provideFromStringInteger(): array
|
|
{
|
|
return [
|
|
['00000000-0000-0000-0000-000000000000', null, 2, '0'],
|
|
['ff6f8cb0-c57d-11e1-8b21-0800200c9a66', 1, 2, '339532337419071774304650190139318639206'],
|
|
['ff6f8cb0-c57d-11e1-9b21-0800200c9a66', 1, 2, '339532337419071774305803111643925486182'],
|
|
['ff6f8cb0-c57d-11e1-ab21-0800200c9a66', 1, 2, '339532337419071774306956033148532333158'],
|
|
['ff6f8cb0-c57d-11e1-bb21-0800200c9a66', 1, 2, '339532337419071774308108954653139180134'],
|
|
['ff6f8cb0-c57d-21e1-8b21-0800200c9a66', 2, 2, '339532337419071849862513916053642058342'],
|
|
['ff6f8cb0-c57d-21e1-9b21-0800200c9a66', 2, 2, '339532337419071849863666837558248905318'],
|
|
['ff6f8cb0-c57d-21e1-ab21-0800200c9a66', 2, 2, '339532337419071849864819759062855752294'],
|
|
['ff6f8cb0-c57d-21e1-bb21-0800200c9a66', 2, 2, '339532337419071849865972680567462599270'],
|
|
['ff6f8cb0-c57d-31e1-8b21-0800200c9a66', 3, 2, '339532337419071925420377641967965477478'],
|
|
['ff6f8cb0-c57d-31e1-9b21-0800200c9a66', 3, 2, '339532337419071925421530563472572324454'],
|
|
['ff6f8cb0-c57d-31e1-ab21-0800200c9a66', 3, 2, '339532337419071925422683484977179171430'],
|
|
['ff6f8cb0-c57d-31e1-bb21-0800200c9a66', 3, 2, '339532337419071925423836406481786018406'],
|
|
['ff6f8cb0-c57d-41e1-8b21-0800200c9a66', 4, 2, '339532337419072000978241367882288896614'],
|
|
['ff6f8cb0-c57d-41e1-9b21-0800200c9a66', 4, 2, '339532337419072000979394289386895743590'],
|
|
['ff6f8cb0-c57d-41e1-ab21-0800200c9a66', 4, 2, '339532337419072000980547210891502590566'],
|
|
['ff6f8cb0-c57d-41e1-bb21-0800200c9a66', 4, 2, '339532337419072000981700132396109437542'],
|
|
['ff6f8cb0-c57d-51e1-8b21-0800200c9a66', 5, 2, '339532337419072076536105093796612315750'],
|
|
['ff6f8cb0-c57d-51e1-9b21-0800200c9a66', 5, 2, '339532337419072076537258015301219162726'],
|
|
['ff6f8cb0-c57d-51e1-ab21-0800200c9a66', 5, 2, '339532337419072076538410936805826009702'],
|
|
['ff6f8cb0-c57d-51e1-bb21-0800200c9a66', 5, 2, '339532337419072076539563858310432856678'],
|
|
['ff6f8cb0-c57d-01e1-0b21-0800200c9a66', null, 0, '339532337419071698737563092188140444262'],
|
|
['ff6f8cb0-c57d-01e1-1b21-0800200c9a66', null, 0, '339532337419071698738716013692747291238'],
|
|
['ff6f8cb0-c57d-01e1-2b21-0800200c9a66', null, 0, '339532337419071698739868935197354138214'],
|
|
['ff6f8cb0-c57d-01e1-3b21-0800200c9a66', null, 0, '339532337419071698741021856701960985190'],
|
|
['ff6f8cb0-c57d-01e1-4b21-0800200c9a66', null, 0, '339532337419071698742174778206567832166'],
|
|
['ff6f8cb0-c57d-01e1-5b21-0800200c9a66', null, 0, '339532337419071698743327699711174679142'],
|
|
['ff6f8cb0-c57d-01e1-6b21-0800200c9a66', null, 0, '339532337419071698744480621215781526118'],
|
|
['ff6f8cb0-c57d-01e1-7b21-0800200c9a66', null, 0, '339532337419071698745633542720388373094'],
|
|
['ff6f8cb0-c57d-01e1-cb21-0800200c9a66', null, 6, '339532337419071698751398150243422607974'],
|
|
['ff6f8cb0-c57d-01e1-db21-0800200c9a66', null, 6, '339532337419071698752551071748029454950'],
|
|
['ff6f8cb0-c57d-01e1-eb21-0800200c9a66', null, 7, '339532337419071698753703993252636301926'],
|
|
['ff6f8cb0-c57d-01e1-fb21-0800200c9a66', null, 7, '339532337419071698754856914757243148902'],
|
|
['ffffffff-ffff-ffff-ffff-ffffffffffff', null, 2, '340282366920938463463374607431768211455'],
|
|
];
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testGetSetFactory(): void
|
|
{
|
|
$this->assertInstanceOf('Ramsey\Uuid\UuidFactory', Uuid::getFactory());
|
|
|
|
$factory = Mockery::mock('Ramsey\Uuid\UuidFactory');
|
|
Uuid::setFactory($factory);
|
|
|
|
$this->assertSame($factory, Uuid::getFactory());
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testFactoryProvidesFunctionality(): void
|
|
{
|
|
$uuid = Mockery::mock('Ramsey\Uuid\UuidInterface');
|
|
|
|
$factory = Mockery::mock('Ramsey\Uuid\UuidFactoryInterface', [
|
|
'uuid1' => $uuid,
|
|
'uuid3' => $uuid,
|
|
'uuid4' => $uuid,
|
|
'uuid5' => $uuid,
|
|
'fromBytes' => $uuid,
|
|
'fromString' => $uuid,
|
|
'fromInteger' => $uuid,
|
|
]);
|
|
|
|
Uuid::setFactory($factory);
|
|
|
|
/** @var non-empty-string $bytes */
|
|
$bytes = hex2bin('ffffffffffffffffffffffffffffffff');
|
|
|
|
$this->assertSame($uuid, Uuid::uuid1('ffffffffffff', 0x3fff));
|
|
$this->assertSame($uuid, Uuid::uuid3(Uuid::NAMESPACE_URL, 'https://example.com/foo'));
|
|
$this->assertSame($uuid, Uuid::uuid4());
|
|
$this->assertSame($uuid, Uuid::uuid5(Uuid::NAMESPACE_URL, 'https://example.com/foo'));
|
|
$this->assertSame($uuid, Uuid::fromBytes($bytes));
|
|
$this->assertSame($uuid, Uuid::fromString('ffffffff-ffff-ffff-ffff-ffffffffffff'));
|
|
$this->assertSame($uuid, Uuid::fromInteger('340282366920938463463374607431768211455'));
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testUsingCustomCodec(): void
|
|
{
|
|
$mockUuid = Mockery::mock('Ramsey\Uuid\UuidInterface');
|
|
|
|
$codec = Mockery::mock('Ramsey\Uuid\Codec\CodecInterface', [
|
|
'encode' => 'abcd1234',
|
|
'encodeBinary' => hex2bin('abcd1234'),
|
|
'decode' => $mockUuid,
|
|
'decodeBytes' => $mockUuid,
|
|
]);
|
|
|
|
$factory = new UuidFactory();
|
|
$factory->setCodec($codec);
|
|
|
|
Uuid::setFactory($factory);
|
|
|
|
$uuid = Uuid::uuid4();
|
|
|
|
/** @var non-empty-string $bytes */
|
|
$bytes = hex2bin('f00ba2');
|
|
|
|
$this->assertSame('abcd1234', $uuid->toString());
|
|
$this->assertSame(hex2bin('abcd1234'), $uuid->getBytes());
|
|
$this->assertSame($mockUuid, Uuid::fromString('f00ba2'));
|
|
$this->assertSame($mockUuid, Uuid::fromBytes($bytes));
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testUsingCustomRandomGenerator(): void
|
|
{
|
|
$generator = Mockery::mock('Ramsey\Uuid\Generator\RandomGeneratorInterface', [
|
|
'generate' => hex2bin('01234567abcd5432dcba0123456789ab'),
|
|
]);
|
|
|
|
$factory = new UuidFactory();
|
|
$factory->setRandomGenerator($generator);
|
|
|
|
Uuid::setFactory($factory);
|
|
|
|
$uuid = Uuid::uuid4();
|
|
|
|
$this->assertSame('01234567-abcd-4432-9cba-0123456789ab', $uuid->toString());
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testUsingCustomTimeGenerator(): void
|
|
{
|
|
$generator = Mockery::mock('Ramsey\Uuid\Generator\TimeGeneratorInterface', [
|
|
'generate' => hex2bin('01234567abcd5432dcba0123456789ab'),
|
|
]);
|
|
|
|
$factory = new UuidFactory();
|
|
$factory->setTimeGenerator($generator);
|
|
|
|
Uuid::setFactory($factory);
|
|
|
|
$uuid = Uuid::uuid1();
|
|
|
|
$this->assertSame('01234567-abcd-1432-9cba-0123456789ab', $uuid->toString());
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testUsingDefaultTimeGeneratorWithCustomProviders(): void
|
|
{
|
|
$nodeProvider = Mockery::mock('Ramsey\Uuid\Provider\NodeProviderInterface', [
|
|
'getNode' => new Hexadecimal('0123456789ab'),
|
|
]);
|
|
|
|
$timeConverter = Mockery::mock('Ramsey\Uuid\Converter\TimeConverterInterface');
|
|
$timeConverter
|
|
->shouldReceive('calculateTime')
|
|
->andReturnUsing(function (int $seconds, int $microseconds) {
|
|
return new Hexadecimal('abcd' . dechex($microseconds) . dechex($seconds));
|
|
});
|
|
|
|
$timeProvider = Mockery::mock('Ramsey\Uuid\Provider\TimeProviderInterface', [
|
|
'currentTime' => [
|
|
'sec' => 1578522046,
|
|
'usec' => 10000,
|
|
],
|
|
'getTime' => new Time(1578522046, 10000),
|
|
]);
|
|
|
|
$generator = new DefaultTimeGenerator($nodeProvider, $timeConverter, $timeProvider);
|
|
|
|
$factory = new UuidFactory();
|
|
$factory->setTimeGenerator($generator);
|
|
|
|
Uuid::setFactory($factory);
|
|
|
|
$uuid = Uuid::uuid1(null, 4095);
|
|
|
|
$this->assertSame('5e1655be-2710-1bcd-8fff-0123456789ab', $uuid->toString());
|
|
}
|
|
|
|
#[RunInSeparateProcess]
|
|
#[PreserveGlobalState(false)]
|
|
public function testHelperFunctions(): void
|
|
{
|
|
$uuid1 = Mockery::mock('Ramsey\Uuid\UuidInterface', [
|
|
'toString' => 'aVersion1Uuid',
|
|
]);
|
|
$uuid3 = Mockery::mock('Ramsey\Uuid\UuidInterface', [
|
|
'toString' => 'aVersion3Uuid',
|
|
]);
|
|
$uuid4 = Mockery::mock('Ramsey\Uuid\UuidInterface', [
|
|
'toString' => 'aVersion4Uuid',
|
|
]);
|
|
$uuid5 = Mockery::mock('Ramsey\Uuid\UuidInterface', [
|
|
'toString' => 'aVersion5Uuid',
|
|
]);
|
|
|
|
$factory = Mockery::mock('Ramsey\Uuid\UuidFactoryInterface', [
|
|
'uuid1' => $uuid1,
|
|
'uuid3' => $uuid3,
|
|
'uuid4' => $uuid4,
|
|
'uuid5' => $uuid5,
|
|
]);
|
|
|
|
Uuid::setFactory($factory);
|
|
|
|
$this->assertSame('aVersion1Uuid', \Ramsey\Uuid\v1('ffffffffffff', 0x3fff));
|
|
$this->assertSame('aVersion3Uuid', \Ramsey\Uuid\v3(Uuid::NAMESPACE_URL, 'https://example.com/foo'));
|
|
$this->assertSame('aVersion4Uuid', \Ramsey\Uuid\v4());
|
|
$this->assertSame('aVersion5Uuid', \Ramsey\Uuid\v5(Uuid::NAMESPACE_URL, 'https://example.com/foo'));
|
|
}
|
|
|
|
/**
|
|
* @link https://git.io/JvJZo Use of TimestampFirstCombCodec in laravel/framework
|
|
*/
|
|
public function testUseOfTimestampFirstCombCodec(): void
|
|
{
|
|
$factory = new UuidFactory();
|
|
|
|
$factory->setRandomGenerator(new CombGenerator(
|
|
$factory->getRandomGenerator(),
|
|
$factory->getNumberConverter()
|
|
));
|
|
|
|
$factory->setCodec(new TimestampFirstCombCodec(
|
|
$factory->getUuidBuilder()
|
|
));
|
|
|
|
/** @var UuidInterface $uuid */
|
|
$uuid = $factory->uuid4();
|
|
|
|
// Swap fields according to the rules for TimestampFirstCombCodec.
|
|
$fields = [
|
|
$uuid->getFields()->getTimeLow()->toString(),
|
|
$uuid->getFields()->getTimeMid()->toString(),
|
|
$uuid->getFields()->getTimeHiAndVersion()->toString(),
|
|
$uuid->getFields()->getClockSeqHiAndReserved()->toString(),
|
|
$uuid->getFields()->getClockSeqLow()->toString(),
|
|
$uuid->getFields()->getNode()->toString(),
|
|
];
|
|
$last48Bits = $fields[5];
|
|
$fields[5] = $fields[0] . $fields[1];
|
|
$fields[0] = substr($last48Bits, 0, 8);
|
|
$fields[1] = substr($last48Bits, 8, 4);
|
|
|
|
$expectedHex = implode('', $fields);
|
|
$expectedBytes = hex2bin($expectedHex);
|
|
|
|
$this->assertSame(Variant::Rfc4122, $uuid->getFields()->getVariant());
|
|
$this->assertSame(Version::Random, $uuid->getFields()->getVersion());
|
|
$this->assertSame($expectedBytes, $uuid->getBytes());
|
|
$this->assertSame($expectedHex, (string) $uuid->getHex());
|
|
}
|
|
|
|
#[DataProvider('provideUuidConstantTests')]
|
|
public function testUuidConstants(string $constantName, int | string $expected): void
|
|
{
|
|
$this->assertSame($expected, constant("Ramsey\\Uuid\\Uuid::{$constantName}"));
|
|
}
|
|
|
|
/**
|
|
* @return array<array{string, int | string}>
|
|
*/
|
|
public static function provideUuidConstantTests(): array
|
|
{
|
|
return [
|
|
['NAMESPACE_DNS', '6ba7b810-9dad-11d1-80b4-00c04fd430c8'],
|
|
['NAMESPACE_URL', '6ba7b811-9dad-11d1-80b4-00c04fd430c8'],
|
|
['NAMESPACE_OID', '6ba7b812-9dad-11d1-80b4-00c04fd430c8'],
|
|
['NAMESPACE_X500', '6ba7b814-9dad-11d1-80b4-00c04fd430c8'],
|
|
['NIL', '00000000-0000-0000-0000-000000000000'],
|
|
['MAX', 'ffffffff-ffff-ffff-ffff-ffffffffffff'],
|
|
];
|
|
}
|
|
}
|