Laravel Disposable Email Detection

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

composer require erag/laravel-disposable-email

---

🛠 Configuration

Publish the config file:

 php artisan erag:install-disposable-email  

This will create config/disposable-email.php.

---

⚙ Usage

1. Form Request Validation

✅ Custom Rule:

use EragLaravelDisposableEmail\Rules\DisposableEmailRule;

$request->validate([
    'email' => ['required', 'email', new DisposableEmailRule()],
]);

✅ String-based Rule:

$request->validate([
    'email' => 'required|email|disposable_email',
]);

$request->validate([
    'email' => ['required', 'email', 'disposable_email'],
]);

---

2. Direct Runtime Check

use EragLaravelDisposableEmail\Rules\DisposableEmailRule;

if (DisposableEmailRule::isDisposable('[email protected]')) {
    // Do something if email is disposable
}

Or via facade:

use DisposableEmail;

if (DisposableEmail::isDisposable('agedmail.com')) {
    // Do something
}

---

3. Blade Directive

@disposableEmail('[email protected]')
    <p class="text-red-600">Disposable email detected!</p>
@else
    <p class="text-green-600">Valid email.</p>
@enddisposableEmail

---

🔄 Sync From Remote (Optional)

Update the list manually

php artisan erag:sync-disposable-email-list

🔗 Config Options (config/disposable-email.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:

'blacklist_file' => storage_path('app/blacklist_file'),

If the path or filename is different, the package will not load your custom list. ✅