WordCount

Дата оновлення перекладу 2025-01-15

WordCount

7.2

Обмеження WordCount було представлене в Symfony 7.2.

Валідує, що рядок (або об'єкт, що реалізує інтерфейс PHP Stringable)
містить задану кількість слів. Внутрішньо це обмеження використовує клас IntlBreakIterator для підрахунку слів залежно від вашої локалі.

?????????????? ??	??????????? ??? ??????
????	WordCount
?????????	WordCountValidator

Базове використання

Якщо ви хочете гарантувати, що властивість content класу BlogPostDTO
містить від 100 до 200 слів, ви можете зробити наступне:

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

use Symfony\Component\Validator\Constraints as Assert;

class BlogPostDTO
{
    #[Assert\WordCount(min: 100, max: 200)]
    protected string $content;
}
    

        1
2
3
4
5
6
7
        # config/validator/validation.yaml
App\Entity\BlogPostDTO:
    properties:
        content:
            - WordCount:
                min: 100
                max: 200
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
        <!-- 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\BlogPostDTO">
        <property name="content">
            <constraint name="WordCount">
                <option name="min">100</option>
                <option name="max">200</option>
            </constraint>
        </property>
    </class>
</constraint-mapping>
    

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

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

class BlogPostDTO
{
    // ...

    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addPropertyConstraint('content', new Assert\WordCount([
            'min' => 100,
            'max' => 200,
        ]));
    }
}
    

Опції

`min`

тип: integer за замовчуванням: null

Мінімальна кількість слів, яку має містити значення.

`max`

тип: integer за замовчуванням: null

Максимальна кількість слів, яку має містити значення.

`locale`

тип: string за замовчуванням: null

Локаль, яку слід використовувати для підрахунку слів за допомогою класу
IntlBreakIterator. Значення за замовчуванням (null) означає, що обмеження
використовує поточну локаль користувача.

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

`groups`

тип: array | string за замовчуванням: null

Визначає групу або групи валідації обмеження. Прочитайте більше про групи валідації.

`minMessage`

тип: string за замовчуванням: Це значення занадто коротке. Має містити принаймні одне слово.| Це значення занадто коротке. Має містити принаймні {{ min }} слів.

Це повідомлення буде показано, якщо значення не містить принаймні мінімальної кількості слів.

Ви можете використовувати наступні параметри у цьому повідомленні:

????????	????
`{{ min }}`	?????????? ????????? ????
`{{ count }}`	??????? ????????? ????

`maxMessage`

тип: string за замовчуванням: Це значення занадто довге. Має містити одне слово.|Це значення занадто довге. Має містити {{ max }} слів або менше.

Це повідомлення буде показано, якщо значення містить більше ніж максимальну кількість слів.

Ви можете використовувати наступні параметри у цьому повідомленні:

????????	????
`{{ max }}`	??????????? ????????? ????
`{{ count }}`	??????? ????????? ????

Дата оновлення перекладу 2025-01-15

`payload`

тип: mixed за замовчуванням: null

Ця опція може бути використана, щоб додати довільні дані, специфічні для домену, до обмеження. Сконфігуроване корисне навантаження не використовується компонентом Validator, але його обробка повністю залежить від вас.

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