Count
Дата оновлення перекладу 2023-09-25
Count
Валідує, що задана кількість елементів колекції (тобто, масиву або обʼєкта, що реалізує Countable) знаходиться між якимось мінімальним та максимальним значенням.
?????????????? ?? | ???????????? ??? ?????? |
???? | Count |
????????? | CountValidator |
Базове застосування
Щоб верифікувати, що поле масиву emails
містить між 1 та 5 елементами, ви можете
додати наступне:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
// src/Entity/Participant.php
namespace App\Entity;
use Symfony\Component\Validator\Constraints as Assert;
class Participant
{
#[Assert\Count(
min: 1,
max: 5,
minMessage: 'You must specify at least one email',
maxMessage: 'You cannot specify more than {{ limit }} emails',
)]
protected array $emails = [];
}
Опції
divisibleBy
тип: integer
за замовчуванням: null
Валідує, що кількість елементів заданої колекції можна поділити на певне число.
See also
Якщо вам потрібно валідувати, що інші типи данних, які відрізняються від колекції, можна поділити на певне число, використайте обмеження DivisibleBy.
divisibleByMessage
тип: string
за замовчуванням: Кількість елементів у цій колекції має бути кратним {{ compared_value }}.
Повідомлення, яке буде відображено, якщо кількість елементів заданої колекції не
можна поділити на число, визначене в опції divisibleBy
.
Ви можете використати наступні параметри у цьому повідомленні:
???????? | ???? |
---|---|
{{ compared_value }} |
?????, ?????????????? ? ????? divisibleBy |
exactMessage
тип: string
за замовчуванням: Ця колекція має містити рівно {{ limit }} елементів.
Це півідомлення буде відображено, якщо мінмальне та максимальне значення однакові, а кількість елементів основної колекції не дорівнює цьому значенню.
Ви можете використати наступні параметри у цьому повідомленні:
???????? | ????? |
---|---|
{{ count }} |
???????? ?????? ???????? |
{{ limit }} |
?????? ?????????? ?????? ???????? |
Дата оновлення перекладу 2023-09-24
groups
тип: array
| string
за замовчуванням: null
Визначає групу або групи валідації обмеження. Прочитайте більше про групи валідації.
max
тип: integer
Ця опція - це "max" значення кількості. Валідація буде невдалою, якщо задана кількість елементів колекції більше, ніж це максимальне значення.
Ця опція обовʼязкова, якщо не визначено опцію min
.
maxMessage
тип: string
за замовчуванням: Ця колекція має містити {{ limit }} елементів, або менше.
Це повідомлення буде відображено, якщо кількість елементів основної колекції більша за опцію max.
Ви можете використати наступні параметри у цьому повідомленні:
???????? | ???? |
---|---|
{{ count }} |
???????? ?????? ???????? |
{{ limit }} |
?????? ???? |
min
тип: integer
Ця опція - це "min" значення кількості. Валідація буде невдалою, якщо задана кількість елементів колекції менше, ніж це максимальне значення.
Ця опція обовʼязкова, якщо не визначено опцію max
.
minMessage
тип: string
за замовчуванням: Ця колекція має містити {{ limit }} елементів, або більше.
Це повідомлення буде відображено, якщо кількість елементів основної колекції більша за опцію min.
Ви можете використати наступні параметри у цьому повідомленні:
???????? | ???? |
---|---|
{{ count }} |
???????? ?????? ???????? |
{{ limit }} |
????? ???? |
Дата оновлення перекладу 2024-05-29
payload
тип: mixed
за замовчуванням: null
Ця опція може бути використана, щоб додати довільні дані, специфічні для домену, до обмеження. Сконфігуроване корисне навантаження не використовується компонентом Validator, але його обробка повністю залежить від вас.
Наприклад, ви можете захотіти використати декілька рівнів помилок, щоб представити неуспішні обмеження по-різному у фронтенді, залежно від серйозності помилки.