diff options
Diffstat (limited to 'platform/www/vendor/aziraphale/email-address-validator')
| -rw-r--r-- | platform/www/vendor/aziraphale/email-address-validator/EmailAddressValidator.php | 183 | ||||
| -rw-r--r-- | platform/www/vendor/aziraphale/email-address-validator/README.md | 59 |
2 files changed, 242 insertions, 0 deletions
diff --git a/platform/www/vendor/aziraphale/email-address-validator/EmailAddressValidator.php b/platform/www/vendor/aziraphale/email-address-validator/EmailAddressValidator.php new file mode 100644 index 0000000..21285bc --- /dev/null +++ b/platform/www/vendor/aziraphale/email-address-validator/EmailAddressValidator.php @@ -0,0 +1,183 @@ +<?php + +/** + * Class EmailAddressValidator + * + * @link https://github.com/aziraphale/email-address-validator + * @link http://code.google.com/p/php-email-address-validation/ + * @license New BSD license http://www.opensource.org/licenses/bsd-license.php + * @example if (EmailAddressValidator::checkEmailAddress('test@example.org')) { + * @example // Email address is technically valid + * @example } + */ +class EmailAddressValidator +{ + /** + * Check email address validity + * @param string $emailAddress Email address to be checked + * @param bool $allowLocal allow local domains + * @return bool Whether email is valid + */ + public static function checkEmailAddress($emailAddress, $allowLocal = false) + { + // If magic quotes is "on", email addresses with quote marks will + // fail validation because of added escape characters. Uncommenting + // the next three lines will allow for this issue. + //if (get_magic_quotes_gpc()) { + // $emailAddress = stripslashes($emailAddress); + //} + + // Control characters are not allowed + if (preg_match('/[\x00-\x1F\x7F-\xFF]/', $emailAddress)) { + return false; + } + + // Check email length - min 3 (a@a), max 256 + if (!self::checkTextLength($emailAddress, 3, 256)) { + return false; + } + + // Split it into sections using last instance of "@" + $atSymbol = strrpos($emailAddress, '@'); + if ($atSymbol === false) { + // No "@" symbol in email. + return false; + } + $emailAddressParts[0] = substr($emailAddress, 0, $atSymbol); + $emailAddressParts[1] = substr($emailAddress, $atSymbol + 1); + + // Count the "@" symbols. Only one is allowed, except where + // contained in quote marks in the local part. Quickest way to + // check this is to remove anything in quotes. We also remove + // characters escaped with backslash, and the backslash + // character. + $tempAddressParts[0] = preg_replace('/\./', '', $emailAddressParts[0]); + $tempAddressParts[0] = preg_replace('/"[^"]+"/', '', $tempAddressParts[0]); + $tempAddressParts[1] = $emailAddressParts[1]; + $tempAddress = $tempAddressParts[0] . $tempAddressParts[1]; + // Then check - should be no "@" symbols. + if (strrpos($tempAddress, '@') !== false) { + // "@" symbol found + return false; + } + + // Check local portion + if (!self::checkLocalPortion($emailAddressParts[0])) { + return false; + } + + // Check domain portion + if (!self::checkDomainPortion($emailAddressParts[1], $allowLocal)) { + return false; + } + + // If we're still here, all checks above passed. Email is valid. + return true; + } + + /** + * Checks email section before "@" symbol for validity + * @param string $localPortion Text to be checked + * @return bool Whether local portion is valid + */ + public static function checkLocalPortion($localPortion) + { + // Local portion can only be from 1 to 64 characters, inclusive. + // Please note that servers are encouraged to accept longer local + // parts than 64 characters. + if (!self::checkTextLength($localPortion, 1, 64)) { + return false; + } + // Local portion must be: + // 1) a dot-atom (strings separated by periods) + // 2) a quoted string + // 3) an obsolete format string (combination of the above) + $localPortionParts = explode('.', $localPortion); + for ($i = 0, $max = sizeof($localPortionParts); $i < $max; $i++) { + if (!preg_match('.^(' + . '([A-Za-z0-9!#$%&\'*+/=?^_`{|}~-]' + . '[A-Za-z0-9!#$%&\'*+/=?^_`{|}~-]{0,63})' + .'|' + . '("[^\\\"]{0,62}")' + .')$.' + ,$localPortionParts[$i])) { + return false; + } + } + return true; + } + + /** + * Checks email section after "@" symbol for validity + * @param string $domainPortion Text to be checked + * @param bool $allowLocal allow local domains? + * @return bool Whether domain portion is valid + */ + public static function checkDomainPortion($domainPortion, $allowLocal = false) + { + // Total domain can only be from 1 to 255 characters, inclusive + if (!self::checkTextLength($domainPortion, 1, 255)) { + return false; + } + + // some IPv4/v6 regexps borrowed from Feyd + // see: http://forums.devnetwork.net/viewtopic.php?f=38&t=53479 + $dec_octet = '(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|[0-9])'; + $hex_digit = '[A-Fa-f0-9]'; + $h16 = "{$hex_digit}{1,4}"; + $IPv4Address = "$dec_octet\\.$dec_octet\\.$dec_octet\\.$dec_octet"; + $ls32 = "(?:$h16:$h16|$IPv4Address)"; + $IPv6Address = + "(?:(?:{$IPv4Address})|(?:" . + "(?:$h16:){6}$ls32" . + "|::(?:$h16:){5}$ls32" . + "|(?:$h16)?::(?:$h16:){4}$ls32" . + "|(?:(?:$h16:){0,1}$h16)?::(?:$h16:){3}$ls32" . + "|(?:(?:$h16:){0,2}$h16)?::(?:$h16:){2}$ls32" . + "|(?:(?:$h16:){0,3}$h16)?::(?:$h16:){1}$ls32" . + "|(?:(?:$h16:){0,4}$h16)?::$ls32" . + "|(?:(?:$h16:){0,5}$h16)?::$h16" . + "|(?:(?:$h16:){0,6}$h16)?::" . + ")(?:\\/(?:12[0-8]|1[0-1][0-9]|[1-9][0-9]|[0-9]))?)"; + + if (preg_match("/^($IPv4Address|\\[$IPv4Address\\]|\\[$IPv6Address\\])$/", + $domainPortion)){ + return true; + } else { + $domainPortionParts = explode('.', $domainPortion); + if (!$allowLocal && sizeof($domainPortionParts) < 2) { + return false; // Not enough parts to domain + } + for ($i = 0, $max = sizeof($domainPortionParts); $i < $max; $i++) { + // Each portion must be between 1 and 63 characters, inclusive + if (!self::checkTextLength($domainPortionParts[$i], 1, 63)) { + return false; + } + if (!preg_match('/^(([A-Za-z0-9][A-Za-z0-9-]{0,61}[A-Za-z0-9])|' + .'([A-Za-z0-9]+))$/', $domainPortionParts[$i])) { + return false; + } + if ($i == $max - 1) { // TLD cannot be only numbers + if (strlen(preg_replace('/[0-9]/', '', $domainPortionParts[$i])) <= 0) { + return false; + } + } + } + } + return true; + } + + /** + * Check given text length is between defined bounds + * @param string $text Text to be checked + * @param int $minimum Minimum acceptable length + * @param int $maximum Maximum acceptable length + * @return bool Whether string is within bounds (inclusive) + */ + protected static function checkTextLength($text, $minimum, $maximum) + { + // Minimum and maximum are both inclusive + $textLength = strlen($text); + return ($textLength >= $minimum && $textLength <= $maximum); + } +} diff --git a/platform/www/vendor/aziraphale/email-address-validator/README.md b/platform/www/vendor/aziraphale/email-address-validator/README.md new file mode 100644 index 0000000..60bff60 --- /dev/null +++ b/platform/www/vendor/aziraphale/email-address-validator/README.md @@ -0,0 +1,59 @@ +Email-Address-Validator +======================= + +This is a fork of [AddedBytes' EmailAddressValidator class](https://code.google.com/p/php-email-address-validation/). + +## Changes ## +Changes include: + +- [Composer](https://getcomposer.org/) support +- Refactored the class to be purely static +- Opened up methods for checking the "local part" (the bit before the `@`) and the "domain part" (after the `@`) +to be public methods +- Additional code style and docblock fixing to properly follow the [PHP-FIG PSR-1](http://www.php-fig.org/psr/psr-1/) +and [PSR-2](http://www.php-fig.org/psr/psr-2/) documents + +Note that this class is still **un-namespaced** - i.e. it's still declared in the global namespace. The `composer.json` +file is still set up to correctly load it when required, so this shouldn't be a problem in practice - it's just perhaps +not best-practice. + +## Installation ## +Use [Composer](https://getcomposer.org/): +``` +php composer.phar require aziraphale/email-address-validator:^2 +``` + +If you don't want to use Composer (why not?!), just download the `EmailAddressValidator.php` file, save it with your project, and `require` it where needed. + +Note that this updated version is **version 2.0.0**. I have kept the original class tagged as **version 1.0.10** (it was the 10th commit to the Google Code svn repository). If you want to use Composer to install the **old** class, simply specify `^1` as the version constraint (which will allow for backwards-compatible changes to be installed, if any get made, while never jumping to my modified class without your direct action): +``` +php composer.phar require aziraphale/email-address-validator:^1 +``` + +## Usage ## +Due to the aforementioned changes, the way of using this class has completely changed. However it has such a small and simple interface that these changes shouldn't be problematic. + +As a recap, the **old usage** was like this: +```php +$validator = new EmailAddressValidator; +if ($validator->check_email_address('test@example.org')) { + // Email address is technically valid +} +``` + +The **new syntax** is as follows (ensure you have already included Composer's `autoload.php` file!): +```php +if (EmailAddressValidator::checkEmailAddress("test@example.org")) { + // Email address is technically valid +} +``` + +with a couple of additional methods in case they're helpful: +```php +if (EmailAddressValidator::checkLocalPortion("test")) { + // "test" is technically a valid string to have before the "@" in an email address +} +if (EmailAddressValidator::checkDomainPotion("example.org")) { + // "example.org" is technically a valid email address host +} +``` |