Bibliothèque PHP — Package Composer

Installation

composer require nsoftware/email-validator-php

Prérequis : PHP 8.1+, Guzzle 7, cache PSR-6 (facultatif), logger PSR-3 (facultatif).

Démarrage rapide

<?php
require 'vendor/autoload.php';

use NSoftware\EmailValidator\Client;

$client = new Client('ev_your_api_key');

// Verify one email
$result = $client->verify('user@example.com');

if ($result->isValid()) {
    echo "Valid — confidence: {$result->confidence}";
}
if ($result->isDisposable()) {
    echo "Disposable email — reject!";
}

Vérification asynchrone

$client->verifyAsync('user@domain.com')
    ->then(fn($result) => echo $result->status);

// Bulk async with controlled concurrency
$client->verifyBulkAsync($emails, concurrency: 10)
    ->then(function(array $results) {
        foreach ($results as $email => $r) {
            echo "$email: {$r->status}\n";
        }
    });

Cache PSR-6

use Symfony\Component\Cache\Adapter\FilesystemAdapter;

$cache = new FilesystemAdapter('email-validator', 300);
$client = new Client('ev_...', cache: $cache);

// Account info auto-cached for 5 min
$account = $client->getAccount();

// Force refresh
$account = $client->getAccount(forceRefresh: true);

DTO typés

Chaque DTO dispose d'une méthode statique fromApiResponse(array) factory and toArray() serialization.

Prédicats pratiques

Intégration Laravel

Le package s'enregistre automatiquement via la découverte automatique de Laravel. Ajoutez simplement votre clé API dans .env:

EMAIL_VALIDATOR_API_KEY=ev_your_key

Utilisez ensuite l'injection de dépendances ou la façade n'importe où :

use NSoftware\EmailValidator\Client;
use EmailValidator;  // Facade alias

class SignupController
{
    public function store(Request $request, Client $validator)
    {
        $result = $validator->verify($request->email);

        if (!$result->isDeliverable()) {
            return back()->withErrors(['email' => 'Invalid email']);
        }

        // Create user...
    }
}

// Or with the facade:
$result = EmailValidator::verify('user@example.com');
$account = EmailValidator::getAccount();

Gestion des erreurs

try {
    $result = $client->verify('user@example.com');
} catch (RateLimitException $e) {
    sleep($e->retryAfterSeconds);
    // retry
} catch (NoCreditsException $e) {
    // prompt user to upgrade
} catch (ApiException $e) {
    logger()->error("Validation failed: {$e->getMessage()}");
}

Contenu du package

v5.0.0 · Licence MIT · PHP 8.1+ · Guzzle 7 · PSR-6 / PSR-3