0

0

Laravel如何发送邮件_邮件发送功能集成

尼克

尼克

发布时间:2025-10-06 18:03:02

|

497人浏览过

|

来源于php中文网

原创

Laravel发送邮件需先配置mail.php和.env文件,再创建邮件类与Blade视图,最后通过Mail门面发送;支持队列异步处理、附件添加及Markdown模板。

laravel如何发送邮件_邮件发送功能集成

Laravel 中发送邮件,其实就是利用框架提供的 Mail 组件,简化了传统 PHP 发送邮件的复杂流程。核心在于配置好邮件服务,然后使用 Mail facade 或者 Mailer 类来构建和发送邮件。

配置邮件服务,编写邮件逻辑,然后发送,就这么简单。

Laravel 集成邮件发送功能,主要涉及以下几个步骤:

配置邮件服务

首先,你需要配置 config/mail.php 文件。这个文件定义了 Laravel 应用使用的邮件驱动、主机、端口、加密方式、用户名和密码等信息。

常见的邮件驱动有 smtpsendmailmailgunmandrillseslogarraysmtp 适用于大多数场景,你需要根据你选择的邮件服务提供商(例如:Gmail, 阿里云邮件推送等)提供的信息来配置 SMTP 服务器。

例如,使用 Gmail 的配置如下:

'mailers' => [
    'smtp' => [
        'transport' => 'smtp',
        'host' => env('MAIL_HOST', 'smtp.gmail.com'),
        'port' => env('MAIL_PORT', 587),
        'encryption' => env('MAIL_ENCRYPTION', 'tls'),
        'username' => env('MAIL_USERNAME'), // 你的 Gmail 邮箱地址
        'password' => env('MAIL_PASSWORD'), // 你的 Gmail 邮箱密码或应用专用密码
        'timeout' => null,
        'local_domain' => env('MAIL_EHLO_DOMAIN'),
    ],
],

'from' => [
    'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'), // 默认发件人邮箱
    'name' => env('MAIL_FROM_NAME', 'Example'), // 默认发件人名称
],

记得在 .env 文件中设置相应的环境变量,比如 MAIL_HOSTMAIL_PORTMAIL_USERNAMEMAIL_PASSWORD。 特别注意,Gmail 可能需要你启用 "允许不太安全的应用访问" 或者设置应用专用密码。

创建邮件类

接下来,你需要创建一个邮件类,用于定义邮件的内容和格式。可以使用 Artisan 命令 php artisan make:mail YourMailClass 来生成一个邮件类。

例如,创建一个名为 OrderShipped 的邮件类:

php artisan make:mail OrderShipped

这会在 app/Mail 目录下生成 OrderShipped.php 文件。

打开 OrderShipped.php 文件,你会看到一个构造函数和一个 build 方法。在构造函数中,你可以传递需要在邮件模板中使用的数据。在 build 方法中,你可以指定邮件的主题、发件人、收件人、邮件视图等。

order = $order;
    }

    /**
     * Build the message.
     *
     * @return $this
     */
    public function build()
    {
        return $this->from('example@example.com', 'Example')
                    ->subject('Your Order Has Shipped!')
                    ->view('emails.orders.shipped')
                    ->with([
                        'order_id' => $this->order->id,
                    ]);
    }
}

在这个例子中,我们传递了一个 $order 对象到构造函数中,并在 build 方法中使用了 view 方法来指定邮件视图,并使用 with 方法将数据传递给视图。

创建邮件视图

邮件视图是一个 Blade 模板,用于定义邮件的 HTML 内容。你需要在 resources/views/emails/orders 目录下创建一个名为 shipped.blade.php 的文件。



Order Shipped!

Your order with ID {{ $order_id }} has been shipped.

Thank you for your order!

发送邮件

最后,你可以使用 Mail facade 或 Mailer 类来发送邮件。

小邮包 包月订购包年程序
小邮包 包月订购包年程序

小邮包-包月订购包年服务网,该程序由好买卖商城开发,程序采用PHP+MYSQL架设,程序商业模式为目前最为火爆的包月订制包年服务模式,这种包年订购在国外网站已经热火很多年了,并且已经发展到一定规模,像英国的男士用品网站BlackSocks,一年的袜子购买量更是达到了1000万双。功能:1、实现多产品上线,2、不用注册也可以直接下单购买,3、集成目前主流支付接口,4、下单发货均有邮件提醒。

下载

使用 Mail facade:

use Illuminate\Support\Facades\Mail;
use App\Mail\OrderShipped;

$order = App\Models\Order::find(1);

Mail::to('recipient@example.com')->send(new OrderShipped($order));

或者,使用 Mailer 类:

use Illuminate\Contracts\Mail\Mailer;
use App\Mail\OrderShipped;

$order = App\Models\Order::find(1);

app(Mailer::class)->to('recipient@example.com')->send(new OrderShipped($order));

这两种方式都会发送一封邮件到 recipient@example.com,邮件内容是 emails.orders.shipped 视图渲染后的 HTML。

如何处理邮件发送失败?

Laravel 提供了队列功能,可以将邮件发送任务放入队列中异步执行。这样可以避免邮件发送失败阻塞用户请求,并提高应用的响应速度。

你可以使用 Artisan 命令 php artisan queue:work 来启动队列监听器。

此外,你还可以使用 try-catch 块来捕获邮件发送异常,并进行相应的处理,例如记录日志、重试发送等。

use Illuminate\Support\Facades\Mail;
use App\Mail\OrderShipped;
use Exception;

$order = App\Models\Order::find(1);

try {
    Mail::to('recipient@example.com')->send(new OrderShipped($order));
} catch (Exception $e) {
    \Log::error('Failed to send email: ' . $e->getMessage());
    // 可以选择重试发送,或者通知管理员
}

如何测试邮件发送?

在开发环境中,你可能不想真的发送邮件。Laravel 提供了两种测试邮件发送的方式:

  1. 使用 log 驱动:将 config/mail.php 中的 driver 设置为 log。这样,所有发送的邮件都会被记录到 Laravel 的日志文件中。
  2. 使用 array 驱动:将 config/mail.php 中的 driver 设置为 array。这样,所有发送的邮件都会被存储到一个内存数组中,你可以使用 Mail::failures() 方法来检查是否有邮件发送失败。

邮件模板最佳实践是什么?

  1. 使用 Blade 模板引擎: Blade 模板引擎提供了简洁、强大的语法,可以方便地创建动态邮件内容。
  2. 保持简洁: 邮件内容应该简洁明了,避免使用过多的图片和复杂的设计。
  3. 使用纯文本版本: 为邮件提供一个纯文本版本,以确保邮件可以在不支持 HTML 的邮件客户端中正确显示。
  4. 测试邮件在不同客户端中的显示效果: 不同的邮件客户端对 HTML 和 CSS 的支持程度不同,因此需要测试邮件在不同客户端中的显示效果,以确保邮件可以正确显示。
  5. 遵循邮件营销最佳实践: 遵循邮件营销最佳实践,例如使用清晰的主题行、避免使用垃圾邮件敏感词汇等,以提高邮件的送达率。

如何发送带附件的邮件?

在邮件类的 build 方法中使用 attach 方法来添加附件。

public function build()
{
    return $this->from('example@example.com', 'Example')
                ->subject('Your Order Has Shipped!')
                ->view('emails.orders.shipped')
                ->attach('/path/to/your/file.pdf', [
                    'as' => 'order_details.pdf',
                    'mime' => 'application/pdf',
                ]);
}

attach 方法接受文件路径作为第一个参数,可选的第二个参数是一个数组,用于指定附件的名称和 MIME 类型。

如何使用 Markdown 模板?

Laravel 提供了 Markdown 邮件模板,可以让你使用 Markdown 语法来编写邮件内容。

首先,你需要创建一个 Markdown 邮件模板,例如 resources/views/emails/orders/shipped.md

# Order Shipped!

Your order with ID {{ $order_id }} has been shipped.

Thank you for your order!

然后,在邮件类的 build 方法中使用 markdown 方法来指定 Markdown 邮件模板:

public function build()
{
    return $this->from('example@example.com', 'Example')
                ->subject('Your Order Has Shipped!')
                ->markdown('emails.orders.shipped')
                ->with([
                    'order_id' => $this->order->id,
                ]);
}

Laravel 会自动将 Markdown 模板转换为 HTML 邮件内容。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

319

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

278

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

372

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

374

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

85

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

65

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

68

2025.08.05

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

141

2026.01.28

包子漫画在线官方入口大全
包子漫画在线官方入口大全

本合集汇总了包子漫画2026最新官方在线观看入口,涵盖备用域名、正版无广告链接及多端适配地址,助你畅享12700+高清漫画资源。阅读专题下面的文章了解更多详细内容。

24

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号