EnableAutoMapping

Дата обновления перевода 2023-09-25

EnableAutoMapping

Это ограничение позволяет включить Автомаппинг Doctrine в классе или свойстве. Автоматическое отображение позволяет определить правила валидации на основе атрибутов Doctrine. Вы можете использовать это ограничение, когда автоматическое отображение отключено глобально, но вы всё равно хотите включить эту возможность для конкретного класса или свойства.

??????????? ?	???????? ??? ??????
?????	EnableAutoMapping

Базовое применение

В следующем примере ограничения EnableAutoMapping скажет валидатору собирать ограничения из метаданных Doctrine:

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

use App\Model\Author;
use App\Model\BookMetadata;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;

#[Assert\EnableAutoMapping]
class BookCollection
{
    #[ORM\Column(nullable: false)]
    protected string $name = '';

    #[ORM\ManyToOne(targetEntity: Author::class)]
    public Author $author;

    // ...
}
    

        1
2
3
4
        # config/validator/validation.yaml
App\Entity\BookCollection:
    constraints:
        - EnableAutoMapping: ~
    

        1
2
3
4
5
6
7
8
9
10
        <!-- 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\BookCollection">
        <constraint name="EnableAutoMapping"/>
    </class>
</constraint-mapping>
    

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

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

class BookCollection
{
    // ...

    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addConstraint(new Assert\EnableAutoMapping());
    }
}
    

Опции

Опция groups недоступна для этого ограничения.

Дата обновления перевода 2024-07-25

payload

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

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

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