New: Add Carbon.String.isValidEmail helper

Classes/EelHelper/StringHelper.php

@@ -8,8 +8,7 @@
 use Neos\Eel\EvaluationException;
 use Neos\Eel\ProtectedContextAwareInterface;
 use Neos\Flow\Annotations as Flow;
-use function array_unique;
-use function func_get_args;
+use Neos\Flow\Validation\Validator\EmailAddressValidator;
 use function implode;
 use function is_array;
 use function lcfirst;
@@ -51,6 +50,23 @@ public function urlize(string $string): string
         return Transliterator::urlize($string);
     }
 
+    /**
+     * Checks if the string is a valid email address
+     *
+     * @param string|null $email
+     * @return boolean
+     */
+    public function isValidEmail(?string $email = null)
+    {
+        if (!is_string($email)) {
+            return false;
+        }
+
+        $validator = new EmailAddressValidator();
+        $result = $validator->validate($email);
+        return $validator->validate($email)->hasErrors() === false;
+    }
+
     /**
      * Helper to convert strings to PascalCase
      *

README.md

@@ -453,6 +453,20 @@ Examples:
 
 **Return** The phone number, optimized for links
 
+### `Carbon.String.isValidEmail(emailAddress)`
+
+Checks if the string is a valid email address
+
+Examples:
+
+| Expression                                 | Result  |
+| ------------------------------------------ | ------- |
+| `Carbon.String.isValidEmail('')`           | `false` |
+| `Carbon.String.phone('Some text')`         | `false` |
+| `Carbon.String.phone('[email protected]')` | `true`  |
+
+- `emailAddress` (string) The string to check
+
 ## Number Helper
 
 ### `Carbon.Number.format(number, decimals, dec_point, thousands_sep)`