Recommend this page to a friend! |
Download |
Info | Example | Files | Install with Composer | Download | Reputation | Support forum | Blog | Links |
Last Updated | Ratings | Unique User Downloads | Download Rankings | |||||
2024-04-20 (5 months ago) | Not enough user ratings | Total: 228 | All time: 8,178 This week: 47 |
Version | License | PHP version | Categories | |||
email-validator-pro 1.0.7 | The PHP License | 7 | Email, PHP 5, Validation |
Description | Author | |
This package can validate email addresses using multiple rules. |
What is the best PHP email verification class?
Bulk Verify Email Lists
<?php |
The PHP Email Validator will validate an email address for all or some of the following conditions:
The Email Validator is configurable, so you have full control over how much validation will occur.
Simply add a dependency on stymiee/email-validator
to your project's composer.json
file if you use
Composer to manage the dependencies of your project.
Here is a minimal example of a composer.json
file that just defines a dependency on PHP Simple Encryption:
{
"require": {
"stymiee/email-validator": "^1"
}
}
The Email Validator library builds upon PHP's built in filter_var($emailAddress, FILTER_VALIDATE_EMAIL);
by adding a
default MX record check. It also offers additional validation against disposable email addresses, free email address
providers, and a custom banned domain list.
If checkMxRecords
is set to true
in the configuration (see below) the domain name will be validated to ensure it
exists and has MX records configured. If the domain does not exist or no MX records exist the odds are the email address
is not in use.
Many users who are abusing a system, or not using that system as intended, can use a disposable email service who
provides a short-lived (approximately 10 minutes) email address to be used for registrations or user confirmations. If
checkDisposableEmail
is set to true
in the configuration (see below) the domain name will be validated to ensure
it is not associated with a disposable email address provider.
You can add you own domains to this list if you find the public list providers do not have one you
have identified in their lists. Examples are provided in the examples
directory which demonstrate how to do this.
Many users who are abusing a system, or not using that system as intended, can use a free email service who
provides a free email address which is immediately available to be used for registrations or user confirmations. If
checkFreeEmail
is set to true
in the configuration (see below) the domain name will be validated to ensure
it is not associated with a free email address provider.
You can add you own domains to this list if you find the public list providers do not have one you
have identified in their lists. Examples are provided in the examples
directory which demonstrate how to do this.
If you have users from a domain abusing your system, or you have business rules that require the blocking of certain
domains (i.e. public email providers like Gmail or Yahoo mail), you can block then by setting checkBannedListedEmail
to true
in the configuration (see below) and providing an array of banned domains. Examples are provided in the
examples
directory which demonstrate how to do this.
Gmail offers the ability to create unique email addresses within a Google account by adding a +
character and unique
identifier after the username portion of the email address. If not explicitly checked for a user can create an unlimited
amount of unique email addresses that all belong to the same account.
A special check can be performed when a Gmail account is used and a sanitized email address (e.g. one without the "plus trick") can be obtained and then checked for uniqueness in your system.
To configure the Email Validator you can pass an array with the follow parameters/values:
A boolean value that enables/disables MX record validation. Enabled by default.
A boolean value that enables/disables banned domain validation. Disabled by default.
A boolean value that enables/disables disposable email address validation. Disabled by default.
A boolean value that enables/disables free email address provider validation. Disabled by default.
A boolean value that when set to true
will not retrieve third party disposable email provider lists. Use this if you
cache the list of providers locally which is useful when performance matters. Disabled by default.
A boolean value that when set to true
will not retrieve third party free email provider lists. Use this if you
cache the list of providers locally which is useful when performance matters. Disabled by default.
An array of domains that are not allowed to be used for email addresses.
An array of domains that are suspected disposable email address providers.
An array of domains that are free email address providers.
Example
$config = [
'checkMxRecords' => true,
'checkBannedListedEmail' => true,
'checkDisposableEmail' => true,
'checkFreeEmail' => true,
'bannedList' => $bannedDomainList,
'disposableList' => $customDisposableEmailList,
'freeList' => $customFreeEmailList,
];
$emailValidator = new EmailValidator($config);
<?php
namespace EmailValidator;
require('../vendor/autoload.php');
$customDisposableEmailList = [
'example.com',
];
$bannedDomainList = [
'domain.com',
];
$customFreeEmailList = [
'example2.com',
];
$testEmailAddresses = [
'test@domain.com',
'test@johnconde.net',
'test@gmail.com',
'test@hotmail.com',
'test@outlook.com',
'test@yahoo.com',
'test@domain.com',
'test@mxfuel.com',
'test@example.com',
'test@example2.com',
'test@nobugmail.com',
'test@cellurl.com',
'test@10minutemail.com',
'test+example@gmail.com',
];
$config = [
'checkMxRecords' => true,
'checkBannedListedEmail' => true,
'checkDisposableEmail' => true,
'checkFreeEmail' => true,
'bannedList' => $bannedDomainList,
'disposableList' => $customDisposableEmailList,
'freeList' => $customFreeEmailList,
];
$emailValidator = new EmailValidator($config);
foreach ($testEmailAddresses as $emailAddress) {
$emailIsValid = $emailValidator->validate($emailAddress);
echo ($emailIsValid) ? 'Email is valid' : $emailValidator->getErrorReason();
if ($emailValidator->isGmailWithPlusChar()) {
printf(
' (Sanitized address: %s)',
$emailValidator->getGmailAddressWithoutPlus()
);
}
echo PHP_EOL;
}
Output
Domain is banned
Email is valid
Domain is used by free email providers
Domain is used by free email providers
Domain is used by free email providers
Domain is used by free email providers
Domain is banned
Domain does not accept email
Domain is used by disposable email providers
Domain is used by free email providers
Domain is used by disposable email providers
Domain does not accept email
Domain is used by disposable email providers
Domain is used by free email providers (Sanitized address: test@gmail.com)
The email address is checked against a list of known disposable email address providers which are aggregated from public disposable email address provider lists. This requires making HTTP requests to get the lists when validating the address.
If you require assistance using this library start by viewing the HELP.md file included in this package. It includes common problems and solutions as well how to ask for additional assistance.
Files (34) |
File | Role | Description | ||
---|---|---|---|---|
.github (1 directory) | ||||
examples (4 files) | ||||
src (1 directory) | ||||
tests (1 directory) | ||||
.editorconfig | Data | Auxiliary data | ||
CHANGELOG.md | Data | Auxiliary data | ||
composer.json | Data | Auxiliary data | ||
CONTRIBUTING.md | Data | Auxiliary data | ||
HELP.md | Data | Auxiliary data | ||
license.txt | Doc. | Documentation | ||
phpunit.xml | Data | Auxiliary data | ||
README.md | Doc. | Read me | ||
SECURITY.md | Data | Auxiliary data |
Files (34) | / | examples |
File | Role | Description |
---|---|---|
disposableEmailList.php | Example | Example script |
disposableEmailListWithCustomDomains.php | Example | Example script |
fullValidation.php | Example | Example script |
getDisposableEmailList.php | Example | Example script |
Files (34) | / | src | / | EmailValidator |
File | Role | Description | ||
---|---|---|---|---|
Validator (8 files) | ||||
EmailAddress.php | Class | Class source | ||
EmailValidator.php | Class | Class source | ||
Policy.php | Class | Class source |
Files (34) | / | src | / | EmailValidator | / | Validator |
File | Role | Description |
---|---|---|
AProviderValidator.php | Class | Class source |
AValidator.php | Class | Class source |
BannedListValidator.php | Class | Class source |
BasicValidator.php | Class | Class source |
DisposableEmailValidator.php | Class | Class source |
FreeEmailValidator.php | Class | Class source |
IValidator.php | Class | Class source |
MxValidator.php | Class | Class source |
Files (34) | / | tests | / | EmailValidator |
File | Role | Description | ||
---|---|---|---|---|
Validator (6 files) | ||||
EmailAddressTest.php | Class | Class source | ||
EmailValidatorTest.php | Class | Class source | ||
PolicyTest.php | Class | Class source |
Files (34) | / | tests | / | EmailValidator | / | Validator |
File | Role | Description |
---|---|---|
BannedListValidatorTest.php | Class | Class source |
BasicValidatorTest.php | Class | Class source |
DisposableEmailValidatorTest.php | Class | Class source |
FreeEmailValidatorTest.php | Class | Class source |
MxValidatorTest.php | Class | Class source |
ProviderValidatorTest.php | Class | Class source |
The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page. |
Install with Composer |
email-validator-pro-2024-04-20.zip 27KB | |
email-validator-pro-2024-04-20.tar.gz 16KB | |
Install with Composer |
Version Control | Unique User Downloads | Download Rankings | |||||||||||||||
100% |
|
|
Applications that use this package |
If you know an application of this package, send a message to the author to add a link here.