laravel-trashmail-rule

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

laravel-trashmail-rule

★ 9 Open GitHub ↗

This package provides a validation rule to prevent trash email addresses.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Laravel Trashmail Rules

[![Latest Version](http://img.shields.io/packagist/v/elbgoods/laravel-trashmail-rule.svg?label=Release&style=for-the-badge)](https://packagist.org/packages/elbgoods/laravel-trashmail-rule)
[![MIT License](https://img.shields.io/github/license/elbgoods/laravel-trashmail-rule.svg?label=License&color=blue&style=for-the-badge)](https://github.com/elbgoods/laravel-trashmail-rule/blob/master/LICENSE)
[![Offset Earth](https://img.shields.io/badge/Treeware-%F0%9F%8C%B3-green?style=for-the-badge&cacheSeconds=600)](https://plant.treeware.earth/elbgoods/laravel-trashmail-rule)

[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/elbgoods/laravel-trashmail-rule/run-tests?label=tests&style=flat-square)](https://github.com/elbgoods/laravel-trashmail-rule/actions?query=workflow%3Arun-tests)
[![Total Downloads](https://img.shields.io/packagist/dt/elbgoods/laravel-trashmail-rule.svg?style=flat-square)](https://packagist.org/packages/elbgoods/laravel-trashmail-rule)

This package provides a validation rule to prevent trashmail email addresses.

## Installation

At first you have to add this package to your `composer.json`:

```bash
composer require elbgoods/laravel-trashmail-rule
```

After this you can publish the package translation files to adjust the error messages:

```bash
php artisan vendor:publish --provider="Elbgoods\TrashmailRule\TrashmailRuleServiceProvider" --tag=lang
php artisan vendor:publish --provider="Elbgoods\TrashmailRule\TrashmailRuleServiceProvider" --tag=config
```

## Configuration

The package provides a configuration to define the rule behaviour.

### Denied domains

You can add your own list of denied domains, these domains will always be blocked.

### Allowed domains

You can add your own list of allowed domains, these domains will always pass.

# supported Providers

* local configuration - `\Elbgoods\TrashmailRule\Providers\ConfigProvider`
* https://disposable-email-detector.com - `\Elbgoods\TrashmailRule\Providers\DisposableEmailDetectorProvider`
* https://verifier.meetchopra.com - `\Elbgoods\TrashmailRule\Providers\VerifierProvider`

## Usage

## Validation Rule

This package provides a basic `TrashmailRule` which you can use. All more specific rules only extend this rule with a predefined `format`.

```php
use Elbgoods\TrashmailRule\Rules\TrashmailRule;

$rule = new TrashmailRule();
```

By default the rule requires a value - if you want to accept `null` values you can use the `nullable()` method or set the `$required` parameter to `false`.

```php
use Elbgoods\TrashmailRule\Rules\TrashmailRule;

$rule = new TrashmailRule(false);
$rule->nullable();
```

## Facade

You can also use the facade if you want to check any email address outside validation.
This will run the same logic as the validation rule and runs all providers set in the config.

```php
use Elbgoods\TrashmailRule\Facades\Trashmail;

Trashmail::isDisposable('example@elbgoods.de');
```

## single Provider

You can also check using a single provider only. 
Keep in mind that all providers only accept the domain to check and not a full email address.
The facade provides a method that returns the domain used in an email address.

```php
use Elbgoods\TrashmailRule\Facades\Trashmail;

Trashmail::provider('config')->isDisposable(
    Trashmail::getDomain('example@elbgoods.de')
);
```

## custom Provider

If you want to add your own provider you can do so.

```php
use Elbgoods\TrashmailRule\Facades\Trashmail;
use Illuminate\Contracts\Container\Container;
use Elbgoods\TrashmailRule\Contracts\ProviderContract;

Trashmail::extend('custom_provider', static function (Container $app): ProviderContract {
    return new CustomProvider();
});
```

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Versioning

This package follows [semantic versioning](https://semver.org/).

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

Please see [SECURITY](SECURITY.md) for details.

## Credits

- [Tom Witkowski](https://github.com/Gummibeer)
- [All Contributors](https://github.com/elbgoods/laravel-trashmail-rule/graphs/contributors)

## License

The MIT License (MIT). Please see [License File](LICENSE) for more information.

## Treeware

You're free to use this package, but if it makes it to your production environment we would highly appreciate you buying or planting the world a tree.

It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to [plant trees](https://www.bbc.co.uk/news/science-environment-48870920). If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats.

You can buy trees at [offset.earth/treeware](https://plant.treeware.earth/elbgoods/laravel-trashmail-rule)

Read more about Treeware at https://treeware.earth

laravel-trashmail-rule

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README