Disposable Email Checker
, (*1)
What is it?
Disposable Email Checker is a library that allows applications to check for
users signup with disposable email addresses. This is very important for
services that provide some trial period based on the email address. Hence,
if users use disposable addresses, then they can potentially bypass the time
limit. Other applications may use it to make sure that they have valid emails
that they can use for future correspondence., (*2)
The library currently contains > 1,900 domains and growing., (*3)
Goals
This project started with offering a php library, but in v2, it has been refactored
to separate the domain lists from the code. This enables the following scenarios:, (*4)
- Providing implementations in multiple languages that consumes such data files.
- Enable apps to easily embed these data files and consume them directly.
- Simplify the process of updating the list to add more domains.
How Disposable Addresses are detected?
This library has a list of rules that are used to determine whether an address
is disposable or not. The library does not connect to the Internet to determine
the kind or the validity of the address. The library may be enhanced in the
future to provide applications with ways of explicitly requiring online checks., (*5)
Contributing
This library is available as open source with MIT license, so you can use it
in both open source and commercial applications. The best ways to contribute
back to this library are:, (*6)
- Report service providers that the library should detect but it doesn't. See section below for validating disposeable domains.
- Report bugs and feature request in the bug tracker.
- Provide ports for the library in languages other than PHP.
To report bugs and feature requests use the associated github bug tracker., (*7)
Validating Disposable Domains
Before submitting a PR with new disposable email domains, please validate
that such domain are really disposable via the Kickbox service., (*8)
In the following URL replace {domain} with your domain (e.g. example.com) and make sure
it returns disposable: true., (*9)
https://open.kickbox.com/v1/disposable/{domain}
Running Unit Tests
Here is how to run the unit tests:, (*10)
composer install
vendor/phpunit/phpunit/phpunit php/tests/disposable_email_checker_tests.php
Versioning Scheme
The versioning for this library is formatted as follows "1.2.3"., (*11)
(1) This is the major version which will change when there are major changes
or re-implementation., (*12)
(2) This is the minor version which will change when the APIs changes.
Most of the time these won't be breaking changes, but sometimes they
may be., (*13)
(3) This is the data version which is the only one changed in releases that
just update the rules that are used to determine that an email address
is disposable., (*14)
Credits
Wallogit.com
