square-bit/laravel-eva

Keep fake or disposable emails out. A validation rule for your forms.

1.2 2020-10-27 19:09 UTC

This package is auto-updated.

Last update: 2020-11-02 17:31:31 UTC


README

Latest Stable Version License Total Downloads

Laravel package for integration with e-va.io service. Provides a Rule to automatically validate form emails.

Install

composer require square-bit/laravel-eva

The package will automatically register its service provider.

To publish the default config at config/eva.php:

php artisan vendor:publish --provider="Squarebit\EVA\EVAServiceProvider" --tag="config"

Make sure you update the .env file with a valid API Key (generate one at e-va.io)

Variables Default value
EVA_APIKEY null
EVA_SERVICE_UNAVAILABLE true
EVA_UNKOWN false
EVA_INVALID false
EVA_RISKY false
EVA_SAFE true

Usage

You can now use EVA to validate any email provided by your users directly with the Laravel Validator.

Let's say you're already validating an email on its basic properties

    return Validator::make($data, [
        [...]
        'email' => ['required', 'string', 'email', 'max:255'],
        [...]
    ]);

To get the email validated simply add the EVAValidated class to the list of rules:

use Squarebit\EVA\Rules\EVAValidated

[...]

    return Validator::make($data, [
        [...]
        'email' => [new EVAValidated, 'required', 'string', 'email', 'max:255', 'unique:users'],
        [...]
    ]);

That's it !

Security

If you discover any security related issues, please email info@square-bit.com instead of using the issue tracker.

Credits

License

MIT. Please see the license file for more information.