vendor/shopware/core/Framework/Uuid/Uuid.php line 89

Open in your IDE?
  1. <?php declare(strict_types=1);
  3. namespace Shopware\Core\Framework\Uuid;
  5. use Shopware\Core\Framework\Uuid\Exception\InvalidUuidException;
  6. use Shopware\Core\Framework\Uuid\Exception\InvalidUuidLengthException;
  8. /**
  9.  * @package core
  10.  */
  11. class Uuid
  12. {
  13.     /**
  14.      * Regular expression pattern for matching a valid UUID of any variant.
  15.      */
  16.     public const VALID_PATTERN = '^[0-9a-f]{32}$';
  18.     public static function randomHex(): string
  19.     {
  20.         $hex = bin2hex(random_bytes(16));
  21.         $timeHi = self::applyVersion(mb_substr($hex, 12, 4), 4);
  22.         $clockSeqHi = self::applyVariant(hexdec(mb_substr($hex, 16, 2)));
  24.         return sprintf(
  25.             '%08s%04s%04s%02s%02s%012s',
  26.             // time low
  27.             mb_substr($hex, 0, 8),
  28.             // time mid
  29.             mb_substr($hex, 8, 4),
  30.             // time high and version
  31.             str_pad(dechex($timeHi), 4, '0', \STR_PAD_LEFT),
  32.             // clk_seq_hi_res
  33.             str_pad(dechex($clockSeqHi), 2, '0', \STR_PAD_LEFT),
  34.             // clock_seq_low
  35.             mb_substr($hex, 18, 2),
  36.             // node
  37.             mb_substr($hex, 20, 12)
  38.         );
  39.     }
  41.     public static function randomBytes(): string
  42.     {
  43.         return hex2bin(self::randomHex());
  44.     }
  46.     /**
  47.      * @throws InvalidUuidException
  48.      * @throws InvalidUuidLengthException
  49.      */
  50.     public static function fromBytesToHex(string $bytes): string
  51.     {
  52.         if (mb_strlen($bytes, '8bit') !== 16) {
  53.             throw new InvalidUuidLengthException(mb_strlen($bytes, '8bit'), bin2hex($bytes));
  54.         }
  55.         $uuid = bin2hex($bytes);
  57.         if (!self::isValid($uuid)) {
  58.             throw new InvalidUuidException($uuid);
  59.         }
  61.         return $uuid;
  62.     }
  64.     public static function fromBytesToHexList(array $bytesList): array
  65.     {
  66.         $converted = [];
  67.         foreach ($bytesList as $key => $bytes) {
  68.             $converted[$key] = self::fromBytesToHex($bytes);
  69.         }
  71.         return $converted;
  72.     }
  74.     public static function fromHexToBytesList(array $uuids): array
  75.     {
  76.         $converted = [];
  77.         foreach ($uuids as $key => $uuid) {
  78.             $converted[$key] = self::fromHexToBytes($uuid);
  79.         }
  81.         return $converted;
  82.     }
  84.     /**
  85.      * @throws InvalidUuidException
  86.      */
  87.     public static function fromHexToBytes(string $uuid): string
  88.     {
  89.         if ($bin = @hex2bin($uuid)) {
  90.             return $bin;
  91.         }
  93.         throw new InvalidUuidException($uuid);
  94.     }
  96.     /**
  97.      * Generates a md5 binary, to hash the string and returns a UUID in hex
  98.      */
  99.     public static function fromStringToHex(string $string): string
  100.     {
  101.         return self::fromBytesToHex(md5($string, true));
  102.     }
  104.     public static function isValid(string $id): bool
  105.     {
  106.         if (!preg_match('/' . self::VALID_PATTERN . '/', $id)) {
  107.             return false;
  108.         }
  110.         return true;
  111.     }
  113.     private static function applyVersion(string $timeHi, int $version): int
  114.     {
  115.         $timeHi = hexdec($timeHi) & 0x0fff;
  116.         $timeHi &= ~0xf000;
  117.         $timeHi |= $version << 12;
  119.         return $timeHi;
  120.     }
  122.     private static function applyVariant(int $clockSeqHi): int
  123.     {
  124.         // Set the variant to RFC 4122
  125.         $clockSeqHi &= 0x3f;
  126.         $clockSeqHi &= ~0xc0;
  127.         $clockSeqHi |= 0x80;
  129.         return $clockSeqHi;
  130.     }
  131. }