You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
95 lines
3.1 KiB
95 lines
3.1 KiB
<?php |
|
|
|
/* |
|
* This file is part of the Symfony package. |
|
* |
|
* (c) Fabien Potencier <fabien@symfony.com> |
|
* |
|
* For the full copyright and license information, please view the LICENSE |
|
* file that was distributed with this source code. |
|
*/ |
|
|
|
namespace Symfony\Component\Uid; |
|
|
|
use Symfony\Component\Uid\Exception\InvalidArgumentException; |
|
|
|
/** |
|
* A v6 UUID is lexicographically sortable and contains a 60-bit timestamp and 62 extra unique bits. |
|
* |
|
* Unlike UUIDv1, this implementation of UUIDv6 doesn't leak the MAC address of the host. |
|
* |
|
* @author Nicolas Grekas <p@tchwork.com> |
|
*/ |
|
class UuidV6 extends Uuid implements TimeBasedUidInterface |
|
{ |
|
protected const TYPE = 6; |
|
|
|
private static string $node; |
|
|
|
public function __construct(?string $uuid = null) |
|
{ |
|
if (null === $uuid) { |
|
$this->uid = static::generate(); |
|
} else { |
|
parent::__construct($uuid, true); |
|
} |
|
} |
|
|
|
public function getDateTime(): \DateTimeImmutable |
|
{ |
|
return BinaryUtil::hexToDateTime('0'.substr($this->uid, 0, 8).substr($this->uid, 9, 4).substr($this->uid, 15, 3)); |
|
} |
|
|
|
public function getNode(): string |
|
{ |
|
return substr($this->uid, 24); |
|
} |
|
|
|
public function toV7(): UuidV7 |
|
{ |
|
$uuid = $this->uid; |
|
$time = BinaryUtil::hexToNumericString('0'.substr($uuid, 0, 8).substr($uuid, 9, 4).substr($uuid, 15, 3)); |
|
if ('-' === $time[0]) { |
|
throw new InvalidArgumentException('Cannot convert UUID to v7: its timestamp is before the Unix epoch.'); |
|
} |
|
|
|
$ms = \strlen($time) > 4 ? substr($time, 0, -4) : '0'; |
|
$time = dechex(10000 * hexdec(substr($uuid, 20, 3)) + substr($time, -4)); |
|
|
|
if (\strlen($time) > 6) { |
|
$uuid[29] = dechex(hexdec($uuid[29]) ^ hexdec($time[0])); |
|
$time = substr($time, 1); |
|
} |
|
|
|
return new UuidV7(substr_replace(\sprintf( |
|
'%012s-7%s-%s%s-%s%06s', |
|
\PHP_INT_SIZE >= 8 ? dechex($ms) : bin2hex(BinaryUtil::fromBase($ms, BinaryUtil::BASE10)), |
|
substr($uuid, -6, 3), |
|
$uuid[19], |
|
substr($uuid, -3), |
|
substr($uuid, -12, 6), |
|
$time |
|
), '-', 8, 0)); |
|
} |
|
|
|
public static function generate(?\DateTimeInterface $time = null, ?Uuid $node = null): string |
|
{ |
|
$uuidV1 = UuidV1::generate($time, $node); |
|
$uuid = substr($uuidV1, 15, 3).substr($uuidV1, 9, 4).$uuidV1[0].'-'.substr($uuidV1, 1, 4).'-6'.substr($uuidV1, 5, 3).substr($uuidV1, 18, 6); |
|
|
|
if ($node) { |
|
return $uuid.substr($uuidV1, 24); |
|
} |
|
|
|
// uuid_create() returns a stable "node" that can leak the MAC of the host, but |
|
// UUIDv6 prefers a truly random number here, let's XOR both to preserve the entropy |
|
|
|
if (!isset(self::$node)) { |
|
$seed = [random_int(0, 0xFFFFFF), random_int(0, 0xFFFFFF)]; |
|
$node = unpack('N2', hex2bin('00'.substr($uuidV1, 24, 6)).hex2bin('00'.substr($uuidV1, 30))); |
|
self::$node = \sprintf('%06x%06x', ($seed[0] ^ $node[1]) | 0x010000, $seed[1] ^ $node[2]); |
|
} |
|
|
|
return $uuid.self::$node; |
|
} |
|
}
|
|
|