| Class | IsFalse |
| Validator | IsFalseValidator |
#[\Attribute(\Attribute::TARGET_PROPERTY | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
class IsFalse extends Constraint
IsFalseLa contrainte IsFalse de Symfony permet de s'assurer qu'une valeur est strictement false (booléen). Elle est utilisée principalement pour valider des champs qui doivent être décochés ou ne pas être activés.
La contrainte IsFalse impose que la valeur soit strictement false (booléen false, 0 ou "0").
Si la valeur est true, 1, "1", ou toute autre valeur considérée comme vraie, la validation échoue.
Utile pour valider des cases à cocher non cochées ou des conditions qui ne doivent pas être activées.
use Symfony\Component\Validator\Constraints as Assert;
class User
{
/**
* @Assert\IsFalse(message="Vous ne devez pas accepter cette condition.")
*/
private $isBanned;
}
➡ Explication : La propriété $isBanned doit être false. Si elle est true, un message d'erreur s'affiche.
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\Validator\Constraints\IsFalse;
use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
class MyFormType extends AbstractType
{
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
->add('subscribeToSpam', CheckboxType::class, [
'constraints' => [
new IsFalse([
'message' => 'Vous ne devez pas vous inscrire aux spams.',
])
],
]);
}
}
➡ Explication : L'utilisateur ne doit pas cocher la case subscribeToSpam.
| Option | Description | Valeur par défaut |
|---|---|---|
message | Message d'erreur affiché si la valeur n'est pas false. | "This value should be false." |
groups | Permet d’appliquer la contrainte uniquement à certains groupes de validation. | null |
payload | Stocke des métadonnées personnalisées pour d'autres systèmes. | null |
groupsPermet d'appliquer la contrainte uniquement dans certains scénarios de validation.
use Symfony\Component\Validator\Constraints as Assert;
class User
{
/**
* @Assert\IsFalse(groups={"admin_validation"})
*/
private $isSuspended;
}
➡ Explication : Cette contrainte ne sera vérifiée que lorsque la validation est effectuée avec le groupe "admin_validation".
message)use Symfony\Component\Validator\Constraints as Assert;
class User
{
/**
* @Assert\IsFalse(message="Cette option ne doit pas être activée.")
*/
private $allowTracking;
}
➡ Explication : Si allowTracking est true, un message d'erreur personnalisé s'affichera.
payloadL’option payload permet d’ajouter des métadonnées à la contrainte.
use Symfony\Component\Validator\Constraints as Assert;
class User
{
/**
* @Assert\IsFalse(payload={"severity"="warning"})
*/
private $isDeprecated;
}
➡ Explication : Cette donnée ne change pas la validation mais peut être utilisée par d'autres systèmes (logs, alertes, etc.).
IsFalse et IsTrue| Contrainte | Comportement attendu |
|---|---|
IsFalse | La valeur doit être strictement false (ou 0, "0") |
IsTrue | La valeur doit être strictement true (ou 1, "1") |
use Symfony\Component\Validator\Constraints as Assert;
class Example
{
/**
* @Assert\IsFalse(message="Ne cochez pas cette case.")
*/
private $shouldBeFalse;
/**
* @Assert\IsTrue(message="Cette option est obligatoire.")
*/
private $shouldBeTrue;
}
Empêcher qu'une option soit activée (ex. : désactivation du suivi publicitaire).
Vérifier qu'un champ booléen lié à une interdiction (isBanned, isSuspended) est bien false.
Valider qu'un utilisateur n’a pas coché une case qu’il ne doit pas cocher.
La contrainte IsFalse est simple et utile pour imposer qu'une valeur soit false. Elle propose trois options principales (message, groups, payload) pour personnaliser son utilisation selon les besoins.
Powered by Froala Editor