PHPackages                             auvernhat/easyemailvalidator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. auvernhat/easyemailvalidator

ActiveLibrary[Validation & Sanitization](/categories/validation)

auvernhat/easyemailvalidator
============================

A lightweight PHP package to validate email addresses against allowed and denied domain lists.

1.1.0(9mo ago)213MITPHPCI passing

Since Aug 11Pushed 9mo agoCompare

[ Source](https://github.com/auvernhatinternet/EasyEmailValidator)[ Packagist](https://packagist.org/packages/auvernhat/easyemailvalidator)[ RSS](/packages/auvernhat-easyemailvalidator/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (5)Dependencies (3)Versions (6)Used By (0)

EasyEmailValidator
==================

[](#easyemailvalidator)

A lightweight PHP package to validate email addresses against allowed and denied domain lists.

Installation
------------

[](#installation)

Add the package to your project with Composer:

```
composer require auvernhat/easyemailvalidator
```

Usage
-----

[](#usage)

```
use Auvernhat\EasyEmailValidator\EasyValidator;

$validator = new EasyValidator();

// Validate a single email address
$isValid = $validator->validate('test@gmail.com'); // true or false

// Validate multiple email addresses
$allValid = $validator->validateMultiple([
    'test@gmail.com',
    'test@outlook.com'
]); // true if all are valid, false otherwise
```

Providers
---------

[](#providers)

EasyEmailValidator supports multiple providers to fetch lists of allowed or denied email domains.
A **provider** is a PHP class that extends the abstract class `ProviderAbstract` and implements two methods:

- `getAllowDomains(): array` — returns an array of allowed domains (can be empty if not used).
- `getDenyDomains(): array` — returns an array of denied domains.

### Available Providers

[](#available-providers)

Several providers are included by default:

- **AmieiroProvider**
    Uses the public lists from [amieiro/disposable-email-domains](https://github.com/amieiro/disposable-email-domains).
- **AdamLovingProvider**
    Uses the list from [Adam Loving's gist](https://gist.github.com/adamloving/4401361).
- **DisposableProvider**
    Uses the list from [disposable/disposable-email-domains](https://github.com/disposable/disposable-email-domains).

### How to Use a Provider

[](#how-to-use-a-provider)

You can specify the provider to use when creating the validator:

```
use Auvernhat\EasyEmailValidator\EasyValidator;
use Auvernhat\EasyEmailValidator\Providers\AdamLovingProvider;

$validator = new EasyValidator(new AdamLovingProvider());
$isValid = $validator->validate('test@gmail.com');
```

If you don't specify a provider, the default is `DisposableProvider`:

```
$validator = new EasyValidator(); // Uses DisposableProvider by default
```

### How to Create Your Own Provider

[](#how-to-create-your-own-provider)

To add your own provider, create a new class in `src/Providers/` that extends `ProviderAbstract` and implements the required methods:

```
use Auvernhat\EasyEmailValidator\Providers\ProviderAbstract;

class MyCustomProvider extends ProviderAbstract
{
    public function getAllowDomains(): array
    {
        // Return your list of allowed domains
        return ['example.com'];
        // Return nothing if you only want a deny list
        return [];
    }

    public function getDenyDomains(): array
    {
        // Return your list of denied domains
        return ['tempmail.com', 'mailinator.com'];
        // Return nothing if you only want an allow list
        return [];
    }
}
```

Example: Allow Only Your Company's Emails
-----------------------------------------

[](#example-allow-only-your-companys-emails)

You can create a custom provider that only allows emails from your own company domain. For example, to only accept `@mycompany.com` addresses:

```
use Auvernhat\EasyEmailValidator\Providers\ProviderAbstract;

class MyCustomProvider extends ProviderAbstract
{
    public function getAllowDomains(): array
    {
        return ['mycompany.com'];
    }

    public function getDenyDomains(): array
    {
        return [];
    }
}

$validator = new EasyValidator(new MyCustomProvider);

$res = $validator->validate("test@gmail.com");
// returns false
$res = $validator->validate("test@mycompany.com");
// returns true
```

This is useful if you want to restrict access or registration to your own organization only.

Simple, fast, and effective for filtering disposable emails!

###  Health Score

30

—

LowBetter than 61% of packages

Maintenance58

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~25 days

Total

5

Last Release

272d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e2acb927ea6a247ccf0be4f2b2cd17704a31502f88c210587546b17235fc4e92?d=identicon)[rrr63](/maintainers/rrr63)

---

Top Contributors

[![rrr63](https://avatars.githubusercontent.com/u/46089601?v=4)](https://github.com/rrr63 "rrr63 (10 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/auvernhat-easyemailvalidator/health.svg)

```
[![Health](https://phpackages.com/badges/auvernhat-easyemailvalidator/health.svg)](https://phpackages.com/packages/auvernhat-easyemailvalidator)
```

###  Alternatives

[toplan/laravel-sms

A mobile phone number validation solution based on laravel

83580.2k2](/packages/toplan-laravel-sms)[drupal/coder

Coder is a library to review Drupal code.

3046.8M629](/packages/drupal-coder)[ph-7/eu-vat-validator

A simple and clean PHP class that validates EU VAT numbers against the central ec.europa.eu database (using the official europa API).

97510.7k1](/packages/ph-7-eu-vat-validator)[hyperf/validation

hyperf validation

122.2M213](/packages/hyperf-validation)[udokmeci/yii2-phone-validator

Modern Yii2 Phone validator wrapper on top of PhoneNumberUtil library also used by Android devices

36227.5k1](/packages/udokmeci-yii2-phone-validator)[snowcap/vat-validation

EU VAT number validation

10112.3k](/packages/snowcap-vat-validation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)