#EmailValidator

A library for validating emails against several RFC.

#Supported RFCs

This library aims to support RFCs:

• 5321,
• 5322,
• 6530,
• 6531,
• 6532,
• 1035

#Supported versions

#Requirements

• PHP 8.1
• Composer is required for installation
• Spoofchecking and DNSCheckValidation validation requires that your PHP system has the PHP Internationalization Libraries (also known as PHP Intl)

Note: PHP version upgrades will happen to accomodate to the pace of major frameworks. Minor versions bumps will go via minor versions of this library (i.e: PHP7.3 -> v3.x+1). Major versions will go with major versions of the library

#Installation

Run the command below to install via Composer

composer require egulias/email-validator

#Getting Started

EmailValidator requires you to decide which (or combination of them) validation/s strategy/ies you'd like to follow for each validation.

A basic example with the RFC validation

<?php

use Egulias\EmailValidator\EmailValidator;
use Egulias\EmailValidator\Validation\RFCValidation;

$validator = new EmailValidator();
$validator->isValid("example@example.com", new RFCValidation()); //true

#Available validations

1. RFCValidation: Standard RFC-like email validation.
2. NoRFCWarningsValidation: RFC-like validation that will fail when warnings* are found.
3. DNSCheckValidation: Will check if there are DNS records that signal that the server accepts emails. This does not entail that the email exists.
4. MultipleValidationWithAnd: It is a validation that operates over other validations performing a logical and (&&) over the result of each validation.
5. MessageIDValidation: Follows RFC2822 for message-id to validate that field, that has some differences in the domain part.
6. Your own validation: You can extend the library behaviour by implementing your own validations.

*warnings: Warnings are deviations from the RFC that in a broader interpretation are accepted.

<?php

use Egulias\EmailValidator\EmailValidator;
use Egulias\EmailValidator\Validation\DNSCheckValidation;
use Egulias\EmailValidator\Validation\MultipleValidationWithAnd;
use Egulias\EmailValidator\Validation\RFCValidation;

$validator = new EmailValidator();
$multipleValidations = new MultipleValidationWithAnd([
    new RFCValidation(),
    new DNSCheckValidation()
]);
//ietf.org has MX records signaling a server with email capabilities
$validator->isValid("example@ietf.org", $multipleValidations); //true

#Additional validations

Validations not present in the RFCs

1. SpoofCheckValidation: Will check for multi-utf-8 chars that can signal an erroneous email name.

#How to extend

It's easy! You just need to implement EmailValidation and you can use your own validation.

#Contributing

Please follow the Contribution guide. Is short and simple and will help a lot.

#Other Contributors

(You can find current contributors here)

As this is a port from another library and work, here are other people related to the previous one:

• Ricard Clau @ricardclau: Performance against PHP built-in filter_var (v2 and earlier)
• Josepf Bielawski @stloyd: For its first re-work of Dominic's lib
• Dominic Sayers @dominicsayers: The original isemail function

#License

Released under the MIT License attached with this code.