- What is Symfony?
- Get started
- Documentation
- Community
- Services
-
News
Latest News
What happened last week in Symfony?
This week, after the successful launch of Symfony 2.3, the development activity focused on the upcoming Symfony 2.4 version. The most important change was the introduction of simpler customization options for the Security component. In addition, Symfony 2.3.1 was released to address some minor bugs.
Upcoming EventsThe Symfony Community organizes events all over the world on a regular basis. Here are the next ones.
Switzerland, Zurich — Symfony CMF workshop day
on June 21, 2013, from 09:00 to 18:00
Spain, Madrid — deSymfony 2013
from June 21, 2013 to June 23, 2013
Germany, Cologne — SymfonySummit
from July 04, 2013 to July 05, 2013
Germany, Köln — Symfony User Group Cologne - After SymfonySummit Meetup
on July 04, 2013, from 18:30 to 22:00 - About
Questions & Feedback
Found a typo or an error?
Want to improve this document? Edit it.
Need support or have a technical question?
Post to the user mailing-list.
Master Symfony2 fundamentals
Symfony hosting done right
Discover the SensioLabs Support
Email¶
Validates that a value is a valid email address. The underlying value is cast to a string before being validated.
| Applies to | property or method |
| Options | |
| Class | Email |
| Validator | EmailValidator |
Basic Usage¶
- YAML
1 2 3 4 5 6 7
# src/BlogBundle/Resources/config/validation.yml Acme\BlogBundle\Entity\Author: properties: email: - Email: message: The email "{{ value }}" is not a valid email. checkMX: true
- Annotations
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
// src/Acme/BlogBundle/Entity/Author.php namespace Acme\BlogBundle\Entity; use Symfony\Component\Validator\Constraints as Assert; class Author { /** * @Assert\Email( * message = "The email '{{ value }}' is not a valid email.", * checkMX = true * ) */ protected $email; }
- XML
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
<!-- 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="email"> <constraint name="Email"> <option name="message">The email "{{ value }}" is not a valid email.</option> <option name="checkMX">true</option> </constraint> </property> </class> </constraint-mapping>
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
// 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('email', new Assert\Email(array( 'message' => 'The email "{{ value }}" is not a valid email.', 'checkMX' => true, ))); } }
Options¶
message¶
type: string default: This value is not a valid email address
This message is shown if the underlying data is not a valid email address.
checkMX¶
type: Boolean default: false
If true, then the checkdnsrr PHP function will be used to
check the validity of the MX record of the host of the given email.
checkHost¶
type: Boolean default: false
If true, then the checkdnsrr PHP function will be used to
check the validity of the MX or the A or the AAAA record of the host
of the given email.
NEWS FROM THE BLOG
IN THE NEWS
is a trademark of Fabien Potencier. All rights reserved.