You are browsing the documentation for Symfony 2.2 which is not maintained anymore.
Consider upgrading your projects to Symfony 5.2.
Null
Null¶
Validates that a value is exactly equal to null
. To force that a property
is simply blank (blank string or null
), see the Blank
constraint. To ensure that a property is not null, see NotNull.
Applies to | property or method |
Options | |
Class | Symfony\Component\Validator\Constraints\Null |
Validator | Symfony\Component\Validator\Constraints\NullValidator |
Basic Usage¶
If, for some reason, you wanted to ensure that the firstName
property
of an Author
class exactly equal to null
, you could do the following:
- YAML
1 2 3 4 5
# src/Acme/BlogBundle/Resources/config/validation.yml Acme\BlogBundle\Entity\Author: properties: firstName: - 'Null': ~
- Annotations
1 2 3 4 5 6 7 8 9 10 11 12
// src/Acme/BlogBundle/Entity/Author.php namespace Acme\BlogBundle\Entity; use Symfony\Component\Validator\Constraints as Assert; class Author { /** * @Assert\Null() */ protected $firstName; }
- XML
1 2 3 4 5 6 7 8 9 10 11 12
<!-- src/Acme/BlogBundle/Resources/config/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 http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd"> <class name="Acme\BlogBundle\Entity\Author"> <property name="firstName"> <constraint name="Null" /> </property> </class> </constraint-mapping>
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13
// src/Acme/BlogBundle/Entity/Author.php namespace Acme\BlogBundle\Entity; use Symfony\Component\Validator\Mapping\ClassMetadata; use Symfony\Component\Validator\Constraints as Assert; class Author { public static function loadValidatorMetadata(ClassMetadata $metadata) { $metadata->addPropertyConstraint('firstName', Assert\Null()); } }
Caution
When using YAML, be sure to surround Null
with quotes ('Null'
)
or else YAML will convert this into a null
value.
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.