Uuid

Дата обновления перевода 2024-07-25

Uuid

Валидирует, что значение является валидным Универсально-уникальным идентификатором (UUID) в RFC 4122. По умолчанию, будет влаидироваться формат, в соответствии с пособием RFC, но это может быть ослаблено, чтобы принимать нестандартые UUID, которые принимают другие системы (вроде PostgreSQL). Версии UUID также могут быть ограничены с использованием белого списка.

??????????? ? ???????? ??? ??????
????? Uuid
????????? UuidValidator

Базовое применение

1
2
3
4
5
6
7
8
9
10
// src/Entity/File.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class File
{
    #[Assert\Uuid]
    protected string $identifier;
}

Дата обновления перевода 2025-02-21

Note

Как и в большинстве других ограничений, null и пустые строки считаются валидными значениями. Это для того, чтобы позволить им быть опциональными значениями. Если значение является обязательным, распространенным решением будет комбинация этого ограничения с NotBlank.

Опции

Дата обновления перевода 2023-09-24

groups

тип: array | string по умолчанию: null

Определяет группу или группы валидации ограничений. Прочитайте больше о группах валидации.

message

тип: string по умолчанию: Это не валидный UUID.

Это сообщение отображается, если строка не является валидным UUID.

Вы можете использовать следующие параметры в этом сообщении:

???????? ????????
{{ value }} ??????? (??????????) ????????
{{ label }} ??????????????? ????? ???? ?????

Дата обновления перевода 2025-02-21

normalizer

тип: PHP-вызываемое по умолчанию: null

Эта опция позволяет вам определять PHP-вызываемое, примененное к заданному значению до проверки, является ли оно валидным.

Например, вы можете захотеть передать строку 'trim' для применения PHP-функции trim, чтобы игнорировать начальные и замыкающие пробелы во время валидации.

Дата обновления перевода 2025-02-05

payload

тип: mixed по умолчанию: null

Эта опция может быть использована, чтобы добавить к ограничению произвольные данные, относящиеся к домену. Сконфигурированная нагрузка не используется компонентом Валидатор, но его обработка полностью зависит от вас.

Например, вы можете захотеть исользовать несколько уровней ошибок, чтобы представить неудачные ограничения в фронт-энде по-разному, в зависимости от степени сложности ошибки.

strict

тип: boolean по умолчанию: true

Если эта опция установлена, как true, то ограничение проверит, отформатирован ли UUID в соответствии с правилами формата ввода RFC: 216fff40-98d9-11e3-a5e2-0800200c9a66. Установив её, как false, вы позволите варьировать форматы ввода, вроде:

  • 216f-ff40-98d9-11e3-a5e2-0800-200c-9a66
  • {216fff40-98d9-11e3-a5e2-0800200c9a66}
  • 216fff4098d911e3a5e20800200c9a66

versions

тип: int[]|int по умолчанию: [1,2,3,4,5]

Эта опция может быть использована только для разршения конкретных версий UUID. Валидные версии: 1 - 8. Вместо использования числовых значений, вы также можете использовать следующие PHP-константы, чтобы сослаться на каждую версию UUID:

  • Uuid::V1_MAC
  • Uuid::V2_DCE
  • Uuid::V3_MD5
  • Uuid::V4_RANDOM
  • Uuid::V5_SHA1
  • Uuid::V6_SORTABLE
  • Uuid::V7_MONOTONIC
  • Uuid::V8_CUSTOM