Stars: 394
Forks: 141
Pull Requests: 24
Issues: 48
Watchers: 34
Last Updated: 2022-09-12 14:02:38
A PHP library for performing email addresses validation via SMTP
License: GNU General Public License v3.0
Languages: PHP, Makefile, Shell
Perform email address validation/verification via SMTP.
The SMTPValidateEmail\Validator
class retrieves MX records for the email domain and then connects to the
domain's SMTP server to try figuring out if the address really exists.
Earlier versions (before 1.0) used the SMTP_Validate_Email
class name (and did not use namespaces and other now-common PHP features). Care has been taken to keep the old API and migrating old code should be painless. See "Migrating to 1.0 from older versions" section. Or just use/download the ancient 0.7 version.
Install via composer:
composer require zytzagoo/smtp-validate-email --update-no-dev
<?php
require 'vendor/autoload.php';
use SMTPValidateEmail\Validator as SmtpEmailValidator;
/**
* Simple example
*/
$email = '[email protected]';
$sender = '[email protected]';
$validator = new SmtpEmailValidator($email, $sender);
// If debug mode is turned on, logged data is printed as it happens:
// $validator->debug = true;
$results = $validator->validate();
var_dump($results);
// Get log data (log data is always collected)
$log = $validator->getLog();
var_dump($log);
<?php
require 'vendor/autoload.php';
use SMTPValidateEmail\Validator as SmtpEmailValidator;
/**
* Validating multiple addresses/recipients at once:
* (checking multiple addresses belonging to the same server
* uses a single connection)
*/
$emails = [
'[email protected]',
'[email protected]'
];
$sender = '[email protected]';
$validator = new SmtpEmailValidator($emails, $sender);
$results = $validator->validate();
var_dump($results);
/**
* The `validate()` method accepts the same parameters
* as the constructor, so this is equivalent to the above:
*/
$emails = [
'[email protected]',
'[email protected]'
];
$sender = '[email protected]';
$validator = new SmtpEmailValidator();
$results = $validator->validate($emails, $sender);
var_dump($results);
Earlier versions used the global SMTP_Validate_Email
classname.
You can keep using that name in your existing code and still switch to the newer (composer-powered) version by using aliasing/importing like this:
Require the composer package:
composer require zytzagoo/smtp-validate-email --update-no-dev
And then in your code:
<?php
require 'vendor/autoload.php';
use SMTPValidateEmail\Validator as SMTP_Validate_Email;
// Now any old code referencing `SMTP_Validate_Email` should still work as it did earlier
See the Makefile and the development dependencies in composer.json.
Running make
once you clone (or download) the repository gives you:
Usage: make [target]
[target] help
-------- ----
help What you're currently reading
install Installs dev dependencies
clean Removes installed dev dependencies
test Runs tests
coverage Runs tests with code coverage
server-start Stops and starts the smtp server
server-stop Stops smtp server if it's running
(PIDFILE) Starts the smtp server
(MAILHOG) Downloads platform-specific mailhog binary
So, run make install
to get started. Afterwards you should be able to run the tests (make test
).
Tests are powered by phpunit
and a local ./bin/mailhog
instance running on port 1025.
Tests requiring an SMTP server are marked as skipped (if/when the SMTP server is unavailable).
Pull requests are welcome!
In order to get your pull request merged, please follow these simple rules:
make test
phpcs
is used)