Initial commit

content/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);
+    }
+}

content/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
+}
+```