Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Codacy Badge Codacy Badge Latest version Downloads total License

Validate and check for disposable/temporary/throw away emails.


Require this package with Composer in the root directory of your project.

composer require enricodias/email-validator

Basic Usage

$emailValidator = new \enricodias\EmailValidator\EmailValidator();

$emailValidator->isValid();      // false, doesn't have valid MX entries
$emailValidator->isDisposable(); // false, isn't a known domain for disposable emails
$emailValidator->isAlias();      // true, is alias for
$emailValidator->didYouMean();   //

Service Providers

A service provider is a third party service that validates the email, usually using an API. You may register several providers to be used on the validation.

The registered providers will be used in sequence until one of them returns a valid response. This is especially useful if you want a provider to act as a failover. is enabled by default.

$MailboxLayer = new \enricodias\EmailValidator\ServiceProviders\MailboxLayer('API_KEY');

$Mailgun = new \enricodias\EmailValidator\ServiceProviders\Mailgun('API_KEY');

$emailValidator->addProvider($MailboxLayer, 'MailboxLayer');
$emailValidator->addProvider($Mailgun); // the name is optional


Implemented providers

Provider Free Tier Cost per validation Unsupported Features 120 verifications per hour Free isHighRisk()
MailboxLayer 250 verifications per month $0.002 to $0.0006
NeverBounce 1000 verifications $0.008 to $0.003 isHighRisk()
Kickbox 100 verifications $0.010 to $0.004
Mailgun 0 $0.012 to $0.0025 didYouMean()**

* is now called ** the feature is documented but as for now, the API never returns a suggestion.

Custom providers

You can add a custom provider by implementing the class ServiceProviderInterface. It's possible to remove the default provider using removeProvider() method or remove all all providers using clearProviders() method:

$emailValidator = new \enricodias\EmailValidator\EmailValidator();

$emailValidator->clearProviders(); // remove all providers

$emailValidator->addProvider($CustomServiceProvider, 'My Custom Provider');


You can use the static method create() to create an instance and chain methods:

$emailValidator = \enricodias\EmailValidator\EmailValidator::create()

Note that providers registered without a name cannot be removed by removeProvider().

Shuffle providers

Shuffling the service providers list is useful when using the free tier of multiple providers. Without shuffling, the providers will always be used in the same order resulting in unnecessary failures when the first provider runs out of credits.


How it works

The class checks locally if the email syntax is valid and if so, it calls a service provider.

Rate limit

Since most service providers are either paid or have a limit of requests per hour per ip, no request is made if the email doesn't pass on the local validation checks.

Local domain list

To lower the number of API requests the local checks include a list with the most common disposable domains. This list is intended to be short in order to not affect performance and avoid the need of constants updates. Wildcards * are allowed.

Additional Domains

It's likely that the most popular disposable email services among your users are not on the default list, so you may want to customize the list using the addDomains() method:

$emailValidator = \enricodias\EmailValidator\EmailValidator::create()

$emailValidator->isDisposable(); // true

This method doesn't accepts a string, only an array.

Validation methods


Returns true if the email is valid.

The email is considered invalid if it fails on the local syntax check OR if it fails in the service provider's check. Note that disposable emails are valid emails.


Returns true if the email is a disposable email.


Returns true if the email is an alias. Example: is an alias of


If the email has a simple and obvious typo such as instead of this method will return a string with a suggested correction, otherwise it will return an empty string.

It's recommended to use this feature using javascript in the client side with an option for them to correct the email before submitting the form


Most service providers have a risk analysis tool. This method returns true if the risk is high.


Validate and check for disposable/temporary/throw away emails



Code of conduct





No packages published