rayhughes/sendgrid-validation

A PHP library to validate email addresses using the Twilio SendGrid Email Validation API.

1.2.1 2024-11-29 01:02 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *
• ext-mbstring: *
• guzzlehttp/guzzle: >=7.4.5.0

Requires (Dev)

• phpunit/phpunit: ^9.5
• vimeo/psalm: ^4.10

MIT

• Ray Hughes

• sendgrid
• email validation
• twilio sendgrid
• sendGrid email validation
• validation api

README

A PHP library to validate email addresses using the Twilio SendGrid Email Validation API.

Prerequisites

• Twilio SendGrid Email Validation API Key
• PHP 7.4 or greater
• Composer

Installation

composer require rayhughes/sendgrid-validation

Usage

Basic

EmailValidation() initialized with default thresholds.

use SendGridValidation\EmailValidation;
use SendGridValidation\Repository\SendGridApiRepository;

$validation = new EmailValidation(new SendGridApiRepository('api-key'));

$emailValid = $validation->validate('[e-mail]'));

echo $emailValid->isValid; // true
echo $emailValid->isValidRisk; // true
echo $emailValid->isValidScore; // true
echo $emailValid->isDisposable; // false
echo $emailValid->hasSuggestion; //false
echo $emailValid->suggestion; // null

EmailValidation()->validate() returns an instance of EmailValidationDto()

EmailValidationDto()

• $isValid - Calculated true if validation result meets specified thresholds.
• $isValidRisk - Calculated true specified risk criteria
• $isValidScore - Calculated true if within minimum score threshold.
• $isDisposable - Calculated true if an email is considered to be disposable.
• $hasSuggestion - Calculated true if a suggestion is available.
• $suggestion - Calculated email suggestion if available.

class EmailValidationDto
{
    public bool $isValid = false;

    public bool $isValidRisk = false;

    public bool $isValidScore = false;

    public bool $isDisposable = false;

    public bool $hasSuggestion = false;

    public ?string $suggestion = null;
}

Advanced

EmailValidation() can be initialized with optional parameters to validate against developer specified thresholds.

• $allowRisky - When true, considers risky emails valid if other conditions are met.
• $allowDisposable- When true, considers disposable emails valid if other conditions are met.
• $checkValidScore - When true, checks SendGrid valid emails against the minimum score threshold.
• $minSCore - Default 0.30. considers emails invalid if the minimum score threshold is not met.

use SendGridValidation\EmailValidation;
use SendGridValidation\Repository\SendGridApiRepository;

$validation = new EmailValidation(
    new SendGridApiRepository($apiKey),
    true, // bool $allowRisky = true,
    true, // bool $allowDisposable = true,
    true, // bool $checkValidScore = false,
    EmailValidation::MIN_SCORE // float $minScore = self::MIN_SCORE (0.30)
);

$emailValid = $validation->validate($email);