PHP SDK

PHP email checker SDK. Composer install, verify emails with PHP. Code examples included.

De officiële EmailVerify SDK voor PHP biedt een gebruiksvriendelijke interface voor e-mailverificatie met Laravel ondersteuning.

Installatie

composer require emailverify/php-sdk

Vereisten

PHP 8.0 of hoger
Composer
JSON extensie
cURL extensie

Snelstart

<?php

use EmailVerify\Client;

$client = new Client(getenv('EMAILVERIFY_API_KEY'));

$result = $client->verify('user@example.com');
echo "Status: " . $result->status . "\n";
echo "Score: " . $result->score . "\n";

Configuratie

Client Opties

$client = new Client(
    apiKey: getenv('EMAILVERIFY_API_KEY'),
    options: [
        'timeout' => 30,           // Request timeout in seconden
        'retries' => 3,            // Aantal herhaalpogingen
        'base_url' => 'https://api.emailverify.ai',
    ]
);

Omgevingsconfiguratie

# .env
EMAILVERIFY_API_KEY=your_api_key_here

Enkele Verificatie

Basis Verificatie

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

echo "Email: " . $result->email . "\n";
echo "Status: " . $result->status . "\n";
echo "Score: " . $result->score . "\n";
echo "Afleverbaar: " . ($result->result->deliverable ? 'Ja' : 'Nee') . "\n";
echo "Wegwerp: " . ($result->result->disposable ? 'Ja' : 'Nee') . "\n";

Verificatie met Opties

$result = $client->verify('user@example.com', [
    'smtp_check' => true,
    'timeout' => 5,
]);

Antwoordstructuur

class VerificationResult {
    public string $email;
    public string $status;        // 'valid', 'invalid', 'unknown', 'accept_all'
    public ResultDetails $result;
    public float $score;
    public ?string $reason;
}

class ResultDetails {
    public ?bool $deliverable;
    public bool $valid_format;
    public bool $valid_domain;
    public bool $valid_mx;
    public bool $disposable;
    public bool $role;
    public bool $catchall;
    public bool $free;
    public ?bool $smtp_valid;
}

Bulkverificatie

Taak Indienen

$emails = [
    'user1@example.com',
    'user2@example.com',
    'user3@example.com',
];

$job = $client->verifyBulk($emails);
echo "Taak ID: " . $job->id . "\n";

Status Controleren

$status = $client->getBulkJobStatus($job->id);

echo "Status: " . $status->status . "\n";
echo "Voortgang: " . $status->processed . "/" . $status->total . "\n";
echo "Geldig: " . $status->valid . "\n";
echo "Ongeldig: " . $status->invalid . "\n";

Resultaten Ophalen

$results = $client->getBulkJobResults($job->id);

foreach ($results as $result) {
    echo $result->email . ": " . $result->status . "\n";
}

Met Webhook

$job = $client->verifyBulk($emails, [
    'webhook_url' => 'https://your-domain.com/webhooks/emailverify',
]);

Tegoedbeheer

$credits = $client->getCredits();

echo "Beschikbaar: " . $credits->available . "\n";
echo "Gebruikt: " . $credits->used . "\n";
echo "Totaal: " . $credits->total . "\n";

Foutafhandeling

Exceptietypen

use EmailVerify\Client;
use EmailVerify\Exceptions\AuthenticationException;
use EmailVerify\Exceptions\RateLimitException;
use EmailVerify\Exceptions\ValidationException;
use EmailVerify\Exceptions\EmailVerifyException;

try {
    $result = $client->verify('invalid-email');
} catch (AuthenticationException $e) {
    echo "Ongeldige API-sleutel\n";
} catch (RateLimitException $e) {
    echo "Rate beperkt. Probeer opnieuw na " . $e->getRetryAfter() . " seconden\n";
} catch (ValidationException $e) {
    echo "Ongeldige invoer: " . $e->getMessage() . "\n";
} catch (EmailVerifyException $e) {
    echo "API fout: " . $e->getMessage() . "\n";
}

Laravel Integratie

Service Provider

Het pakket wordt automatisch ontdekt in Laravel 5.5+. Voor oudere versies, voeg toe aan config/app.php:

'providers' => [
    EmailVerify\Laravel\EmailVerifyServiceProvider::class,
],

'aliases' => [
    'EmailVerify' => EmailVerify\Laravel\Facades\EmailVerify::class,
],

Configuratie

Publiceer het configuratiebestand:

php artisan vendor:publish --provider="EmailVerify\Laravel\EmailVerifyServiceProvider"

Configuratiebestand (config/emailverify.php):

<?php

return [
    'api_key' => env('EMAILVERIFY_API_KEY'),
    'timeout' => env('EMAILVERIFY_TIMEOUT', 30),
    'retries' => env('EMAILVERIFY_RETRIES', 3),
];

De Facade Gebruiken

use EmailVerify\Laravel\Facades\EmailVerify;

// Enkele verificatie
$result = EmailVerify::verify('user@example.com');

// Bulkverificatie
$job = EmailVerify::verifyBulk($emails);

// Tegoeden controleren
$credits = EmailVerify::getCredits();

Dependency Injection

use EmailVerify\Client;

class UserController extends Controller
{
    public function __construct(
        private Client $emailVerify
    ) {}

    public function register(Request $request)
    {
        $result = $this->emailVerify->verify($request->email);

        if ($result->status === 'invalid') {
            return back()->withErrors(['email' => 'Ongeldig e-mailadres']);
        }

        // Ga door met registratie...
    }
}

Validatieregel

use EmailVerify\Laravel\Rules\ValidEmail;

$request->validate([
    'email' => ['required', 'email', new ValidEmail()],
]);

Aangepaste regel met opties:

use EmailVerify\Laravel\Rules\ValidEmail;

$request->validate([
    'email' => [
        'required',
        'email',
        new ValidEmail([
            'reject_disposable' => true,
            'reject_role' => false,
            'min_score' => 0.7,
        ]),
    ],
]);

Form Request

<?php

namespace App\Http\Requests;

use EmailVerify\Laravel\Rules\ValidEmail;
use Illuminate\Foundation\Http\FormRequest;

class RegisterRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'name' => ['required', 'string', 'max:255'],
            'email' => [
                'required',
                'email',
                'unique:users',
                new ValidEmail([
                    'reject_disposable' => true,
                ]),
            ],
            'password' => ['required', 'min:8', 'confirmed'],
        ];
    }

    public function messages(): array
    {
        return [
            'email.valid_email' => 'Geef een geldig e-mailadres op.',
        ];
    }
}

Wachtrijverificatie

<?php

namespace App\Jobs;

use EmailVerify\Client;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class VerifyUserEmail implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public function __construct(
        private int $userId,
        private string $email
    ) {}

    public function handle(Client $client): void
    {
        $result = $client->verify($this->email);

        \App\Models\User::where('id', $this->userId)->update([
            'email_verified' => $result->status === 'valid',
            'email_score' => $result->score,
            'email_disposable' => $result->result->disposable,
        ]);
    }
}

// Verzenden
VerifyUserEmail::dispatch($user->id, $user->email);

Middleware

<?php

namespace App\Http\Middleware;

use EmailVerify\Client;
use Closure;
use Illuminate\Http\Request;

class VerifyEmailMiddleware
{
    public function __construct(
        private Client $client
    ) {}

    public function handle(Request $request, Closure $next)
    {
        if ($request->has('email')) {
            $result = $this->client->verify($request->email);

            if ($result->status === 'invalid') {
                return response()->json([
                    'error' => 'Ongeldig e-mailadres'
                ], 422);
            }

            if ($result->result->disposable) {
                return response()->json([
                    'error' => 'Wegwerp e-mailadressen zijn niet toegestaan'
                ], 422);
            }
        }

        return $next($request);
    }
}

Complete Voorbeelden

Registratievalidatie

<?php

use EmailVerify\Client;

class EmailValidator
{
    public function __construct(
        private Client $client
    ) {}

    public function validateForRegistration(string $email): array
    {
        $result = $this->client->verify($email);

        // Weiger ongeldige e-mails
        if ($result->status === 'invalid') {
            return [
                'valid' => false,
                'reason' => 'invalid_email',
                'message' => 'Dit e-mailadres is ongeldig',
            ];
        }

        // Weiger wegwerp e-mails
        if ($result->result->disposable) {
            return [
                'valid' => false,
                'reason' => 'disposable',
                'message' => 'Gebruik alstublieft een permanent e-mailadres',
            ];
        }

        // Waarschuw voor rol-gebaseerde e-mails
        if ($result->result->role) {
            return [
                'valid' => true,
                'warning' => 'role_based',
                'message' => 'Het gebruik van een persoonlijk e-mailadres wordt aanbevolen',
            ];
        }

        return [
            'valid' => true,
            'score' => $result->score,
        ];
    }
}

// Gebruik
$validator = new EmailValidator($client);
$validation = $validator->validateForRegistration('user@example.com');

if (!$validation['valid']) {
    echo $validation['message'];
}

Bulk Lijstopschoning

<?php

use EmailVerify\Client;

class ListCleaner
{
    public function __construct(
        private Client $client
    ) {}

    public function cleanList(array $emails): array
    {
        // Bulktaak indienen
        $job = $this->client->verifyBulk($emails);

        // Polling op voltooiing
        while (true) {
            $status = $this->client->getBulkJobStatus($job->id);

            if ($status->status === 'completed') {
                break;
            }

            if ($status->status === 'failed') {
                throw new \Exception('Bulktaak mislukt');
            }

            sleep(5);
        }

        // Resultaten ophalen en categoriseren
        $results = $this->client->getBulkJobResults($job->id);

        $valid = [];
        $invalid = [];
        $risky = [];

        foreach ($results as $result) {
            if ($result->status === 'invalid') {
                $invalid[] = $result->email;
            } elseif ($result->result->disposable || $result->result->role) {
                $risky[] = $result->email;
            } else {
                $valid[] = $result->email;
            }
        }

        return [
            'valid' => $valid,
            'invalid' => $invalid,
            'risky' => $risky,
            'stats' => [
                'total' => count($emails),
                'valid_count' => count($valid),
                'invalid_count' => count($invalid),
                'risky_count' => count($risky),
            ],
        ];
    }
}

API Endpoint

<?php
// api/verify.php

header('Content-Type: application/json');

use EmailVerify\Client;

$client = new Client(getenv('EMAILVERIFY_API_KEY'));

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    echo json_encode(['error' => 'Methode niet toegestaan']);
    exit;
}

$input = json_decode(file_get_contents('php://input'), true);
$email = $input['email'] ?? null;

if (!$email) {
    http_response_code(400);
    echo json_encode(['error' => 'E-mail is verplicht']);
    exit;
}

try {
    $result = $client->verify($email);
    echo json_encode([
        'email' => $result->email,
        'status' => $result->status,
        'score' => $result->score,
        'deliverable' => $result->result->deliverable,
    ]);
} catch (\Exception $e) {
    http_response_code(500);
    echo json_encode(['error' => 'Verificatie mislukt']);
}

Best Practices

1. Resultaten Cachen

use Illuminate\Support\Facades\Cache;

function verifyWithCache(Client $client, string $email): VerificationResult
{
    $cacheKey = 'email_verification_' . md5($email);

    return Cache::remember($cacheKey, 3600, function () use ($client, $email) {
        return $client->verify($email);
    });
}

2. Fouten Soepel Afhandelen

function safeVerify(Client $client, string $email): ?VerificationResult
{
    try {
        return $client->verify($email);
    } catch (RateLimitException $e) {
        Log::warning('Rate beperkt', ['retry_after' => $e->getRetryAfter()]);
        return null;
    } catch (EmailVerifyException $e) {
        Log::error('Verificatie mislukt', ['error' => $e->getMessage()]);
        return null;
    }
}

PHP SDK

Installatie

Vereisten

Snelstart

Configuratie

Client Opties

Omgevingsconfiguratie

Enkele Verificatie

Basis Verificatie

Verificatie met Opties

Antwoordstructuur

Bulkverificatie

Taak Indienen

Status Controleren

Resultaten Ophalen

Met Webhook

Tegoedbeheer

Foutafhandeling

Exceptietypen

Laravel Integratie

Service Provider

Configuratie

De Facade Gebruiken

Dependency Injection

Validatieregel

Form Request

Wachtrijverificatie

Middleware

Complete Voorbeelden

Registratievalidatie

Bulk Lijstopschoning

API Endpoint

Best Practices

1. Resultaten Cachen

2. Fouten Soepel Afhandelen

Volgende Stappen

API Referentie

Laravel Integratie

On this page