Download the PHP package martian/spammailchecker without Composer

Laravel SpamMailChecker

A powerful Laravel package designed to effortlessly validate email addresses against various spam mail providers using a diverse range of drivers. Seamlessly integrated with Laravel's validation system, this package offers comprehensive support for validating email inputs in forms and RESTful APIs

Supported Email Validation Services

NOTE: More services will be added soon. (You can also contribute to this project by adding more services - ZeroBounce, Mailboxlayer, EmailListVerify, Emailable, etc)

Installation

You can install the package via composer:

• If you are going to be using the facade, you'll need to register it as well. Open config/app.php and add the following line to the aliases array:

Publish Configuration File

Publish the configuration file using the following command:

Configuration

The configuration file is located at config/laravel-spammail-checker.php. You may configure the package to use any of the supported drivers. The default driver is local which uses a local text list of spam email domains.

Local Driver Configuration

• In order to use localas your driver of choice, you need to set the default key in the config/laravel-spammail-checker.php configuration file to local:

• Or you can set the SPAM_MAIL_CHECKER_DEFAULT_DRIVER environment variable to local in your .env file.

• The local driver uses a local text list of spam email domains. The file is located at resources/config/emails.txt. You can include more domains by adding them to the blacklist array or exclude domains by adding them to the whitelist array.

• Clear the config and cache using the following commands after making changes to the configuration file:

NOTE: The local driver is case-insensitive. So, you don't need to worry about the case of the email domain.

Remote Driver Configuration

• In order to use remote as your driver of choice, you need to set the default key in the config/laravel-spammail-checker.php configuration file to remote:

• Or you can set the SPAM_MAIL_CHECKER_DEFAULT_DRIVER environment variable to remote in your .env file.

• The remote driver uses PHP In-built functions getmxrr(), checkdnsrr(). fsockopen() to validate email domain. You can configure the remote driver on whether to check for MX - getmxrr(), DNS - checkdnsrr(), and SMTP -fsockopen or validate email domain. You can also configure the timeout value in seconds.

AbstractApi Driver Configuration

• In order to use abstractapi as your driver of choice, you need to set the default key in the config/laravel-spammail-checker.php configuration file to abstractapi:

• Or you can set the SPAM_MAIL_CHECKER_DEFAULT_DRIVER environment variable to abstractapi in your .env file.

• Add your ABSTRACTAPI_API_KEY AbstractAPI key you got from here to your env file.

• You can configure the score to determine the threshold for a valid email address. The score ranges from 0 to 1. The higher the score, the more likely the email address is valid. You can also accept disposable email addresses by setting accept_disposable to true.

QuickEmailVerification Driver Configuration

• In order to use quickemailverification as your driver of choice, you need to set the default key in the config/laravel-spammail-checker.php configuration file to quickemailverification:

• Or you can set the SPAM_MAIL_CHECKER_DEFAULT_DRIVER environment variable to quickemailverification in your .env file.

• Add your QUICKEMAILVERIFICATION_API_KEY QuickEmailVerification key you got from here to your env file.

• You can configure the driver to accept disposable email addresses by setting accept_disposable to true.

Verifalia Driver Configuration

• In order to use verifalia as your driver of choice, you need to set the default key in the config/laravel-spammail-checker.php configuration file to verifalia:

• Or you can set the SPAM_MAIL_CHECKER_DEFAULT_DRIVER environment variable to verifalia in your .env file.

• In order to use verifalia service, you need to set login credentials in your env file. You can get your credentials from after you create a user here.

• You can configure the driver to accept disposable email addresses by setting accept_disposable to true.

NOTE: A user on verifalia needs to be granted permission to use the API. You can do this by going here and clicking on the edit user you want to grant permission to. Then click on the Permissions tab and check the appropriate permissions on Email validations section.

SendGrid Driver Configuration

• In order to use sendgrid as your driver of choice, you need to set the default key in the config/laravel-spammail-checker.php configuration file to sendgrid:

• Or you can set the SPAM_MAIL_CHECKER_DEFAULT_DRIVER environment variable to sendgrid in your .env file.

• Add your SENDGRID_API_KEY Sendgrid key you got from here to your env file.

• You can configure the driver to accept disposable email addresses by setting accept_disposable to true. Score can also be configured to determine the threshold for a valid email address. The score ranges from 0 to 1. The higher the score, the more likely the email address is valid. Source can also be configured to determine the source of the email address. The source can be signup or contact.

Usage

In order to use the package, you need to call the spammail validation rule in your validation rules. You can also change the rule name to whatever you want in the config/laravel-spammail-checker.php configuration file under the rule key, likewise the error message under the error_message key.

Or make use of spammail in your Requests file like this:

Adding Custom Error Message

A custom error message can be added to the spammail validation rule.

Or you can change the error message in the config/laravel-spammail-checker.php configuration file under the error_message key.

Using Classes Directly

You can also use the classes directly without using the spammail validation rule. This is useful when you want to use the package in your own custom validation rule or your own custom class.

Using Facade

You can also use the SpamMailChecker class directly without instantiating it.

Using Each Driver Individually

You can also use each driver individually without using the spammail validation rule. This is useful when a certain driver is needed in a particular situation.

Using VerifaliaDriver

Using SendGridDriver

Using AbstractApiDriver

Using RemoteDriver

Using LocalDriver

Using QuickEmailVerificationDriver

Testing

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please feel free to fork this project and make a pull request. For more information check CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Josiah Endurance
• All Contributors

License

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