New in Symfony 6.2: Conditional Constraints

Contributed by
wuchen90

in #42593.

The Symfony Validator component includes some advanced constraints such as
Callback (to implement custom validation rules), Sequentially (to apply
a set of rules in order and interrupt them at any point), Compound (to create
a set of reusable constraints), etc.

In Symfony 6.2 we’re adding another advanced constraint to that list: When,
which allows to implement conditional validations.

Consider a Discount class with two properties:

// src/Model/Discount.php
namespace AppModel;

class Discount
{
private ?string $type;
private ?int $value;

// …
}

To validate the object contents, you need to apply these rules:

If type is percent, then value must be less than or equal 100;
If type is absolute, then value can be any value;
In all cases, the value must be greater than 0.

The new When constraint defines tow main options called expression and
constraints. These constraints are only enforced when the result of evaluating
the expression is true. You can use it as follows to validate that the
value is less than 100 only if the discount type is percent:

use SymfonyComponentValidatorConstraints as Assert;
// …

class Discount
{
#[AssertGreaterThan(0)]
#[AssertWhen(
expression: ‚this.type == „percent“‚,
constraints: [
new AssertLessThanOrEqual(100, message: ‚The value should be between 1 and 100!‘)
],
)]
private ?int $value;

// …
}

The condition passed to the expression option must use the Symfony
ExpressionLanguage syntax. Inside the expression you can use the this
variable to refer to the object being validated and value to refer to the
property being valuated (this is only available if you apply the When
constraint to properties).

Finally, you can combine When with other advanced constraints such as Callback
to define complex conditional validations:

use SymfonyComponentValidatorConstraints as Assert;
use SymfonyComponentValidatorContextExecutionContextInterface;

class Discount
{
#[AssertWhen(
expression: ‚value == „percent“‚,
constraints: [new AssertCallback(‚doComplexValidation‘)],
)]
private ?string $type;

// …
}

Sponsor the Symfony project.

Symfony Blog

Read More

Latest News

PHP-Releases

PHP 8.3.8 released!

PHP 8.2.20 released!

PHP 8.1.29 released!

Generated by Feedzy