Lar*el如何发送邮件？（Mailgun和SMTP配置教程）_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Lar*el如何发送邮件？（Mailgun和SMTP配置教程）

2025-12-13

浏览次数：次

返回列表

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

laravel如何发送邮件？（mailgun和smtp配置教程）

在 Lar*el 中发送邮件，核心是配置邮件驱动（如 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('Lar*el 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 驱动配置完整（Lar*el 9+ 默认已含，无需额外改）
验证域名后，先用 Mailgun 控制台发一封测试邮件，确认 DNS 和验证状态正常，再切回 Lar*el 测试

写一个可复用的 Mailable 类

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

DeepBrain

AI视频生成工具，ChatGPT +生成式视频AI =你可以制作伟大的视频!

146 查看详情 DeepBrain

生成类：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/lar*el.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