PHPackages kolaybi/mail-checker - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. kolaybi/mail-checker ActiveLibrary[Mail & Notifications](/categories/mail) kolaybi/mail-checker ==================== A Laravel package providing e-mail validation for better email delivery. 2.1.1(3mo ago)0408↑10.7%MITPHPPHP ^8.4 Since Jul 22Pushed 3mo agoCompare [ Source](https://github.com/kolaybi/mail-checker)[ Packagist](https://packagist.org/packages/kolaybi/mail-checker)[ RSS](/packages/kolaybi-mail-checker/feed)WikiDiscussions master Synced 3d ago READMEChangelog (10)Dependencies (15)Versions (13)Used By (0) KolayBi Mail Checker ==================== [](#kolaybi-mail-checker) A Laravel package providing comprehensive e-mail validation for better email delivery. Features -------- [](#features) - Validate email format and structure - Check against disposable email domains - Blacklist and whitelist domain support - Integration with external validation services - [AbstractAPI](https://abstractapi.com/) - [Bouncer](https://usebouncer.com/) - [Emailable](https://emailable.com/) - [Hunter](https://hunter.io/) - [Kickbox](https://kickbox.com/) - [MailboxLayer](https://mailboxlayer.com/) - [Mailgun](https://mailgun.com/) - [NeverBounce](https://neverbounce.com/) - Flexible configuration - Detailed exception handling Installation ------------ [](#installation) You can install the package via composer: ``` composer require kolaybi/mail-checker ``` Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --provider="KolayBi\Validation\Mail\ServiceProvider" ``` This will create a `mail-checker.php` configuration file in your application's config directory. ### Environment Variables [](#environment-variables) Configure the following environment variables in your `.env` file: ``` # Local domain lists paths MAIL_CHECKER_WHITELIST_STORAGE_PATH=data/domains/whitelisted_domains.json MAIL_CHECKER_BLACKLIST_STORAGE_PATH=data/domains/blacklisted_domains.json MAIL_CHECKER_DISPOSABLE_STORAGE_PATH=data/domains/disposable_domains.json MAIL_CHECKER_DISPOSABLE_URL=https://rawgit.com/andreis/disposable-email-domains/master/domains.json # Cache configuration MAIL_CHECKER_LOCAL_CACHE_ENABLED=true MAIL_CHECKER_LOCAL_CACHE_TTL=604800 MAIL_CHECKER_LOCAL_CACHE_STORE=file MAIL_CHECKER_EXTERNAL_CACHE_ENABLED=true MAIL_CHECKER_EXTERNAL_CACHE_TTL=86400 MAIL_CHECKER_EXTERNAL_CACHE_STORE=file # External provider configuration MAIL_CHECKER_FAIL_IF_NO_PROVIDERS=true MAIL_CHECKER_EXTERNAL_PROVIDER_PRIORITY=abstract_api,mailboxlayer,mailgun MAIL_CHECKER_EXTERNAL_TIMEOUT=10 # AbstractAPI configuration ABSTRACT_API_EMAIL_ENDPOINT=https://emailvalidation.abstractapi.com/v1/ ABSTRACT_API_EMAIL_API_KEY=your_api_key ABSTRACT_API_EMAIL_TIMEOUT=10 # Bouncer configuration BOUNCER_ENDPOINT=https://api.usebouncer.com/v1.1/email/verify BOUNCER_API_KEY=your_api_key BOUNCER_TIMEOUT=10 # Emailable configuration EMAILABLE_ENDPOINT=https://api.emailable.com/v1/verify EMAILABLE_API_KEY=your_api_key EMAILABLE_TIMEOUT=10 # Hunter configuration HUNTER_VALIDATION_ENDPOINT=https://api.hunter.io/v2/email-verifier HUNTER_API_KEY=your_api_key HUNTER_TIMEOUT=10 # Kickbox configuration KICKBOX_ENDPOINT=https://api.kickbox.com/v2/verify KICKBOX_API_KEY=your_api_key KICKBOX_TIMEOUT=10 # MailboxLayer configuration MAILBOX_LAYER_ENDPOINT=https://apilayer.net/api/check MAILBOX_LAYER_ACCESS_KEY=your_access_key MAILBOX_LAYER_TIMEOUT=10 # Mailgun configuration MAILGUN_VALIDATION_ENDPOINT=https://api.mailgun.net/v4/address/validate MAILGUN_API_KEY=your_api_key MAILGUN_TIMEOUT=10 # NeverBounce configuration NEVER_BOUNCE_VALIDATION_ENDPOINT=https://api.neverbounce.com/v4/single/check NEVER_BOUNCE_API_KEY=your_api_key NEVER_BOUNCE_TIMEOUT=10 ``` Usage ----- [](#usage) ### Basic Validation [](#basic-validation) ``` use KolayBi\Validation\Mail\MailChecker; use KolayBi\Validation\Mail\Exceptions\AbstractMailException; try { MailChecker::check('user@example.com'); // Email is valid } catch (AbstractMailException $e) { // Handle specific validation errors echo $e->getMessage(); } ``` ### Simplified Boolean Check [](#simplified-boolean-check) ``` if (MailChecker::isValid('user@example.com')) { // Email is valid } else { // Email is invalid } ``` ### Skip External Validation [](#skip-external-validation) ``` // Perform only local validation checks MailChecker::check('user@example.com', skipExternalControl: true); ``` ``` // Perform only local validation checks if (MailChecker::isValid('user@example.com', skipExternalControl: true)) { // Email is valid } else { // Email is invalid } ``` ### Advanced Validation Methods [](#advanced-validation-methods) The package provides granular validation methods for specific checks: ``` // Check individual validation aspects if (MailChecker::isWhitelisted('user@example.com')) { // Email domain is in whitelist - trusted domain } if (MailChecker::isBlacklisted('user@example.com')) { // Email domain is explicitly blocked } if (MailChecker::isDisposable('user@example.com')) { // Email is from a temporary/disposable email provider } if (MailChecker::isValidFormat('user@example.com')) { // Email format passes validation checks } // Inverse methods for negative checks if (MailChecker::isNotWhitelisted('user@example.com')) { // Email requires validation (not in trusted whitelist) } if (MailChecker::isNotBlacklisted('user@example.com')) { // Email is not explicitly blocked } if (MailChecker::isNotDisposable('user@example.com')) { // Email is from a permanent email provider } if (MailChecker::isInvalidFormat('user@example.com')) { // Email format is invalid } ``` Exception Types --------------- [](#exception-types) The package throws specific exceptions for different validation scenarios: - `EmptyMailException` - Email address is empty - `InvalidMailException` - Email format is invalid - `BlacklistedMailException` - Domain is blacklisted - `DisposableMailException` - Domain is from a disposable email provider - `InaccessibleMailException` - Failed external validation - `ExternalMailProviderException` - External validation error Command Line Interface ---------------------- [](#command-line-interface) Manage domain lists using artisan commands: ``` # Update disposable domain list from configured URL php artisan mail-checker:update-disposable-domains # Whitelist operations php artisan mail-checker:update-domains --type=whitelist --add=kolaybi.com --add=newdomain.com php artisan mail-checker:update-domains --type=whitelist --remove=oldomain.com php artisan mail-checker:update-domains --type=whitelist --list php artisan mail-checker:update-domains --type=whitelist --add=kolaybi.com --add=newdomain.com --remove=oldomain.com --list # Blacklist operations php artisan mail-checker:update-domains --type=blacklist --add=spam.com php artisan mail-checker:update-domains --type=blacklist --remove=notspam.com php artisan mail-checker:update-domains --type=blacklist --list php artisan mail-checker:update-domains --type=blacklist --add=spam.com --add=fraud.com --remove=notspam.com --list # Cache management php artisan mail-checker:cache-clear # Clear all caches php artisan mail-checker:cache-clear --type=local # Clear only local validation cache php artisan mail-checker:cache-clear --type=external # Clear only external validation cache php artisan mail-checker:cache-clear --type=local --domain-type=whitelist # Clear only whitelist domain cache ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/kolaybi/.github/blob/master/CONTRIBUTING.md) for details. License ------- [](#license) Please see [License File](LICENSE.md) for more information. ### Health Score 45 — FairBetter than 91% of packages Maintenance82 Actively maintained with recent releases Popularity17 Limited adoption so far Community6 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~25 days Recently: every ~60 days Total 11 Last Release 94d ago Major Versions v1.5.2 → v2.0.02026-03-02 ### Community Maintainers ![](https://www.gravatar.com/avatar/55d848a38c4172de8d020b7ebe2a586b41c9924a2d048670a67ddd6c53268fb5?d=identicon)[kolaybi](/maintainers/kolaybi) --- Top Contributors [![uguurozkan](https://avatars.githubusercontent.com/u/6731054?v=4)](https://github.com/uguurozkan "uguurozkan (82 commits)") --- Tags laravelvalidationmailkolaybi ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/kolaybi-mail-checker/health.svg) ``` [![Health](https://phpackages.com/badges/kolaybi-mail-checker/health.svg)](https://phpackages.com/packages/kolaybi-mail-checker) ``` ### Alternatives [propaganistas/laravel-disposable-email Disposable email validator 6023.0M7](/packages/propaganistas-laravel-disposable-email)[laravel/sail Docker files for running a basic Laravel application. 1.9k205.7M1.3k](/packages/laravel-sail)[laravel/ai The official AI SDK for Laravel. 1.0k3.2M201](/packages/laravel-ai)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 77022.3M151](/packages/laravel-mcp)[tallstackui/tallstackui TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications. 725173.2k14](/packages/tallstackui-tallstackui)[erag/laravel-disposable-email A Laravel package to detect and block disposable email addresses. 254168.5k](/packages/erag-laravel-disposable-email) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)