Debian Codegraph @

vendor/ramsey/uuid/src/Rfc4122/UuidV1.php

raw
1 <?php
2
3 /**
4 * This file is part of the ramsey/uuid library
5 *
6 * For the full copyright and license information, please view the LICENSE
7 * file that was distributed with this source code.
8 *
9 * @copyright Copyright (c) Ben Ramsey <[email protected]>
10 * @license http://opensource.org/licenses/MIT MIT
11 */
12
13 declare(strict_types=1);
14
15 namespace Ramsey\Uuid\Rfc4122;
16
17 use Ramsey\Uuid\Codec\CodecInterface;
18 use Ramsey\Uuid\Converter\NumberConverterInterface;
19 use Ramsey\Uuid\Converter\TimeConverterInterface;
20 use Ramsey\Uuid\Exception\InvalidArgumentException;
21 use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface;
22 use Ramsey\Uuid\Uuid;
23
24 /**
25 * Gregorian time, or version 1, UUIDs include timestamp, clock sequence, and node values, combined into a 128-bit unsigned integer
26 *
27 * @link https://www.rfc-editor.org/rfc/rfc9562#section-5.1 RFC 9562, 5.1. UUID Version 1
28 *
29 * @immutable
30 */
31 final class UuidV1 extends Uuid implements UuidInterface
32 {
33 use TimeTrait;
34
35 /**
36 * Creates a version 1 (Gregorian time) UUID
37 *
38 * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID
39 * @param NumberConverterInterface $numberConverter The number converter to use for converting hex values to/from integers
40 * @param CodecInterface $codec The codec to use when encoding or decoding UUID strings
41 * @param TimeConverterInterface $timeConverter The time converter to use for converting timestamps extracted from a
42 * UUID to unix timestamps
43 */
44 public function __construct(
45 Rfc4122FieldsInterface $fields,
46 NumberConverterInterface $numberConverter,
47 CodecInterface $codec,
48 TimeConverterInterface $timeConverter,
49 ) {
50 if ($fields->getVersion() !== Uuid::UUID_TYPE_TIME) {
51 throw new InvalidArgumentException(
52 'Fields used to create a UuidV1 must represent a version 1 (time-based) UUID',
53 );
54 }
55
56 parent::__construct($fields, $numberConverter, $codec, $timeConverter);
57 }
58 }