Json

Дата оновлення перекладу 2022-12-17

Json

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

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

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

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

Attributes
YAML
XML
PHP

        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: "Ви ввели невалідний Json."
    )]
    private $chapters;
}
    

        1
2
3
4
5
6
        # config/validator/validation.yaml
App\Entity\Book:
    properties:
        chapters:
            - Json:
                message: Ви ввели невалідний 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">Ви ввели невалідний 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)
    {
        $metadata->addPropertyConstraint('chapters', new Assert\Json([
            'message' => 'Ви ввели невалідний Json.',
        ]));
    }
}
    

Опції

`message`

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

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

Дата оновлення перекладу 2022-12-20

`payload`

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

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

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