1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

use Symfony\Component\Uid\Uuid;

// UUID 1го типа генерирует UUID, используя MAC-адрес вашего устройства и временную отметку.
// Оба получаются автоматически, поэтому вам не нужно передавать никакие аргументы конструктора.
$uuid = Uuid::v1(); // $uuid is an instance of Symfony\Component\Uid\UuidV1

// UUID 4го типа генерирует рандомный UUID, поэтому вам не нужно передавать никакие аргументы конструктора.
$uuid = Uuid::v4(); // $uuid is an instance of Symfony\Component\Uid\UuidV4

// UUID 3го и 5го типов генерируют UUID, хещируя заданное пространство имен и имя. 3й тип использует
// MD5-хеши, а 5й тип использует SHA-1. Пространство имен - это еще один UUID (например, UUID 4го типа),
// а имя - произвольная строка (например, название продукта; если оно уникально).
$namespace = Uuid::v4();
$name = $product->getUniqueName();

$uuid = Uuid::v3($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV3
$uuid = Uuid::v5($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV5

// пространства имён, определенные RFC 4122 (см. https://tools.ietf.org/html/rfc4122#appendix-C)
// доступны как PHP-константы и как значения строк
$uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);  // same as: Uuid::v3('dns', $name);
$uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);  // same as: Uuid::v3('url', $name);
$uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);  // same as: Uuid::v3('oid', $name);
$uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name); // same as: Uuid::v3('x500', $name);

// UUID 6го типа не являются частью стандарта UUID. Он лексикографически сортируемый
// (как ULID) и содержит 60-битную временную отметку вместе с 63 дополнительными уникальными битами.
// Он определяется в http://gh.peabody.io/uuidv6/
$uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6

// UUID версии 7 представляет поле значения, упорядоченное по времени, выведенное из хорошо известного
// источника временной отметки Unix Epoch: количество секунд с полуночи 1 января 1970 UTC, високосные секунды исключены.
// А также улучшенные характеристики энтропии по сравнению с версиями 1 и 6.
$uuid = Uuid::v7();

// UUID версии 8 предоставляет формат, совместимый с RFC, для экспериментальных случаев использования, для конкретных поставщиков.
// Единственное требование - биты варианта и версии ДОЛЖНЫ быть установлены, как определено в Разделе 4:
// https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#variant_and_version_fields
// уникальность UUIDv8 будет зависеть от реализации и НЕ ДОЛЖНА предполагаться.
$uuid = Uuid::v8();

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

use Symfony\Component\Uid\NilUuid;
use Symfony\Component\Uid\Uuid;

// проверка, является ли UUID null (отметьте, что класс называется
// NilUuid вместо NullUuid, чтобы следовать cтандартной нотации UUID)
$uuid = Uuid::v4();
$uuid instanceof NilUuid; // false

// проверка типа UUID
use Symfony\Component\Uid\UuidV4;
$uuid = Uuid::v4();
$uuid instanceof UuidV4; // true

// получение даты и времени UUID (доступно только в некоторых типах UUID)
$uuid = Uuid::v1();
$uuid->getDateTime();  // returns a \DateTimeImmutable instance

// проверка, является ли заданное значение валидным как UUID
$isValid = Uuid::isValid($uuid); // true or false

// сравнение UUID и проверка равенства
$uuid1 = Uuid::v1();
$uuid4 = Uuid::v4();
$uuid1->equals($uuid4); // false

// этот метод возвращает:
//   * int(0), если $uuid1 и $uuid4 равны
//   * int > 0, если $uuid1 больше, чем $uuid4
//   * int < 0, если $uuid1 меньше, чем $uuid4
$uuid1->compare($uuid4); // например, int(4)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

// src/Entity/Product.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
 */
class Product
{
    /**
     * @ORM\Column(type="uuid")
     */
    private $someProperty;

    // ...
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Bridge\Doctrine\Types\UuidType;
use Symfony\Component\Uid\Uuid;

class User implements UserInterface
{
    #[ORM\Id]
    #[ORM\Column(type: UuidType::NAME, unique: true)]
    #[ORM\GeneratedValue(strategy: 'CUSTOM')]
    #[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
    private $id;

    public function getId(): ?Uuid
    {
        return $this->id;
    }

    // ...
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// src/Repository/ProductRepository.php

// ...
use Symfony\Bridge\Doctrine\Types\UuidType;

class ProductRepository extends ServiceEntityRepository
{
    // ...

    public function findUserProducts(User $user): array
    {
        $qb = $this->createQueryBuilder('p')
            // ...
            // добавьте 'uuid' как третий аргумент, чтобы сообщить Doctrine, что это UUID
            ->setParameter('user', $user->getUuid(), 'uuid')

            // как вариант, вы можете преобразовать его в значение, совместимое с
            // типом, определенным Doctrine
            ->setParameter('user', $user->getUuid()->toBinary())
        ;

        // ...
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

use Symfony\Component\Uid\Ulid;

$ulid1 = new Ulid();
$ulid2 = new Ulid();

// проверка, является ли заданное значение валидным как ULID
$isValid = Ulid::isValid($ulidValue); // true or false

// получение времени и даты ULID
$ulid1->getDateTime(); // returns a \DateTimeImmutable instance

// сравнение ULID и проверка равенства
$ulid1->equals($ulid2); // false
// this method returns $ulid1 <=> $ulid2
$ulid1->compare($ulid2); // e.g. int(-1)

1
2
3
4
5
6
7
8
9
10
11
12
13
14

// src/Entity/Product.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Bridge\Doctrine\Types\UlidType;

#[ORM\Entity(repositoryClass: ProductRepository::class)]
class Product
{
    #[ORM\Column(type: UlidType::NAME)]
    private $someProperty;

    // ...
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Bridge\Doctrine\Types\UlidType;
use Symfony\Component\Uid\Ulid;

class Product
{
    #[ORM\Id]
    #[ORM\Column(type: UlidType::NAME, unique: true)]
    #[ORM\GeneratedValue(strategy: 'CUSTOM')]
    #[ORM\CustomIdGenerator(class: 'doctrine.ulid_generator')]
    private $id;

    public function getId(): ?Ulid
    {
        return $this->id;
    }

    // ...

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// src/Repository/ProductRepository.php

// ...
use Symfony\Bridge\Doctrine\Types\UlidType;

class ProductRepository extends ServiceEntityRepository
{
    // ...

    public function findUserProducts(User $user): array
    {
        $qb = $this->createQueryBuilder('p')
            // ...
            // добавьте 'ulid' как третий аргумент, чтобы сообщить Doctrine, что это ULID
            ->setParameter('user', $user->getUlid(), 'ulid')

            // как вариант, вы можете преобразовать его в значение, совместимое с
            // типом, определенным Doctrine
            ->setParameter('user', $user->getUlid()->toBinary())
        ;

        // ...
    }
}