Json

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

Json

Валідує, що значення має валідний синтаксис JSON.

????????????? ??	??????????? ??? ??????
????	Json
?????????	JsonValidator

Базове застосування

Обмеження Json може бути застосовано до властивості або методу "гетера":

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

use Symfony\Component\Validator\Constraints as Assert;

class Book
{
    #[Assert\Json(
        message: "You've entered an invalid Json."
    )]
    private string $chapters;
}
    

        1
2
3
4
5
6
        # config/validator/validation.yaml
App\Entity\Book:
    properties:
        chapters:
            - Json:
                message: You've entered an invalid Json.
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
        <!-- 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\Book">
        <property name="chapters">
            <constraint name="Json">
                <option name="message">You've entered an invalid Json.</option>
            </constraint>
        </property>
    </class>
</constraint-mapping>
    

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

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

class Book
{
    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addPropertyConstraint('chapters', new Assert\Json([
            'message' => 'You\'ve entered an invalid Json.',
        ]));
    }
}
    

Опції

`message`

тип: string за замовчуванням: Це значення має бути валідним JSON.

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

Дата оновлення перекладу 2024-05-29

`payload`

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

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

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