利用Laravel自带SMTP邮件组件实现发送邮件

讲在前面

此教程是笔者通过laravel学院的教程的学习总结，总结了几个错误，以及laravel学院中没讲到的点。laravel学院真心不错，推荐给大家。

laravel自带SwiftMailer库，集成了多种邮件API，可以很方便的实现邮件的发送。在本教程中使用到的是SMTP（Simple Message Transfer Protocol）简单邮件传输协议，通常理解为邮件发送服务器。

实验使用邮箱的163，QQ邮箱

需要注意的是：使用QQ邮箱的话，需要开启POP3和SMTP服务。开启方式如下：

QQ邮箱 > 设置 > 账户

需要开启服务.png

当开启成功会生成密钥，这个东西会在配置中用到

生成密钥.png

开始进行配置

我试验的laravel项目名称为《laravel》

# 编辑邮件配置文件
$ vim laravel/config/mail.php

# mail.php
return [
  'driver' => env('MAIL_DRIVER', 'smtp'),
  'host' => env('MAIL_HOST', 'smtp.163.com'),
  'port' => env('MAIL_PORT', 25),
  'from' => ['address' => '18010029423@163.com','name' => '发件人'],
  'encryption' => env('MAIL_ENCRYPTION', 'tls'),
  'username' => env('MAIL_USERNAME'),
  'password' => env('MAIL_PASSWORD'),
  'sendmail' => '/usr/sbin/sendmail -bs',
]

# 编辑环境配置文件
vim laravel/.env

# .env
MAIL_DRIVER=
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=yourname@163.com
MAIL_PASSWORD=password
MAIL_ENCRYPTION=

.env文件需要配置username和password其余为空，则会使用mail.php的配置。

1. driver用于配置默认的邮件发送驱动，Laravel支持多种邮件驱动方式，包括smtp、Mailgun、Maildrill、Amazon SES、mail和sendmail，Mailgun和Amazon SES都是收费的Maildrill目前不支持中国区用户，这三个都是第三方邮件服务。mail驱动使用PHP提供的mail函数发送，sendmail驱动通过Sendmail/Postfix（Linux）提供的命令发送邮件，smtp驱动通过支持ESMTP的SMTP发送邮件。
   就目前状况来看，使用smtp是最明智的选择，mail不安全，sendmail需要安装配置Sendmail/Postfix，其他要么付费要么不能用。
2. host是邮箱所在主机，比如我们使用163邮箱，对应值是smtp.163.com，使用QQ邮箱的话，对应值是smtp.qq.com。
3. port用于配置邮箱发送服务端口号，比如一般默认值是25，但如果设置SMTP使用SSL加密，该值为465。
4. from配置项包含address和name，前者表示发送邮箱，后者表示发送邮件使用的用户名。
5. encryption表示加密类型，可以设置为null表示不使用任何加密，也可以设置为tls或ssl。
6. username表示邮箱账号，比如yaojinbu@163.com
7. password表示上述邮箱登录对应登录密码。注意QQ邮箱的话应该开启POP3|SMTP服务时给的密钥。
8. sendmail是在设置driver为sendmail时使用，用于指定sendmail命令路径。

开始编写控制器、路由、模板。

在路由中加入如下规则：

Route::get('mail/send','MailController@send');

生成控制器

php artisan make::controller MailController

在laravel/app/Http/Controllers生成了一个MailController控制器，如下所示：

# MailController.php
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
class MailController extends Controller
{
    //
}

编辑控制器，加入以下的逻辑处理

use Mail;
class MailController{
  public function send()
  {
        $name = '王宝花';
        // Mail::send()的返回值为空，所以可以其他方法进行判断
        Mail::send('emails.test',['name'=>$name],function($message){
            $to = '282584778@qq.com';
            $message ->to($to)->subject('邮件测试');
        });
        // 返回的一个错误数组，利用此可以判断是否发送成功
        dd(Mail::failures());
  }
}

Mail::send();需要传三个参数，第一个为引用的模板，第二个为给模板传递的变量，第三个为一个闭包，参数绑定Mail类的一个实例。
Mailer::send文档
Mailer:: failures文档

在resources/emails下创建一个模板文件。

# test.blade.php
{{$name}}你好，这是一封测试文件。

好，现在在服务器上进行测试了，在地址栏输入http://wbl.app/mail/send，发送成功。
错误解决

1. 页面无异常输出，显示500的错误，是服务器的问题，如果是Nginx的则检查/var/log/nginx/errors.log；如果是apache则检茶/usr/local/apache2/logs/error.log，然后根据提示解决就行，permission的问题话就应该是storage的权限问题。
2. 页面有报错，根据报错解决即可，一般都是语法格式或者是没有使用正确命名空间。

发送纯文本邮件

Mail::raw('你好，我是PHP程序！', function ($message) {
    $to = '282584778@qq.com';
    $message ->to($to)->subject('纯文本信息邮件测试');
});

邮件中发送附件

1. 网络图片
   当然，可以在模板直接应用静态文件；但灵活性差，使用embed方法更灵活。

# test.blade.php
{{$name}}你好，这是一封测试文件。 
<br>
<img src='{{$message->embed($image)}}'> 

 public function send()
  {
        $name = '王宝花';
        $image = 'http://d.hiphotos.baidu.com/zhidao/pic/item/1ad5ad6eddc451da4ab93e2bb0fd5266d11632a6.jpg';
        Mail::send('emails.test',['name'=>$name,'imgPath'=>$image],function($message){
            $to = '282584778@qq.com';
            $message ->to($to)->subject('网络图片测试');
        });
        if(count(Mail::failures()) < 1){
            echo '发送邮件成功，请查收！';
        }else{
            echo '发送邮件失败，请重试！';
        }
 }

现在在服务器上进行测试了，在地址栏输入http://wbl.app/mail/send

2. 本地图片
   本地图片引用需要使用到Storage类，模板方法略有不同，在Storage/images文件夹中有一张图片。
   embedData()两个参数，第一个为图片，第二个为自定义图片名称。

# test.blade.php
{{$name}}，这是一封测试邮件
<br>
<img src="{{$message->embedData($image,'我的自拍照.jpg')}}">

# MailController.php
 public function send(){
      $image = Storage::get('images/obama.jpg');
      Mail::send('emails.test',['image'=>$image],function($message){
      $to = '282584778@qq.com';
      $message->to($to)->subject('[本地图片测试]');
      });
      if(count(Mail::failures()) < 1){
            echo '发送邮件成功，请查收！';
        }else{
            echo '发送邮件失败，请重试！';
        }
}

邮件附件

public function sendFile(){
    $name = '王宝花';
    Mail::send('emails.test',['name'=>$name],function($message){
        $to = '282584778@qq.com';
        $message->to($to)->subject('邮件主题');
        $attachment = storage_path('app/files/test.txt');
        // 在邮件中上传附件
        $message->attach($attachment,['as'=>'中文文档.txt']);
     });
}

$message的attach方法上传附件，该方法第一个参数是附件地址，第二个参数为一些额外参数，这里我们通过as指定附件在邮件中的显示名称。

测试如果显示文件名乱码的话，就这样写

$message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('中文文档')."?=.txt"]);