https://github.com/eramitgupta/laravel-disposable-email
A Laravel package to detect and block disposable email addresses with 100K+ known domains.
https://github.com/eramitgupta/laravel-disposable-email
disposable disposable-check disposable-domains disposable-email disposable-email-domains email-blacklist laravel validation
Last synced: 5 months ago
JSON representation
A Laravel package to detect and block disposable email addresses with 100K+ known domains.
- Host: GitHub
- URL: https://github.com/eramitgupta/laravel-disposable-email
- Owner: eramitgupta
- License: mit
- Created: 2025-04-18T16:57:56.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-19T13:33:55.000Z (6 months ago)
- Last Synced: 2025-04-26T07:55:30.946Z (5 months ago)
- Topics: disposable, disposable-check, disposable-domains, disposable-email, disposable-email-domains, email-blacklist, laravel, validation
- Language: PHP
- Homepage:
- Size: 64.5 KB
- Stars: 13
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Laravel Disposable Email Detection
[](https://github.com/eramitgupta/laravel-disposable-email/blob/main/LICENSE)
[](https://packagist.org/packages/erag/laravel-disposable-email)
[](https://packagist.org/packages/erag/laravel-disposable-email)
A Laravel package to detect and block disposable (temporary) email addresses during validation or runtime logic.
> **Already contains 106,580+ disposable email domains!** 🔥
---
## ✅ Features
- 🔥 **106,000+ known disposable domains** already included
- 🧠 **Smart validation rule** for form requests
- ⚙️ **Runtime email checking** via helper and facade
- 🧩 **Blade directive** support for conditionals
- 🌐 **Auto-sync with remote domain lists**
- 📝 **Add your own custom blacklist** with ease
- ⚡️ **Zero-configuration setup** with publishable config
- ✅ **Compatible with Laravel 8, 9, 10, 11, and 12**
---
## 🚀 Installation
```bash
composer require erag/laravel-disposable-email
```
---
## 🛠 Configuration
Publish the config file:
```bash
php artisan erag:install-disposable-email
```
This will create `config/disposable-email.php`.
---
## ⚙ Usage
### 1. **Form Request Validation**
#### ✅ Custom Rule:
```php
use EragLaravelDisposableEmail\Rules\DisposableEmailRule;
$request->validate([
'email' => ['required', 'email', new DisposableEmailRule()],
]);
```
#### ✅ String-based Rule:
```php
$request->validate([
'email' => 'required|email|disposable_email',
]);
```
```php
$request->validate([
'email' => ['required', 'email', 'disposable_email'],
]);
```
---
### 2. **Direct Runtime Check**
```php
use EragLaravelDisposableEmail\Rules\DisposableEmailRule;
if (DisposableEmailRule::isDisposable('test@tempmail.com')) {
// Do something if email is disposable
}
```
Or via facade:
```php
use DisposableEmail;
if (DisposableEmail::isDisposable('agedmail.com')) {
// Do something
}
```
---
### 3. **Blade Directive**
```blade
@disposableEmail('amit@0-mail.com')
Disposable email detected!
@else
Valid email.
@enddisposableEmail
```
---
## 🔄 Sync From Remote (Optional)
Update the list manually
```bash
php artisan erag:sync-disposable-email-list
```
## 🔗 Config Options (config/disposable-email.php)
```php
return [
'blacklist_file' => storage_path('app/blacklist_file),
'remote_url' => [
'https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt',
'https://raw.githubusercontent.com/7c/fakefilter/refs/heads/main/txt/data.txt',
],
];
```
> ✅ **Note:** The `.txt` files from `remote_url` must follow this format:
> Each line should contain **only a domain name**, like:
```
0-00.usa.cc
0-30-24.com
0-attorney.com
0-mail.com
00-tv.com
00.msk.ru
00.pe
00000000000.pro
000728.xyz
000777.info
00082cc.com
00082dd.com
00082ss.com
```
If the file contains anything other than plain domains (like comments or extra data), it may cause parsing issues.
## 🧩 Add Your Own Disposable Domains
> ✅ **Want to block additional disposable domains?**
> You can **easily extend the list manually** — no coding, no command required!
| Step | Action |
|------|--------|
| 🔹 **1** | Go to the following path:
**`storage/app/blacklist_file/`** |
| 🔹 **2** | Create or edit this file:
**`disposable_domains.txt`** |
| 🔹 **3** | Add your custom domains like:
`abakiss.com`
`fakemail.org`
`trashbox.io`
*(one per line)* |
---
> 📌 **Important Notes:**
- Each line must contain **only the domain name** – no extra symbols, no comments.
- The package will **automatically detect and use** the domains from this file.
- You **do not** need to run any Artisan command. 🧙♂️
---
### ⚙️ Ensure File Path Matches Configuration
Your file path **must match** the one defined in `config/disposable-email.php`:
```php
'blacklist_file' => storage_path('app/blacklist_file'),
```
If the path or filename is different, the package will **not load** your custom list. ✅