mirror of
https://github.com/egulias/EmailValidator.git
synced 2026-08-31 04:28:57 +00:00
Compare commits
13 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 0dbf5d7845 | |||
| 0878374ab8 | |||
| 0c26e9dece | |||
| ca90a3291e | |||
| d04083e28b | |||
| db476db25e | |||
| d37d5a361e | |||
| 5fa792ad18 | |||
| 68e418ec08 | |||
| ef615f1d74 | |||
| 563d0cdde5 | |||
| c7ab280976 | |||
| f46887bc48 |
@@ -0,0 +1,3 @@
|
||||
# Thanks!
|
||||
|
||||
github: [egulias]
|
||||
@@ -1,4 +1,6 @@
|
||||
.phpunit.result.cache
|
||||
.idea
|
||||
.vscode
|
||||
composer.lock
|
||||
report/
|
||||
vendor/
|
||||
|
||||
+25
-2
@@ -1,5 +1,4 @@
|
||||
language: php
|
||||
|
||||
matrix:
|
||||
include:
|
||||
- php: 5.5.9
|
||||
@@ -28,10 +27,33 @@ matrix:
|
||||
env:
|
||||
- psalm=yes
|
||||
dist: bionic
|
||||
#ppc64le support code
|
||||
- php: 5.6
|
||||
arch: ppc64le
|
||||
env:
|
||||
dist: xenial
|
||||
- php: 7.0
|
||||
arch: ppc64le
|
||||
dist: xenial
|
||||
- php: 7.1
|
||||
arch: ppc64le
|
||||
env:
|
||||
- psalm=yes
|
||||
dist: bionic
|
||||
- php: 7.2
|
||||
arch: ppc64le
|
||||
env:
|
||||
- psalm=yes
|
||||
dist: bionic
|
||||
- php: 7.4
|
||||
arch: ppc64le
|
||||
env:
|
||||
- psalm=yes
|
||||
dist: bionic
|
||||
|
||||
install:
|
||||
- if [ "$deps" = "low" ]; then composer update --prefer-lowest; else composer install; fi
|
||||
- if [ "$psalm" = "yes" ]; then composer require --dev vimeo/psalm; fi
|
||||
- if [ "$psalm" = "yes" ]; then composer require --dev vimeo/psalm:3.18.2; fi
|
||||
|
||||
before_script:
|
||||
- mkdir -p build/logs
|
||||
@@ -42,3 +64,4 @@ script:
|
||||
|
||||
after_script:
|
||||
- php vendor/bin/coveralls
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
[](https://scrutinizer-ci.com/g/egulias/EmailValidator/?branch=master)
|
||||
[](https://insight.sensiolabs.com/projects/22ba6692-9c02-42e5-a65d-1c5696bfffc6)
|
||||
|
||||
## Suported RFCs ##
|
||||
## Supported RFCs ##
|
||||
|
||||
This library aims to support:
|
||||
|
||||
@@ -42,16 +42,14 @@ $validator->isValid("example@example.com", new RFCValidation()); //true
|
||||
|
||||
### Available validations ###
|
||||
|
||||
1. [RFCValidation](/src/Validation/RFCValidation.php)
|
||||
2. [NoRFCWarningsValidation](/src/Validation/NoRFCWarningsValidation.php)
|
||||
3. [DNSCheckValidation](/src/Validation/DNSCheckValidation.php)
|
||||
4. [SpoofCheckValidation](/src/Validation/SpoofCheckValidation.php)
|
||||
5. [MultipleValidationWithAnd](/src/Validation/MultipleValidationWithAnd.php)
|
||||
6. [Your own validation](#how-to-extend)
|
||||
1. [RFCValidation](/src/Validation/RFCValidation.php): Standard RFC-like email validation.
|
||||
2. [NoRFCWarningsValidation](/src/Validation/NoRFCWarningsValidation.php): RFC-like validation that will fail when warnings* are found.
|
||||
3. [DNSCheckValidation](/src/Validation/DNSCheckValidation.php): Will check if there are DNS records that signal that the server accepts emails. This does not entails that the email exists.
|
||||
4. [SpoofCheckValidation](/src/Validation/SpoofCheckValidation.php): Will check for multi-utf-8 chars that can signal an erroneous email name.
|
||||
5. [MultipleValidationWithAnd](/src/Validation/MultipleValidationWithAnd.php): It is a validation that operates over other validations performing a logical and (&&) over the result of each validation.
|
||||
6. [Your own validation](#how-to-extend): You can extend the library behaviour by implementing your own validations.
|
||||
|
||||
`MultipleValidationWithAnd`
|
||||
|
||||
It is a validation that operates over other validations performing a logical and (&&) over the result of each validation.
|
||||
*warnings: Warnings are deviations from the RFC that in a broader interpretation are acceptded.
|
||||
|
||||
```php
|
||||
<?php
|
||||
@@ -66,7 +64,8 @@ $multipleValidations = new MultipleValidationWithAnd([
|
||||
new RFCValidation(),
|
||||
new DNSCheckValidation()
|
||||
]);
|
||||
$validator->isValid("example@example.com", $multipleValidations); //true
|
||||
//ietf.org has MX records signaling a server with email capabilites
|
||||
$validator->isValid("example@ietf.org", $multipleValidations); //true
|
||||
```
|
||||
|
||||
### How to extend ###
|
||||
|
||||
@@ -13,6 +13,8 @@ class EmailLexer extends AbstractLexer
|
||||
const S_BACKSLASH = 92;
|
||||
const S_DOT = 46;
|
||||
const S_DQUOTE = 34;
|
||||
const S_SQUOTE = 39;
|
||||
const S_BACKTICK = 96;
|
||||
const S_OPENPARENTHESIS = 49;
|
||||
const S_CLOSEPARENTHESIS = 261;
|
||||
const S_OPENBRACKET = 262;
|
||||
@@ -58,6 +60,8 @@ class EmailLexer extends AbstractLexer
|
||||
'/' => self::S_SLASH,
|
||||
',' => self::S_COMMA,
|
||||
'.' => self::S_DOT,
|
||||
"'" => self::S_SQUOTE,
|
||||
"`" => self::S_BACKTICK,
|
||||
'"' => self::S_DQUOTE,
|
||||
'-' => self::S_HYPHEN,
|
||||
'::' => self::S_DOUBLECOLON,
|
||||
|
||||
@@ -5,5 +5,5 @@ namespace Egulias\EmailValidator\Exception;
|
||||
class UnclosedComment extends InvalidEmail
|
||||
{
|
||||
const CODE = 146;
|
||||
const REASON = "No colosing comment token found";
|
||||
const REASON = "No closing comment token found";
|
||||
}
|
||||
|
||||
@@ -35,6 +35,7 @@ use Egulias\EmailValidator\Warning\TLD;
|
||||
class DomainPart extends Parser
|
||||
{
|
||||
const DOMAIN_MAX_LENGTH = 254;
|
||||
const LABEL_MAX_LENGTH = 63;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
@@ -160,6 +161,7 @@ class DomainPart extends Parser
|
||||
protected function doParseDomainPart()
|
||||
{
|
||||
$domain = '';
|
||||
$label = '';
|
||||
$openedParenthesis = 0;
|
||||
do {
|
||||
$prev = $this->lexer->getPrevious();
|
||||
@@ -190,7 +192,12 @@ class DomainPart extends Parser
|
||||
$this->parseDomainLiteral();
|
||||
}
|
||||
|
||||
$this->checkLabelLength($prev);
|
||||
if ($this->lexer->token['type'] === EmailLexer::S_DOT) {
|
||||
$this->checkLabelLength($label);
|
||||
$label = '';
|
||||
} else {
|
||||
$label .= $this->lexer->token['value'];
|
||||
}
|
||||
|
||||
if ($this->isFWS()) {
|
||||
$this->parseFWS();
|
||||
@@ -198,8 +205,13 @@ class DomainPart extends Parser
|
||||
|
||||
$domain .= $this->lexer->token['value'];
|
||||
$this->lexer->moveNext();
|
||||
if ($this->lexer->token['type'] === EmailLexer::S_SP) {
|
||||
throw new CharNotAllowed();
|
||||
}
|
||||
} while (null !== $this->lexer->token['type']);
|
||||
|
||||
$this->checkLabelLength($label);
|
||||
|
||||
return $domain;
|
||||
}
|
||||
|
||||
@@ -332,6 +344,8 @@ class DomainPart extends Parser
|
||||
{
|
||||
$invalidDomainTokens = array(
|
||||
EmailLexer::S_DQUOTE => true,
|
||||
EmailLexer::S_SQUOTE => true,
|
||||
EmailLexer::S_BACKTICK => true,
|
||||
EmailLexer::S_SEMICOLON => true,
|
||||
EmailLexer::S_GREATERTHAN => true,
|
||||
EmailLexer::S_LOWERTHAN => true,
|
||||
@@ -381,16 +395,31 @@ class DomainPart extends Parser
|
||||
return true;
|
||||
}
|
||||
|
||||
protected function checkLabelLength(array $prev)
|
||||
/**
|
||||
* @param string $label
|
||||
*/
|
||||
protected function checkLabelLength($label)
|
||||
{
|
||||
if ($this->lexer->token['type'] === EmailLexer::S_DOT &&
|
||||
$prev['type'] === EmailLexer::GENERIC &&
|
||||
strlen($prev['value']) > 63
|
||||
) {
|
||||
if ($this->isLabelTooLong($label)) {
|
||||
$this->warnings[LabelTooLong::CODE] = new LabelTooLong();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $label
|
||||
* @return bool
|
||||
*/
|
||||
private function isLabelTooLong($label)
|
||||
{
|
||||
if (preg_match('/[^\x00-\x7F]/', $label)) {
|
||||
idn_to_ascii($label, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46, $idnaInfo);
|
||||
|
||||
return (bool) ($idnaInfo['errors'] & IDNA_ERROR_LABEL_TOO_LONG);
|
||||
}
|
||||
|
||||
return strlen($label) > self::LABEL_MAX_LENGTH;
|
||||
}
|
||||
|
||||
protected function parseDomainComments()
|
||||
{
|
||||
$this->isUnclosedComment();
|
||||
|
||||
@@ -97,10 +97,7 @@ class DNSCheckValidation implements EmailValidation
|
||||
*/
|
||||
protected function checkDns($host)
|
||||
{
|
||||
$variant = INTL_IDNA_VARIANT_2003;
|
||||
if (defined('INTL_IDNA_VARIANT_UTS46')) {
|
||||
$variant = INTL_IDNA_VARIANT_UTS46;
|
||||
}
|
||||
$variant = INTL_IDNA_VARIANT_UTS46;
|
||||
|
||||
$host = rtrim(idn_to_ascii($host, IDNA_DEFAULT, $variant), '.') . '.';
|
||||
|
||||
@@ -118,7 +115,8 @@ class DNSCheckValidation implements EmailValidation
|
||||
private function validateDnsRecords($host)
|
||||
{
|
||||
// Get all MX, A and AAAA DNS records for host
|
||||
$dnsRecords = dns_get_record($host, DNS_MX + DNS_A + DNS_AAAA);
|
||||
// Using @ as workaround to fix https://bugs.php.net/bug.php?id=73149
|
||||
$dnsRecords = @dns_get_record($host, DNS_MX + DNS_A + DNS_AAAA);
|
||||
|
||||
|
||||
// No MX, A or AAAA DNS records
|
||||
|
||||
@@ -29,7 +29,7 @@ abstract class Warning
|
||||
*/
|
||||
public function code()
|
||||
{
|
||||
return self::CODE;
|
||||
return static::CODE;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -138,6 +138,8 @@ class EmailLexerTests extends TestCase
|
||||
array(":", EmailLexer::S_COLON),
|
||||
array(".", EmailLexer::S_DOT),
|
||||
array("\"", EmailLexer::S_DQUOTE),
|
||||
array("'", EmailLexer::S_SQUOTE),
|
||||
array("`", EmailLexer::S_BACKTICK),
|
||||
array("-", EmailLexer::S_HYPHEN),
|
||||
array("\\", EmailLexer::S_BACKSLASH),
|
||||
array("/", EmailLexer::S_SLASH),
|
||||
|
||||
@@ -27,7 +27,7 @@ class DNSCheckValidationTest extends TestCase
|
||||
['"Fred\ Bloggs"@ietf.org'],
|
||||
['"Joe.\\Blow"@ietf.org'],
|
||||
|
||||
// unicide
|
||||
// unicode
|
||||
['ñandu.cl'],
|
||||
];
|
||||
}
|
||||
@@ -106,4 +106,4 @@ class DNSCheckValidationTest extends TestCase
|
||||
$validation->isValid("example@invalid.example.com", new EmailLexer());
|
||||
$this->assertEquals($expectedError, $validation->getError());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -26,11 +26,22 @@ class NoRFCWarningsValidationTest extends TestCase
|
||||
$this->assertInstanceOf(RFCWarnings::class, $validation->getError());
|
||||
}
|
||||
|
||||
public function testEmailWithoutWarningsIsValid()
|
||||
/**
|
||||
* @dataProvider getValidEmailsWithoutWarnings
|
||||
*/
|
||||
public function testEmailWithoutWarningsIsValid($email)
|
||||
{
|
||||
$validation = new NoRFCWarningsValidation();
|
||||
|
||||
$this->assertTrue($validation->isValid('example@example.com', new EmailLexer()));
|
||||
$this->assertTrue($validation->isValid($email, new EmailLexer()));
|
||||
$this->assertNull($validation->getError());
|
||||
}
|
||||
|
||||
public function getValidEmailsWithoutWarnings()
|
||||
{
|
||||
return [
|
||||
['example@example.com',],
|
||||
[sprintf('example@%s.com', str_repeat('ъ', 40)),],
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
@@ -24,6 +24,7 @@ use Egulias\EmailValidator\Warning\CFWSWithFWS;
|
||||
use Egulias\EmailValidator\Warning\Comment;
|
||||
use Egulias\EmailValidator\Warning\DomainLiteral;
|
||||
use Egulias\EmailValidator\Warning\DomainTooLong;
|
||||
use Egulias\EmailValidator\Warning\EmailTooLong;
|
||||
use Egulias\EmailValidator\Warning\IPV6BadChar;
|
||||
use Egulias\EmailValidator\Warning\IPV6ColonEnd;
|
||||
use Egulias\EmailValidator\Warning\IPV6ColonStart;
|
||||
@@ -167,6 +168,9 @@ class RFCValidationTest extends TestCase
|
||||
['test@email<'],
|
||||
['test@email{'],
|
||||
['test@ '],
|
||||
['test@example.com []'],
|
||||
["test@example.com'"],
|
||||
["test@exam`ple.com"],
|
||||
];
|
||||
}
|
||||
|
||||
@@ -211,6 +215,7 @@ class RFCValidationTest extends TestCase
|
||||
[new CRNoLF(), "example@exa\rmple.co.uk"],
|
||||
[new CRNoLF(), "example@[\r]"],
|
||||
[new CRNoLF(), "exam\rple@example.co.uk"],
|
||||
[new ExpectingATEXT(), "test@example.com'"],
|
||||
];
|
||||
}
|
||||
|
||||
@@ -222,12 +227,12 @@ class RFCValidationTest extends TestCase
|
||||
$this->assertTrue($this->validator->isValid($email, $this->lexer));
|
||||
$warnings = $this->validator->getWarnings();
|
||||
$this->assertCount(
|
||||
count($warnings), $expectedWarnings,
|
||||
count($expectedWarnings), $warnings,
|
||||
"Expected: " . implode(",", $expectedWarnings) . " and got " . implode(",", $warnings)
|
||||
);
|
||||
|
||||
foreach ($warnings as $warning) {
|
||||
$this->assertArrayHasKey($warning->code(), $expectedWarnings);
|
||||
$this->assertContains($warning->code(), $expectedWarnings);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -274,17 +279,29 @@ class RFCValidationTest extends TestCase
|
||||
'example@toolonglocalparttoolonglocalparttoolonglocalparttoolonglocalpart.co.uk'
|
||||
],
|
||||
[
|
||||
[DomainTooLong::CODE, LabelTooLong::CODE,],
|
||||
[DomainTooLong::CODE, LabelTooLong::CODE, EmailTooLong::CODE],
|
||||
'example2@toolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocal'.
|
||||
'parttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalpart'.
|
||||
'toolonglocalparttoolonglocalparttoolonglocalparttoolonglocalpart'
|
||||
],
|
||||
[
|
||||
[DomainTooLong::CODE, LabelTooLong::CODE,],
|
||||
[DomainTooLong::CODE, LabelTooLong::CODE, EmailTooLong::CODE],
|
||||
'example@toolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocal'.
|
||||
'parttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalparttoolonglocalpart'.
|
||||
'toolonglocalparttoolonglocalparttoolonglocalparttoolonglocalpar'
|
||||
],
|
||||
[
|
||||
[LabelTooLong::CODE,],
|
||||
sprintf('example@%s.com', str_repeat('ъ', 60)),
|
||||
],
|
||||
[
|
||||
[LabelTooLong::CODE,],
|
||||
sprintf('example@%s.com', str_repeat('a4t', 22)),
|
||||
],
|
||||
[
|
||||
[LabelTooLong::CODE,],
|
||||
sprintf('example@%s', str_repeat('a4t', 22)),
|
||||
],
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user