Laravel Email Domain Rule
This package allows to define a subset of allowed email domains and validate any user registration form with a custom rule.
Installation
You can install the package via composer:
composer require h-farm/laravel-email-domain-rule
You can publish and run the migrations with:
php artisan vendor:publish --provider="HFarm\EmailDomainRule\EmailDomainRuleServiceProvider" --tag="email-domain-rule-migrations"
php artisan migrate
You can publish the config file with:
php artisan vendor:publish --provider="HFarm\EmailDomainRule\EmailDomainRuleServiceProvider" --tag="email-domain-rule-config"
This is the content of the published config file:
return [
/*
|--------------------------------------------------------------------------
| Email Domain model
|--------------------------------------------------------------------------
|
| Here you may specify the fully qualified class name of the email domain model.
|
*/
'email_domain_model' => HFarm\EmailDomainRule\Models\EmailDomain::class,
/*
|--------------------------------------------------------------------------
| Email Domain wildcard
|--------------------------------------------------------------------------
|
| Here you may specify the character used as wildcard for all email domains.
|
*/
'email_domain_wildcard' => '*',
/*
|--------------------------------------------------------------------------
| Validation message
|--------------------------------------------------------------------------
|
| Here you may specify the message thrown if the validation rule fails.
|
*/
'validation_message' => 'The selected :attribute does not have a valid domain.',
];
Usage
Basic
To use the package, run the migration and fill in the table with a list of accepted email domains for your application.
You can then just add the custom validation rule to validate, for example, a user registration form.
use HFarm\EmailDomainRule\EmailDomainRule;
use Illuminate\Support\Facades\Validator;
$email = '[email protected]';
Validator::make([
'email' => $email,
], [
'email' => [
'string',
'email',
new EmailDomainRule,
],
])->validated();
That's all! Laravel will handle the rest by validating the input and throwing an error message if validation fails.
Wildcard domains
If needed, you can optionally add wildcard domains to the email_domains database table: the custom rule will handle the rest.
The default wildcard character is an asterisk (*), but you can customize it within the email_domain_wildcard setting.
use HFarm\EmailDomainRule\EmailDomainRule;
use HFarm\EmailDomainRule\Models\EmailDomain;
use Illuminate\Support\Facades\Validator;
EmailDomain::create(['domain' => '*.example.com']);
Validator::make([
'email' => '[email protected]',
], [
'email' => ['string', 'email', new EmailDomainRule],
])->fails(); // returns true as the given domain is not in the list
Validator::make([
'email' => '[email protected]',
], [
'email' => ['string', 'email', new EmailDomainRule],
])->fails(); // returns false as the given domain matches the wildcard domain
Model customization
You can also override the default EmailDomain model to add any additional field by changing the email_domain_model setting.
This can be useful when working with a multi-tenancy scenario in a single database system: in this case you can just add a tenant_id column to the migration and model classes, and apply a global scope to the custom model.
use HFarm\EmailDomainRule\EmailDomainRule as BaseEmailDomain;
use Illuminate\Database\Eloquent\Builder;
class EmailDomain extends BaseEmailDomain
{
protected $fillable = [
'domain',
'tenant_id',
];
protected static function booted()
{
static::addGlobalScope('tenantAware', function (Builder $builder) {
$builder->where('tenant_id', auth()->user()->tenant_id);
});
}
}
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.
300 Dec 30, 2022
11 Oct 13, 2020
28 Dec 19, 2022
1 Nov 24, 2021
3 Aug 23, 2022
622 Jan 2, 2023
1 Jan 28, 2022
30 Jul 17, 2022
41 Dec 24, 2022
1.7k Dec 28, 2022
20 Jan 20, 2022
13 Feb 8, 2022
152 Dec 15, 2022
2 Sep 2, 2022
15 Dec 19, 2022
2 Nov 17, 2021
22 Nov 17, 2022
27 Nov 20, 2022
17 Dec 14, 2022