Init commit

Author: TheoKouzelis

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Theo Kouzelis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,48 @@
+# Laravel Validator Rules - Email Validation Mailgun 
+A email validation that uses the [Mailgun API](https://documentation.mailgun.com/en/latest/api-email-validation.html#email-validation) for a three-step validation check.  
+
+To find examples of how validation rules can be applied in the Laravel framework, please view the [validation docs](https://laravel.com/docs/5.6/validation).
+
+## Install
+Require via composer.
+```
+composer require kouz/laravel-mailgun-email-validation
+```
+For Laravel >=5.5 the package will be discoverd. For Laravel <=5.4 add package to list of service providers in config/app.php
+```
+<?php
+  //config/app.php
+  
+    'providers' => [
+        Kouz\LaravelMailgunValidation\ServiceProvider::class,
+    ],
+```
+Publish and fill out the config/mailgun-email-validation.php file with your Mailgun API key.
+```
+php artisan vendor:publish --provider="Kouz\LaravelMailgunValidation\ServiceProvider"
+```
+
+## Basic Usage
+Use the following rule to validate your email fields. The rule will first check the address against 
+PHP's [FILTER_VALIDATE_EMAIL](http://php.net/manual/en/filter.filters.validate.php) and then will call 
+the Mailgun API.
+
+**mailgun_email:role,disposable,mailbox,strict**  
+The field under validation must be formatted as an e-mail address. The following flags can be added to
+apply additional validation:
+
+* **role** Don't allow role-based addresses.
+* **disposable** Don't allow disposable email domains.
+* **mailbox** Verify mailbox. Add strict flag to ensure that Mailgun was able to verify a mailbox and didn't return "Unknown".
+* **strict** Always require a response from Mailgun to validate. By default if a API request fails, the validation will pass. The strict flag ensures that a Mailgun response was recieved.
+
+## License
+This project is licensed under a MIT License which you can find
+[in this LICENSE](https://github.com/TheoKouzelis/laravel-mailgun-email-validation/blob/master/LICENSE).
+
+## Feedback
+If you have any feedback, comments or suggestions, please feel free to open an issue within this repository.
+
+## Laravel Validation Rules
+This package is part of the Laravel Validation Rules collection. If you're after more useful validation rules, 
+head to the [Laravel Validation Rules](https://laravel-validation-rules.github.io/) website.

composer.json

@@ -0,0 +1,9 @@
+{
+    "name": "laravel-validation-rules/email-validation-mailgun",
+    "description": "Metapackage for https://github.com/TheoKouzelis/laravel-mailgun-email-validation",
+    "type": "metapackage",
+    "require": {
+        "kouz/laravel-mailgun-email-validation": "^1.0"
+    },
+    "license": "MIT"
+}