利用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' => '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
  2. port用于配置邮箱发送服务端口号,比如一般默认值是25,但如果设置SMTP使用SSL加密,该值为465。
  3. from配置项包含address和name,前者表示发送邮箱,后者表示发送邮件使用的用户名。
  4. encryption表示加密类型,可以设置为null表示不使用任何加密,也可以设置为tls或ssl。
  5. username表示邮箱账号,比如yaojinbu@163.com
  6. password表示上述邮箱登录对应登录密码。注意QQ邮箱的话应该开启POP3|SMTP服务时给的密钥。
  7. 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 = '282584778@qq.com';            
       $message ->to($to)->subject('邮件测试');        
       });        
     if($flag){            
          echo'发送邮件成功,请查收!';
        }else{
            echo'发送邮件失败,请重试!';
        }  
   }
}

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

在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)}}'
>
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 = '282584778@qq.com';
         $message ->to($to)->subject('网络图片测试');
     });
     if($flag){
         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 functionsend(){
   $image = Storage::get('images/obama.jpg');
   $flag = Mail::send('emails.test',['image'=>$image],function($message){
   $to = '282584778@qq.com';
   $message->to($to)->subject('[本地图片测试]');
   });
   if($flag){
         echo'发送邮件成功,请查收!';
   }else{
         echo'发送邮件失败,请重试!';
      }
}

邮件附件

public functionsendFile(){
    $name = '王宝花';
    $flag = 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
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容