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 = [];
}
    

        1
2
3
4
5
6
7
8
9
        # config/validator/validation.yaml
App\Entity\Participant:
    properties:
        emails:
            - Count:
                min: 1
                max: 5
                minMessage: 'You must specify at least one email'
                maxMessage: 'You cannot specify more than {{ limit }} emails'
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
        <!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Entity\Participant">
        <property name="emails">
            <constraint name="Count">
                <option name="min">1</option>
                <option name="max">5</option>
                <option name="minMessage">You must specify at least one email</option>
                <option name="maxMessage">You cannot specify more than {{ limit }} emails</option>
            </constraint>
        </property>
    </class>
</constraint-mapping>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
        // src/Entity/Participant.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Validator\Mapping\ClassMetadata;

class Participant
{
    // ...

    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addPropertyConstraint('emails', new Assert\Count([
            'min' => 1,
            'max' => 5,
            'minMessage' => 'You must specify at least one email',
            'maxMessage' => 'You cannot specify more than {{ limit }} emails',
        ]));
    }
}
    

Опции

`divisibleBy`

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

Валидирует, що количество элементов заданной коллекции можно поделить на определённое число.

`divisibleByMessage`

тип: string по умолчанию: Количество элементов в этой коллекции должно быть кратным {{ compared_value }}.

Сообщение, которое будет отображено, если количество элементов заданной коллекции нельзя поделить на число, определённое в опции divisibleBy.

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

????????	????????
`{{ compared_value }}`	?????, ?????????????????? ? ????? `divisibleBy`

`exactMessage`

тип: string по умолчанию: Эта коллекция должна содержать ровно {{ limit }} элементов.

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

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

????????	????????
`{{ count }}`	??????? ?????? ?????????
`{{ limit }}`	?????? ????????? ?????? ?????????

`groups`

type: array | string default: null

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

`max`

тип: integer

Эта опция - это максимальное значение счёта. Валидация будет неудачной, если заданная коллекция элементов больше, чем это максимальное значение.

Эта опция обязательна, если не определена опция min.

`maxMessage`

тип: string по умолчанию: Эта коллекция должна содержать {{ limit }} элементов или меньше.

Сообщение, отображаемое, если счёт основположной коллекции элементов больше, чем опция max.

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

????????	????????
`{{ count }}`	??????? ?????? ?????????
`{{ limit }}`	??????? ???????

`min`

тип: integer

Эта опция - это минимальное значение счёта. Валидация будет неудачной, если заданная коллекция элементов меньше, чем это минимальное значение.

Эта опция обязательна, если не определена опция max.

payload

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

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

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