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

转自王宝花http://www.jianshu.com/p/8ccb2820df23

此教程是笔者通过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' => '[email protected]','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=
[email protected]
MAIL_PASSWORD=password
MAIL_ENCRYPTION=

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

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。
port用于配置邮箱发送服务端口号，比如一般默认值是25，但如果设置SMTP使用SSL加密，该值为465。
from配置项包含address和name，前者表示发送邮箱，后者表示发送邮件使用的用户名。
encryption表示加密类型，可以设置为null表示不使用任何加密，也可以设置为tls或ssl。
username表示邮箱账号，比如[email protected]
password表示上述邮箱登录对应登录密码。注意QQ邮箱的话应该开启POP3|SMTP服务时给的密钥。
sendmail是在设置driver为sendmail时使用，用于指定sendmail命令路径。

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

在路由中加入如下规则：

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

生成控制器

php artisan make::controller MailController

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

# MailController.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 = '王宝花';        
$flag = Mail::send('emails.test',['name'=>$name],function($message){ 
       $to = '[email protected]';            
       $message ->to($to)->subject('邮件测试');        
       });        
     if($flag){            
          echo'发送邮件成功，请查收！';
        }else{
            echo'发送邮件失败，请重试！';
        }  
   }
}

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

在resources/emails下创建一个模板文件。
# test.blade.php
{{$name}}你好，这是一封测试文件。

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

错误解决

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

发送纯文本邮件

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

邮件中发送附件

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

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

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

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

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

# test.blade.php
{{$name}}，这是一封测试邮件

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

邮件附件

public functionsendFile(){
    $name = '王宝花';
    $flag = Mail::send('emails.test',['name'=>$name],function($message){
        $to = '[email protected]';
        $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"]);

邮件标题乱码.png

Paste_Image.png