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


讲在前面

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

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

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

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

QQ邮箱 > 设置 > 账户


需要开启服务.png

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


生成密钥.png

当需要记录发信记录时,你还需要进行相关配置


image.png

IMAP和POP有什么区别?
POP允许电子邮件客户端下载服务器上的邮件,但是您在电子邮件客户端的操作(如:移动邮件、标记已读等),这是不会反馈到服务器上的,比如:您通过电子邮件客户端收取了QQ邮箱中的3封邮件并移动到了其他文件夹,这些移动动作是不会反馈到服务器上的,也就是说,QQ邮箱服务器上的这些邮件是没有同时被移动的 。但是IMAP就不同了,电子邮件客户端的操作都会反馈到服务器上,您对邮件进行的操作(如:移动邮件、标记已读等),服务器上的邮件也会做相应的动作。也就是说,IMAP是“双向”的。
同时,IMAP可以只下载邮件的主题,只有当您真正需要的时候,才会下载邮件的所有内容。

开始进行配置

我试验的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

  1. 本地图片
    本地图片引用需要使用到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"]);
邮件标题乱码.png
Paste_Image.png
Paste_Image.png

推荐阅读更多精彩内容