flow / email-checker

0.3.0 2013-11-06 10:35 UTC

Requires

• react/react: 0.3.*

MIT

• Stephen Frank

Published on Packagist.org on 2013-11-06 10:40 UTC

README

EmailChecker connects to mail servers over SMTP and asks them to verify email addresses. The library uses ReactPHP's event-driven IO layer to handle all the socket communication.

Key features:

• N connections are opened concurrently and handled asyncronously thanks to ReactPHP.
• Connections are pooled and kept alive so that multiple requests to the same domain are handled efficiently.

Caveats:

• SMTP servers respond with any old random response and can't be trusted especially when requesting a mailbox's RCPT (though this approach is better than nothing).
• MX records are resolved using getmxrr() and therefore that operation is blocking.

To do:

• Implement React/DNS when is supports MX record resolution.
• Unit test all of the things.

Example:

use Flow\EmailChecker\ConnectionPool;
use Flow\EmailChecker\MailboxUser;

$loop = React\EventLoop\Factory::create();

$emails = array(
    '[e-mail]',
    '[e-mail]'
);

$connectionPool = new ConnectionPool($loop, 'flowsa.com', 'stephen', function (ConnectionPool $pool) use (& $emails) {
    $email = array_shift($emails);

    if (!$email) {
        return false; // Returning false will cause the connection pool to drain and eventually die
    }

    $pool->add(
        $email,
        function (MailboxUser $email) { // Bind in a closure for the callback that occurs after an email is resolved
            echo $email->getEmail() . ($email->exists() ? ' exists' : ' does not exist') . "\n";
        }
    );

}, function ($str) {
    echo "$str\n";
});

$connectionPool->setConcurrency(10);
$connectionPool->run();