1
2
3
4
5
6
7
8
9
10

use Symfony\Component\Uid\Uuid;

// ви можете використати будь-яке з попередньо визначених просторів імен...
$namespace = Uuid::fromString(Uuid::NAMESPACE_OID);
// ...або використати довільний простір імен:
// $namespace = Uuid::v4();

// $name може бути будь-яким довільним рядком
// $uuid is an instance of Symfony\Component\Uid\UuidV3
$uuid = Uuid::v3($namespace, $name);

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

namespace App\Service;

use Symfony\Component\Uid\Factory\UuidFactory;

class FooService
{
    public function __construct(
        private UuidFactory $uuidFactory,
    ) {
    }

    public function generate(): void
    {
        // Це створить UUID версії, наданої у файлі конфігурації (за замовчуванням v6)
        $uuid = $this->uuidFactory->create();

        $nameBasedUuid = $this->uuidFactory->nameBased(/** ... */);
        $randomBasedUuid = $this->uuidFactory->randomBased();
        $timestampBased = $this->uuidFactory->timeBased();

        // ...
    }
}

1
2
3
4
5
6
7
8
9
10

// перетворити V1 на V6 або V7
$uuid = Uuid::v1();

$uuid->toV6(); // повертає екземпляр Symfony\Component\Uid\UuidV6
$uuid->toV7(); // повертає екземпляр Symfony\Component\Uid\UuidV7

// перетворити V6 на V7
$uuid = Uuid::v6();

$uuid->toV7(); // повертає екземпляр Symfony\Component\Uid\UuidV7

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

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

// перевірка, чи є UUID null (відмітьте, що клас називається
// NilUuid замість NullUuid, щоб слідувати стандартній нотації 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 та перевірка рівності
$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

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

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

#[ORM\Entity(repositoryClass: ProductRepository::class)]
class Product
{
    #[ORM\Column(type: UuidType::NAME)]
    private Uuid $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 ?Uuid $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(), UuidType::NAME)

            // як варіант, ви можете перетворити його на значення, сумісне з
            // типом, визначеним Doctrine
            ->setParameter('user', $user->getUuid()->toBinary())
        ;

        // ...
    }
}

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

namespace App\Service;

use Symfony\Component\Uid\Factory\UlidFactory;

class FooService
{
    public function __construct(
        private UlidFactory $ulidFactory,
    ) {
    }

    public function generate(): void
    {
        $ulid = $this->ulidFactory->create();

        // ...
    }
}

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 або false

// отримання часу та дати ULID
$ulid1->getDateTime(); // повертає \DateTimeImmutable instance

// порівняння ULID та перевірка рівності
$ulid1->equals($ulid2); // false
// this method returns $ulid1 <=> $ulid2
$ulid1->compare($ulid2); // наприклад, int(-1)

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

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

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

#[ORM\Entity(repositoryClass: ProductRepository::class)]
class Product
{
    #[ORM\Column(type: UlidType::NAME)]
    private Ulid $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 ?Ulid $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

// src/Repository/ProductRepository.php

// ...
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())
        ;

        // ...
    }
}