在Laravel中实现邮箱真实性验证：利用Trumail API确保邮箱可达性

{
  "address": "test@example.com",
  "username": "test",
  "domain": "example.com",
  "md5": "5a105e8b9d40e1329780d62ea2265d8a",
  "format_valid": true,
  "deliverable": true,
  "full_inbox": false,
  "host_exists": true,
  "mx_records": [
    "mail.example.com"
  ],
  "smtp_valid": true,
  "catch_all": false,
  "disposable": false,
  "free": false
}

use Illuminate\Support\Facades\Http;

// ... 在你的服务或控制器中
$emailToValidate = 'user@example.com';
$response = Http::get("https://api.trumail.io/v2/lookups/json?email={$emailToValidate}");

if ($response->successful()) {
    $data = $response->json();
    if (isset($data['deliverable']) && $data['deliverable'] === true) {
        // 邮箱真实存在
    } else {
        // 邮箱不存在或不可达
    }
} else {
    // API请求失败，处理错误
}

php artisan make:rule RealEmail

<?php

namespace App\Rules;

use Closure;
use Illuminate\Contracts\Validation\ValidationRule;
use Illuminate\Support\Facades\Http;

class RealEmail implements ValidationRule
{
    /**
     * Run the validation rule.
     *
     * @param  \Closure(string): \Illuminate\Translation\PotentiallyTranslatedString  $fail
     */
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        // 确保是有效的邮箱格式，虽然Trumail也会检查，但本地预检可以减少不必要的API调用
        if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
            $fail('The :attribute must be a valid email address.');
            return;
        }

        try {
            $response = Http::timeout(5) // 设置超时时间，防止API响应过慢
                            ->get("https://api.trumail.io/v2/lookups/json?email={$value}");

            if ($response->failed()) {
                // API请求失败，可能是网络问题或API服务不可用
                // 可以选择抛出异常或将此视为验证失败
                \Log::error("Trumail API request failed for email: {$value}", ['status' => $response->status()]);
                $fail('Could not verify the email address at this time. Please try again later.');
                return;
            }

            $data = $response->json();

            // 检查API响应中是否存在'deliverable'字段且其值为true
            if (!isset($data['deliverable']) || $data['deliverable'] !== true) {
                $fail('The :attribute is not a real or deliverable email address.');
            }
        } catch (\Exception $e) {
            // 捕获HTTP请求过程中可能发生的异常
            \Log::error("Exception during Trumail API call for email: {$value}", ['exception' => $e->getMessage()]);
            $fail('An error occurred while verifying the email address. Please try again later.');
        }
    }
}

// app/Http/Requests/RegisterUserRequest.php
<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use App\Rules\RealEmail; // 引入自定义规则

class RegisterUserRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'name' => ['required', 'string', 'max:255'],
            'email' => ['required', 'string', 'email', 'max:255', 'unique:users', new RealEmail], // 添加RealEmail规则
            'password' => ['required', 'string', 'min:8', 'confirmed'],
        ];
    }
}

use Illuminate\Support\Facades\Validator;
use App\Rules\RealEmail;

$validator = Validator::make($request->all(), [
    'email' => ['required', 'email', new RealEmail],
]);

if ($validator->fails()) {
    // 验证失败
}