Locale

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

Locale

Валидирует, что значение является валидной локалью.

"Значение" каждой локали является любым из ID локалей формата ICU. Например, двухбуквенный код языка ISO 639-1 (например, fr), или код языка с нижним подчёркиванием после него (_) и кодом страны ISO 3166-1 alpha-2 (например, fr_FR для французского / Франции).

Заданные значения локали каноникализируются перед их валидацией, чтобы избежать проблем с неправильными значениями верхнего/нижнего регистра и чтобы удалить ненужные элемент (например, FR-fr.utf8 будет валидироваться как fr_FR).

??????????? ? ???????? ??? ??????
????? Locale
????????? LocaleValidator

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

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

use Symfony\Component\Validator\Constraints as Assert;

class User
{
    #[Assert\Locale(
        canonicalize: true,
    )]
    protected string $locale;
}

Note

As with most of the other constraints, null and empty strings are considered valid values. This is to allow them to be optional values. If the value is mandatory, a common solution is to combine this constraint with NotBlank.

Опции

groups

type: array | string default: null

It defines the validation group or groups of this constraint. Read more about validation groups.

message

тип: string по умолчанию: Это значение не является валидной локалью.

Это сообщение отображается, если строка не является валидной локалью.

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

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

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

payload

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

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

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