字数统计

编辑此页

7.2

WordCount 约束在 Symfony 7.2 中引入。

验证字符串（或实现 Stringable PHP 接口的对象）是否包含给定数量的单词。在内部，此约束使用 IntlBreakIterator 类根据您的区域设置计数单词。

适用于	属性或方法
类	字数统计
验证器	WordCountValidator

基本用法

如果您想确保 BlogPostDTO 类的 content 属性包含 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.ac.cn/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.ac.cn/schema/dic/constraint-mapping http://symfony.ac.cn/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,
        ]));
    }
}
    