hivokas/laravel-email-blacklist

Email blacklist management for Laravel.

0.1.0 2018-10-18 17:22 UTC

Requires

• laravel/framework: 5.7.*

Requires (Dev)

• orchestra/testbench: ~3.0

MIT

README

Handy email blacklist management for Laravel.

Installation

You can install this package via composer using this command:

composer require hivokas/laravel-email-blacklist

The package will automatically register itself.

You can publish the migration with:

php artisan vendor:publish --provider="Hivokas\EmailBlacklist\Providers\EmailBlacklistServiceProvider" --tag="migrations"

After the migration has been published you can create the table for blacklisted emails by running the migrations:

php artisan migrate

You can publish the config file with:

php artisan vendor:publish --provider="Hivokas\EmailBlacklist\Providers\EmailBlacklistServiceProvider" --tag="config"

This is the contents of the published config file:

return [

    /*
    |--------------------------------------------------------------------------
    | Table Name For Email Blacklist Storing
    |--------------------------------------------------------------------------
    */
    'table_name' => 'blacklisted_emails',

    /*
    |--------------------------------------------------------------------------
    | BlacklistedEmail Model
    |--------------------------------------------------------------------------
    */
    'model' => \Hivokas\EmailBlacklist\Models\BlacklistedEmail::class,

];

Examples of use

use Hivokas\EmailBlacklist\Facades\EmailBlacklist;

EmailBlacklist::add('[e-mail]');

EmailBlacklist::count(); // 1

EmailBlacklist::all(); // ['[e-mail]']

EmailBlacklist::exists('[e-mail]'); // true

EmailBlacklist::remove('[e-mail]');

EmailBlacklist::exists('[e-mail]'); // false

EmailBlacklist::count(); // 0

Methods

all()

Returns all blacklisted emails.

count()

Returns amount of blacklisted emails.

exists(string $email)

Returns true if email is blacklisted and vice versa.

add(string $email)

Adds email to the blacklist.

remove(string $email)

Removes email from the blacklist.

validate(string $email)

Throws an InvalidArgumentException is email is invalid.

Testing

You can run the tests with:

composer test