Laravel如何发送邮件？（Mailgun和SMTP配置教程）_网络技术

Laravel发邮件需正确配置驱动（SMTP或Mailgun）并使用Mailable类，SMTP常用QQ邮箱（授权码非密码）、Mailgun需域名验证；调试关键在环境配置、加密方式、域名状态及队列监听。

在 Laravel 中发送邮件，核心是配置邮件驱动（如 SMTP 或 Mailgun），再通过 Mailable 类封装内容，最后用 Mail::send() 或 Mail::to()->send() 发出。关键不在“能不能发”，而在“配得对不对、发得稳不稳”。

SMTP 配置：用 QQ 邮箱或企业邮箱最常见

多数人首选 SMTP，因为可控性强、调试直观。以 QQ 邮箱为例（需开启 POP3/SMTP 服务并获取授权码）：

修改 .env 文件：

MAIL_MAILER=smtp
MAIL_HOST=smtp.qq.com
MAIL_PORT=587
MAIL_USERNAME=your_email@qq.com
MAIL_PASSWORD=your_app_password  # 注意：不是登录密码，是邮箱生成的授权码
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email@qq.com
MAIL_FROM_NAME="${APP_NAME}"

运行 php artisan config:clear 清除配置缓存，否则改了 .env 也不生效

测试是否通：终端执行 php artisan tinker，然后输入：

use Illuminate\Support\Facades\Mail;
Mail::raw('测试邮件内容', function ($message) {
    $message->to('target@example.com')->subject('Laravel SMTP 测试');
});

如果没报错，邮

箱收到信，说明 SMTP 配通了

Mailgun 配置：适合批量、追踪和高可靠性场景

Mailgun 提供 API 密钥、域名验证和发送日志，适合正式项目。前提是已注册 Mailgun 账户，并完成域名验证（如 mg.yoursite.com）：

在 .env 中填入 Mailgun 参数：

MAIL_MAILER=mailgun
MAILGUN_DOMAIN=mg.yoursite.com
MAILGUN_SECRET=key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MAILGUN_ENDPOINT=https://api.mailgun.net/v3

确保 config/mail.php 中 mailgun 驱动配置完整（Laravel 9+ 默认已含，无需额外改）
验证域名后，先用 Mailgun 控制台发一封测试邮件，确认 DNS 和验证状态正常，再切回 Laravel 测试

写一个可复用的 Mailable 类

别总用 Mail::raw()，结构化邮件更易维护：

生成类：php artisan make:mail WelcomeEmail

在 app/Mail/WelcomeEmail.php 中定义数据和视图：

public function __construct(public string $name) {}
public function build()
{
    return $this->view('emails.welcome')->with(['name' => $this->name]);
}

创建视图 resources/views/emails/welcome.blade.php，用 Blade 写 HTML 邮件模板
发送时调用：Mail::to('user@example.com')->send(new WelcomeEmail('张三'));

调试与排错要点

发不出邮件？90% 是这几个地方卡住：

环境没切对：本地开发用 MAIL_MAILER=log 先看日志是否生成（storage/logs/laravel.log），避免直接怼生产配置
SSL/TLS 混用：QQ 邮箱用 MAIL_PORT=587 + MAIL_ENCRYPTION=tls；若用 465 端口，则改 ssl，且部分 PHP 版本需额外启用 openssl 扩展
Mailgun 域名未验证或未启用：控制台里看 Domain Status 是否为 “Active”，Sending Access 是否开启
队列没跑：如果用了 ->queue()，记得启动队列监听：php artisan queue:work

基本上就这些。配对驱动、写好 Mailable、看清错误日志，Laravel 发邮件不复杂但容易忽略细节。

# php # word # laravel # html # cad # app # access # 端口 # qq # ssl # ai # dns # 邮箱 # 封装 # mail

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】