[TOC]
### **1、简介**
[Laravel](http://laravelacademy.org/tags/laravel "View all posts in Laravel") 基于 [SwiftMailer](http://swiftmailer.org/) 库提供了一套干净清爽的[邮件](http://laravelacademy.org/tags/%e9%82%ae%e4%bb%b6 "View all posts in 邮件")API。Laravel为[SMTP](http://laravelacademy.org/tags/smtp "View all posts in SMTP")、[Mailgun](http://laravelacademy.org/tags/mailgun "View all posts in Mailgun")、Mandrill、Amazon SES、PHP 的`mail`函数，以及`sendmail`提供了驱动，从而允许你快速通过本地或云服务发送邮件。
#### **邮件驱动预备知识**
基于驱动的 API 如 [Mail](http://laravelacademy.org/tags/mail "View all posts in Mail")gun 和 Mandrill 通常比 SMTP 服务器更简单、更快。所有的 API 驱动要求应用已经安装 Guzzle HTTP 库。你可以通过添加如下行到`composer.json`文件来安装 Guzzle 到项目：
~~~
"guzzlehttp/guzzle": "~5.3|~6.0"
~~~
##### **Mailgun驱动**
要使用 Mailgun 驱动（Mailgun 前10000封邮件免费，后续收费），首先安装 Guzzle，然后在配置文件`config/mail.php`中设置`driver`选项为`mailgun`。接下来，验证配置文件`config/services.php`包含如下选项：
~~~
'mailgun' => [
'domain' => 'your-mailgun-domain',
'secret' => 'your-mailgun-key',],
~~~
##### **Mandrill驱动**
要使用 Mandrill 驱动（Mandrill不支持中国区用户注册，汗！），首先安装 Guzzle，然后在配置文件`config/mail.php`中设置`driver`选项值为`mandrill`。接下来，验证配置文件`config/services.php`包含如下选项：
~~~
'mandrill' => [
'secret' => 'your-mandrill-key',],
~~~
##### **SES驱动**
要使用 Amazon SES 驱动（收费），安装 Amazon AWS 的 PHP SDK，你可以通过添加如下行到`composer.json`文件的`require`部分来安装该库：
~~~
"aws/aws-sdk-php": "~3.0"
~~~
接下来，设置配置文件`config/mail.php`中的`driver`选项为`ses`。然后，验证配置文件`config/services.php`包含如下选项：
~~~
'ses' => [
'key' => 'your-ses-key',
'secret' => 'your-ses-secret',
'region' => 'ses-region', // e.g. us-east-1
],
~~~
### **2、发送邮件**
Laravel 允许你在[视图](http://laravelacademy.org/post/2855.html)中存储邮件信息，例如，要组织你的电子邮件，可以在`resources/views`目录下创建`emails`目录。
要发送一条信息，使用`Mail`[门面](http://laravelacademy.org/post/2920.html)上的`send`方法。`send`方法接收三个参数。第一个参数是包含邮件信息的[视图](http://laravelacademy.org/tags/%e8%a7%86%e5%9b%be "View all posts in 视图")名称；第二个参数是你想要传递到该视图的数组数据；第三个参数是接收消息实例的闭包回调——允许你自定义收件人、主题以及邮件其他方面的信息：
~~~
<?php
namespace App\Http\Controllers;
use Mail;
use App\User;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
class UserController extends Controller{
/**
* 发送邮件给用户
*
* @param Request $request
* @param int $id
* @return Response
*/
public function sendEmailReminder(Request $request, $id)
{
$user = User::findOrFail($id);
Mail::send('emails.reminder', ['user' => $user], function ($m) use ($user) {
$m->from('hello@app.com', 'Your Application');$m->to($user->email, $user->name)->subject('Your Reminder!');
});
}
}
~~~
由于我们在上例中传递一个包含`user`键的数组，我们可以在邮件中使用如下方式显示用户名：
~~~
<?php echo $user->name; ?>
~~~
> 注意：`$message`变量总是被传递到邮件视图，并允许嵌入[附件](http://laravelacademy.org/tags/%e9%99%84%e4%bb%b6 "View all posts in 附件")，因此，你应该在视图负载中避免传入消息变量。
##### **构造消息**
正如前面所讨论的，传递给`send`方法的第三个参数是一个允许你指定邮件消息本身多个选项的闭包。使用这个闭包可以指定消息的其他属性，例如抄送、群发，等等：
~~~
Mail::send('emails.welcome', $data, function ($message) {
$message->from('us@example.com', 'Laravel');
$message->to('foo@example.com')->cc('bar@example.com');
});
~~~
下面试`$message`消息构建器实例上的可用方法：
~~~
$message->from($address, $name = null);
$message->sender($address, $name = null);
$message->to($address, $name = null);
$message->cc($address, $name = null);
$message->bcc($address, $name = null);
$message->replyTo($address, $name = null);
$message->subject($subject);
$message->priority($level);
$message->attach($pathToFile, array $options = []);
// 从$data字符串追加文件...
$message->attachData($data, $name, array $options = []);
// 获取底层SwiftMailer消息实例...
$message->getSwiftMessage();
~~~
> 注意：传递给`Mail::send`闭包的消息实例继承自`SwiftMailer`消息类，该实例允许你调用该类上的任何方法来构建自己的电子邮件消息。
##### **纯文本邮件**
默认情况下，传递给`send`方法的视图假定包含HTML，然而，通过传递数组作为第一个参数到`send`方法，你可以指定发送除HTML视图之外的纯文本视图：
~~~
Mail::send(['html.view', 'text.view'], $data, $callback);
~~~
或者，如果你只需要发送纯文本邮件，可以指定在数组中使用text键：
~~~
Mail::send(['text' => 'view'], $data, $callback);
~~~
##### **原生字符串邮件**
如果你想要直接发送原生字符串邮件你可以使用`raw`方法：
~~~
Mail::raw('Text to e-mail', function ($message) {
//
});
~~~
#### **2.1 附件**
要添加附件到邮件，使用传递给闭包的`$message`对象上的`attach`方法。该方法接收文件的绝对路径作为第一个参数：
~~~
Mail::send('emails.welcome', $data, function ($message) {
//
$message->attach($pathToFile);
});
~~~
当添加文件到消息时，你还可以通过传递数组作为第二个参数到`attach`方法来指定文件显示名和MIME类型：
~~~
$message->attach($pathToFile, ['as' => $display, 'mime' => $mime]);
~~~
#### **2.2 内联附件**
##### **在邮件视图中嵌入一张图片**
嵌套内联图片到邮件中通常是很笨重的，然而，Laravel提供了一个便捷的方式附加图片到邮件并获取相应的CID，要嵌入内联图片，在邮件视图中使用`$message`变量上的`embed`方法。记住，Laravel自动在所有邮件视图中传入`$message`变量使其有效：
~~~
<body>
Here is an image:
<img src="<?php echo $message->embed($pathToFile); ?>">
</body>
~~~
##### **在邮件视图中嵌入原生数据**
如果你想要在邮件消息中嵌入原生数据字符串，可以使用`$message`变量上的`embedData`方法：
~~~
<body>
Here is an image from raw data:
<img src="<?php echo $message->embedData($data, $name); ?>">
</body>
~~~
#### **2.3 邮件[队列](http://laravelacademy.org/tags/%e9%98%9f%e5%88%97 "View all posts in 队列")**
##### **邮件消息队列**
发送邮件消息可能会大幅度延长应用的响应时间，许多开发者选择将[邮件发送](http://laravelacademy.org/tags/%e9%82%ae%e4%bb%b6%e5%8f%91%e9%80%81 "View all posts in 邮件发送")放到队列中再后台执行，Laravel中可以使用内置的统一队列API来实现。要将邮件消息放到队列中，使用`Mail`门面上的`queue`方法：
~~~
Mail::queue('emails.welcome', $data, function ($message) {
//
});
~~~
该方法自动将邮件任务推送到队列中以便在后台发送。当然，你需要在使用该特性前配置队列。
##### **延迟消息队列**
如果你想要延迟已经放到队列中邮件的发送，可以使用`later`方法。只需要传递你想要延迟发送的秒数作为第一个参数到该方法即可：
~~~
Mail::later(5, 'emails.welcome', $data, function ($message) {
//
});
~~~
##### **推入指定队列**
如果你想要将邮件消息推送到指定队列，可以使用`queueOn`和`laterOn`方法：
~~~
Mail::queueOn('queue-name', 'emails.welcome', $data, function ($message) {
//
});
Mail::laterOn('queue-name', 5, 'emails.welcome', $data, function ($message) {
//
});
~~~
### **3、邮件&本地开发**
开发发送邮件的应用时，你可能不想要真的发送邮件到有效的电子邮件地址，而只是想要做下测试。Laravel提供了几种方式“禁止”邮件的实际发送。
##### **日志驱动**
一种解决方案是在本地开发时使用`log`邮件驱动。该驱动将所有邮件信息写到日志文件中以备查看，想要了解更多关于每个环境的应用配置信息，查看[配置文档](http://laravelacademy.org/post/2726.html#environment-configuration)。
##### **通用配置**
Laravel提供的另一种解决方案是为框架发送的所有邮件设置通用收件人，这样的话，所有应用生成的邮件将会被发送到指定地址，而不是实际发送邮件指定的地址。这可以通过在配置文件`config/mail.php`中设置`to`选项来实现：
~~~
'to' => [
'address' => 'dev@domain.com',
'name' => 'Dev Example'
],
~~~
##### **[Mailtrap](http://laravelacademy.org/tags/mailtrap "View all posts in Mailtrap")**
最后，你可以使用[Mailtrap](https://mailtrap.io/)服务和`smtp`驱动发送邮件信息到“虚拟”邮箱，这种方法允许你在Mailtrap的消息查看器中查看最终的邮件。
### **4、[事件](http://laravelacademy.org/tags/%e4%ba%8b%e4%bb%b6 "View all posts in 事件")**
Laravel 会发送邮件前触发一个事件，记住，这个事件是在邮件被发送时触发，而不是推送到队列时，你可以在`EventServiceProvider` 中注册事件监听器：
~~~
/**
* The event listener mappings for the application.
*
* @var array
*/
protected $listen = [
'Illuminate\Mail\Events\MessageSending' => [
'App\Listeners\LogSentMessage',
],
];
~~~
- 序言
- 发行版本说明
- 升级指南
- 贡献代码
- 开始
- 安装
- 配置
- Laravel Homestead
- 基础
- HTTP 路由
- HTTP 中间件
- HTTP 控制器
- HTTP 请求
- HTTP 响应
- 视图
- Blade 模板引擎
- 架构
- 一次请求的生命周期
- 应用目录结构
- 服务提供者
- 服务容器
- 门面（Facades）
- 数据库
- 起步
- 查询构建器
- 迁移
- 填充数据
- Eloquent ORM
- 起步
- 关联关系
- 集合
- 访问器&修改器
- 序列化
- 服务
- 用户认证
- 用户授权
- Artisan Console
- 订阅支付实现：Laravel Cashier
- 缓存
- 集合
- 集成前端资源：Laravel Elixir
- 加密
- 错误&日志
- 事件
- 文件系统/云存储
- 哈希
- 辅助函数
- 本地化
- 邮件
- 包开发
- 分页
- Redis
- 队列
- Session
- Envoy Task Runner
- 任务调度
- 测试
- 验证
- 新手入门指南
- 简单任务管理系统
- 带用户功能的任务管理系统