週

編輯此頁面

7.2

Week 約束已在 Symfony 7.2 中引入。

驗證給定的字串（或實作 Stringable PHP 介面的物件）是否表示符合 ISO-8601 標準的有效週數（例如 2025-W01）。

適用於	屬性或方法
類別	週
驗證器	WeekValidator

基本用法

如果您想確保 OnlineCourse 類別的 startWeek 屬性介於 2022 年的第一週和第二十週之間，您可以執行以下操作

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

use Symfony\Component\Validator\Constraints as Assert;

class OnlineCourse
{
    #[Assert\Week(min: '2022-W01', max: '2022-W20')]
    protected string $startWeek;
}
    

        1
2
3
4
5
6
7
        # config/validator/validation.yaml
App\Entity\OnlineCourse:
    properties:
        startWeek:
            - Week:
                min: '2022-W01'
                max: '2022-W20'
    

        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="https://symfony.dev.org.tw/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://symfony.dev.org.tw/schema/dic/constraint-mapping https://symfony.dev.org.tw/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Entity\OnlineCourse">
        <property name="startWeek">
            <constraint name="Week">
                <option name="min">2022-W01</option>
                <option name="max">2022-W20</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/OnlineCourse.php
namespace App\Entity;

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

class OnlineCourse
{
    // ...

    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addPropertyConstraint('startWeek', new Assert\Week([
            'min' => '2022-W01',
            'max' => '2022-W20',
        ]));
    }
}
    