[Validator][Email] - Strict validation and soft dependency

UPGRADE-2.5.md

@@ -5,3 +5,31 @@ Routing
 -------
 
  * Added a new optional parameter `$requiredSchemes` to `Symfony\Component\Routing\Generator\UrlGenerator::doGenerate()`
+
+Validator
+---------
+
+ * EmailValidator has changed to allow `non-strict` and `strict` email validation
+
+   Before:
+
+   Email validation was done with php's `filter_var()`
+
+   After:
+
+   Default email validation is now done via a simple regex which may cause invalid emails (not RFC compilant) to be 
+   valid. This is the default behaviour.
+
+   Strict email validation has to be explicitly activated in the configuration file by adding
+   ```
+   framework_bundle:
+      //...
+      validation:
+          strict_email: true
+      //...
+
+   ```
+   Also you have to add to your composer.json:
+   ```
+   "egulias/email-validator": "1.1.*"
+   ```

composer.json

@@ -73,7 +73,8 @@
         "monolog/monolog": "~1.3",
         "propel/propel1": "1.6.*",
         "ircmaxell/password-compat": "1.0.*",
-        "ocramius/proxy-manager": ">=0.3.1,<0.6-dev"
+        "ocramius/proxy-manager": ">=0.3.1,<0.6-dev",
+        "egulias/email-validator": "1.1.0"
     },
     "autoload": {
         "psr-0": { "Symfony\\": "src/" },

src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php

@@ -415,6 +415,7 @@ private function addValidationSection(ArrayNodeDefinition $rootNode)
                         ->scalarNode('cache')->end()
                         ->booleanNode('enable_annotations')->defaultFalse()->end()
                         ->scalarNode('translation_domain')->defaultValue('validators')->end()
+                        ->booleanNode('strict_email')->defaultFalse()->end()
                     ->end()
                 ->end()
             ->end()

src/Symfony/Bundle/FrameworkBundle/DependencyInjection/FrameworkExtension.php

@@ -655,6 +655,7 @@ private function registerValidationConfiguration(array $config, ContainerBuilder
         $container->setParameter('validator.translation_domain', $config['translation_domain']);
         $container->setParameter('validator.mapping.loader.xml_files_loader.mapping_files', $this->getValidatorXmlMappingFiles($container));
         $container->setParameter('validator.mapping.loader.yaml_files_loader.mapping_files', $this->getValidatorYamlMappingFiles($container));
+        $container->setParameter('validator.strict_email', $config['strict_email']);
 
         if (array_key_exists('enable_annotations', $config) && $config['enable_annotations']) {
             $loaderChain = $container->getDefinition('validator.mapping.loader.loader_chain');

src/Symfony/Bundle/FrameworkBundle/Resources/config/validator.xml

@@ -18,6 +18,7 @@
         <parameter key="validator.mapping.loader.xml_files_loader.mapping_files" type="collection" />
         <parameter key="validator.mapping.loader.yaml_files_loader.mapping_files" type="collection" />
         <parameter key="validator.expression.class">Symfony\Component\Validator\Constraints\ExpressionValidator</parameter>
+        <parameter key="validator.email.class">Symfony\Component\Validator\Constraints\EmailValidator</parameter>
     </parameters>
 
     <services>
@@ -69,5 +70,10 @@
             <argument type="service" id="property_accessor" />
             <tag name="validator.constraint_validator" alias="validator.expression" />
         </service>
+
+        <service id="validator.email" class="%validator.email.class%">
+            <argument>%validator.strict_email%</argument>
+            <tag name="validator.constraint_validator" alias="validator.email" />
+        </service>
     </services>
 </container>

src/Symfony/Bundle/FrameworkBundle/Tests/DependencyInjection/ConfigurationTest.php

@@ -127,6 +127,7 @@ protected static function getBundleDefaultConfig()
                 'enabled'            => false,
                 'enable_annotations' => false,
                 'translation_domain' => 'validators',
+                'strict_email'       => false,
             ),
             'annotations'         => array(
                 'cache'          => 'file',

src/Symfony/Component/Validator/CHANGELOG.md

@@ -6,6 +6,7 @@ CHANGELOG
 
  * deprecated `ApcCache` in favor of `DoctrineCache`
  * added `DoctrineCache` to adapt any Doctrine cache
+ * [BC BREAK] `EmailValidator` now has a lighter validation by default, uses `Egulias\EmailValidator` for strict validation
 
 2.4.0
 -----

src/Symfony/Component/Validator/Constraints/Email.php

@@ -25,4 +25,13 @@ class Email extends Constraint
     public $message = 'This value is not a valid email address.';
     public $checkMX = false;
     public $checkHost = false;
+    public $strict = null;
+
+    /**
+     * {@inheritDoc}
+     */
+    public function validatedBy()
+    {
+        return 'validator.email';
+    }
 }

src/Symfony/Component/Validator/Constraints/EmailValidator.php

@@ -14,6 +14,7 @@
 use Symfony\Component\Validator\Constraint;
 use Symfony\Component\Validator\ConstraintValidator;
 use Symfony\Component\Validator\Exception\UnexpectedTypeException;
+use Egulias\EmailValidator\EmailValidator as StrictEmailValidator;
 
 /**
  * @author Bernhard Schussek <bschussek@gmail.com>
@@ -22,6 +23,18 @@
  */
 class EmailValidator extends ConstraintValidator
 {
+    /**
+     * isStrict
+     *
+     * @var Boolean
+     */
+    private $isStrict;
+
+    public function __construct($strict)
+    {
+        $this->isStrict = $strict;
+    }
+
     /**
      * {@inheritDoc}
      */
@@ -36,12 +49,23 @@ public function validate($value, Constraint $constraint)
         }
 
         $value = (string) $value;
-        $valid = filter_var($value, FILTER_VALIDATE_EMAIL);
+        if ($constraint->strict === null) {
+            $constraint->strict = $this->isStrict;
+        }
+
+        if (true === $constraint->strict && class_exists('\Egulias\EmailValidator\EmailValidator')) {
+            $strictValidator = new StrictEmailValidator();
+            $valid = $strictValidator->isValid($value, $constraint->checkMX);
+        } elseif ($constraint->strict === true) {
+            throw new \RuntimeException('Strict email validation requires egulias/email-validator');
+        } else {
+            $valid = preg_match('/.+\@.+\..+/', $value);
+        }
 
         if ($valid) {
             $host = substr($value, strpos($value, '@') + 1);
-
             // Check for host DNS resource records
+
             if ($valid && $constraint->checkMX) {
                 $valid = $this->checkMX($host);
             } elseif ($valid && $constraint->checkHost) {

src/Symfony/Component/Validator/Tests/Constraints/EmailValidatorTest.php

@@ -22,7 +22,7 @@ class EmailValidatorTest extends \PHPUnit_Framework_TestCase
     protected function setUp()
     {
         $this->context = $this->getMock('Symfony\Component\Validator\ExecutionContext', array(), array(), '', false);
-        $this->validator = new EmailValidator();
+        $this->validator = new EmailValidator(false);
         $this->validator->initialize($this->context);
     }
 
@@ -100,7 +100,14 @@ public function getInvalidEmails()
             array('example'),
             array('example@'),
             array('example@localhost'),
-            array('example@example.com@example.com'),
         );
     }
+
+    public function testStrict()
+    {
+        $this->context->expects($this->never())
+            ->method('addViolation');
+
+        $this->validator->validate('example@localhost', new Email(array('strict' => true)));
+    }
 }

src/Symfony/Component/Validator/composer.json

@@ -26,15 +26,17 @@
         "symfony/yaml": "~2.0",
         "symfony/config": "~2.2",
         "doctrine/annotations": "~1.0",
-        "doctrine/cache": "~1.0"
+        "doctrine/cache": "~1.0",
+        "egulias/email-validator": "~1.0"
     },
     "suggest": {
         "doctrine/annotations": "For using the annotation mapping. You will also need doctrine/cache.",
         "doctrine/cache": "For using the default cached annotation reader and metadata cache.",
         "symfony/http-foundation": "",
         "symfony/intl": "",
         "symfony/yaml": "",
-        "symfony/config": ""
+        "symfony/config": "",
+        "egulias/email-validator": "Strict (RFC compliant) email validation"
     },
     "autoload": {
         "psr-0": { "Symfony\\Component\\Validator\\": "" }