KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

disposable-emails-filter-php

★ 44 Open GitHub ↗

A PHP package for determining whether an email address is from a disposable / temporary email address provider.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](https://raw.githubusercontent.com/elliotjreed/disposable-emails-filter-php/master/code_of_conduct.md)

# Disposable / Temporary Email Address Filter

This package provides a method for determining whether an email address is a disposable / temporary email address.

All credit to the maintaining of the list of disposable / temporary email addresses goes to [github.com/disposable-email-domains/disposable-email-domains](https://github.com/disposable-email-domains/disposable-email-domains).

This project and it's maintainer(s) do not discourage the use of such disposable / temporary email addresses, but simply allows for the detection of such.

## Installation

PHP 8.4 or above is required.

Older versions of PHP are supported via old releases, however they will not receive updates from the upstream disposable email domain list. If PHP 8.3 or 8.2 is required, please use version 5. If PHP 8.1 is required please use version 4. If PHP 7.4 to 8.0 is required please use version 3.

To install via [Composer](https://getcomposer.org/download/):

```bash
composer require elliotjreed/disposable-emails-filter
```

## Usage

### Check if the email address is in the temporary domain list

The checker / filter can either be used via a static or non-static means:

```php
<?php

require 'vendor/autoload.php';

use ElliotJReed\DisposableEmail\Email;

if ((new Email())->isDisposable('email@temporarymailaddress.com')) {
    echo 'This is a disposable / temporary email address';
}
```

```php
<?php

require 'vendor/autoload.php';

use ElliotJReed\DisposableEmail\DisposableEmail;

if (DisposableEmail::isDisposable('email@temporarymailaddress.com')) {
    echo 'This is a disposable / temporary email address';
}
```

### List all domains in the temporary email domain list

The lister can either be used via a static or non-static means:

```php
<?php

require 'vendor/autoload.php';

use ElliotJReed\DisposableEmail\Email;

foreach ((new Email())->getDomainList() as $domain) {
    echo $domain . PHP_EOL;
}
```

```php
<?php

require 'vendor/autoload.php';

use ElliotJReed\DisposableEmail\DisposableEmail;

foreach (DisposableEmail::getDomainList() as $domain) {
    echo $domain . PHP_EOL;
}
```

If an invalid [email address](https://www.ietf.org/rfc/rfc0822.txt) is provided then an `InvalidEmailException` is thrown, so it is advisable to check that the email address is valid first. For example:

```php
<?php

require 'vendor/autoload.php';

use ElliotJReed\DisposableEmail\Email;

$email = 'not-a-real-email-address#example.net';

if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
    if ((new Email())->isDisposable($email)) {
        echo 'This is a disposable / temporary email address';
    }
} else {
    echo 'This is not a valid email address';
}
```

Would output:

```bash
This is not a valid email address
```

You can also provide your own custom domain list in a new line separated plain-text file, for example:

```text
example.com
example.net
```

Then passing the file location into the constructor:

```php
<?php

require 'vendor/autoload.php';

use ElliotJReed\DisposableEmail\Email;

new Email('/path/to/custom/list.txt');
```

If an invalid list is provided then an `InvalidDomainListException` is thrown.

###

## Getting Started with this Repository

PHP 8.2 or above and Composer is expected to be installed on our system.

### Installing Composer

For instructions on how to install Composer visit [getcomposer.org](https://getcomposer.org/download/).

### Installing the Package

```bash
composer require elliotjreed/disposable-emails-filter
```

### Installing for Development

After cloning this repository, change into the newly created directory and run

```bash
composer install
```

or if you have installed Composer locally

```bash
php composer.phar install
```

This will install all dependencies needed for the project.

## Running the Tests

All tests can be run by executing

```bash
composer run-script test
```

`phpunit` will automatically find all tests inside the `test` directory and run them based on the configuration in the `phpunit.xml` file.

## Built With

- [github.com/disposable-email-domains/disposable-email-domains](https://github.com/disposable-email-domains/disposable-email-domains)
  - [PHP](https://secure.php.net/)
  - [Composer](https://getcomposer.org/)
  - [PHPUnit](https://phpunit.de/)

## License

This project is licensed under the MIT License - see the [LICENCE](LICENCE) file for details.

disposable-emails-filter-php

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README