Merge pull request #4 from iamfaysal/master

Mailbox Verification added to return accurate validation result

Author: overint

README.md

@@ -31,20 +31,17 @@ Example Use Case
 
     echo var_dump($validator->validateExtended('[email protected]'));
 
-    //      object(stdClass)#2 (4) {
-    //        ["address"]=>
-    //        string(19) "[email protected]"
-    //        ["did_you_mean"]=>
-    //        NULL
-    //        ["is_valid"]=>
-    //        bool(true)
-    //        ["parts"]=>
-    //        object(stdClass)#4 (3) {
-    //          ["display_name"]=>
-    //          NULL
-    //          ["domain"]=>
-    //          string(10) "ymail.com"
-    //          ["local_part"]=>
-    //          string(8) "someuser"
-    //        }
-    //      }
+     object(stdClass)#207 (8) { 
+        ["address"]=> string(18) "[email protected]" 
+        ["did_you_mean"]=> NULL 
+        ["is_disposable_address"]=> bool(false) 
+        ["is_role_address"]=> bool(false) 
+        ["is_valid"]=> bool(true) 
+        ["mailbox_verification"]=> string(4) "true" 
+        ["parts"]=> object(stdClass)#208 (3) { 
+            ["display_name"]=> NULL 
+            ["domain"]=> string(9) "ymail.com" 
+            ["local_part"]=> string(8) "someuser" 
+        } 
+        ["reason"]=> NULL 
+    }

src/MailgunValidator.php

@@ -31,7 +31,7 @@ private function queryMailgun($email)
         $curl = curl_init();
 
         curl_setopt_array($curl, array(
-            CURLOPT_URL => self::API_ENDPOINT . "?api_key=" . $this->apiKey .  "&address=" . urlencode($email),
+            CURLOPT_URL => self::API_ENDPOINT . "?api_key=" . $this->apiKey .  "&address=" . urlencode($email) . '&mailbox_verification=true',
             CURLOPT_RETURNTRANSFER => true,
             CURLOPT_MAXREDIRS => 0,
             CURLOPT_TIMEOUT => 30,
@@ -58,7 +58,7 @@ private function queryMailgun($email)
     public function validate($email)
     {
         $ret = $this->queryMailgun($email);
-        return $ret->is_valid;
+        return $ret->is_valid === true && $ret->mailbox_verification !== false;
     }
 
     /**