| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293 |
- <?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;
- /**
- * 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;
- }
- }
|