Laravel5.0+ 邮件发送功能实现

moTzxx

已于 2024-01-09 15:30:57 修改

阅读量3.7k

点赞数

分类专栏： Laravel 文章标签： laravel5

于 2017-09-02 11:40:47 首次发布

本文链接：https://blog.csdn.net/u011415782/article/details/77800154

版权

Laravel 专栏收录该内容

11 篇文章 1 订阅

订阅专栏

I. 背景

近期在接触传说中最优雅的 PHP 框架——Laravel，学习了一下邮件发送功能，在此分享一下

测试环境：Laravel 5.2.45，Laravel 5.5
使用协议：SMTP 邮件传输协议
对于 ThinkPHP 框架框架的邮件发送可参考文章 ThinkPHP 框架下邮件发送功能

II. 功能开发过程

此处以网易（163.com）邮箱为例。

一、前期准备

(1).首先对 SMTP 的知识稍作了解

(2).开启邮箱 SMTP 服务

以 163.com 邮箱为例，点击上方导航栏的“设置”，选择“POP3/SMTP/IMAP”进行下面的设置，着重记下服务器地址（SMTP 服务器：smtp.163.com）

然后点击“客户端授权密码”进行权限设置
一般会进行短信的验证，并记录下自己设定的授权登录密码，后面的代码中需要用到。

二、代码实现

(1).修改配置文件 mail.php

文件位置位于 config/mail.php
修改其中的 “from” 信息，以本人为例，address 为发送方邮箱账号，name 为称谓

 'from' => ['address' => '1xxxxxxx@163.com', 'name' => '逗比2号'],

(2).修改配置文件 .env

MAIL_DRIVER=smtp
MAIL_HOST=smtp.163.com
MAIL_PORT=25
MAIL_USERNAME=1xxxxxxx@163.com
MAIL_PASSWORD=xxxxx
MAIL_ENCRYPTION=null

注意配置信息的填写：MAIL_USERNAME，MAIL_PASSWORD 为前期准备中记下的163邮箱账号及客户端授权密码（非登录密码）
MAIL_PORT 为默认端口号，如果配置 MAIL_ENCRYPTION = ssl 时，端口号需要更改为 465

(3).补充路由信息

Route::any('mail', 'TestController@mail');

(4).控制器代码编写

基本的代码编辑如下
注意，本人发现网上的介绍有出入，有的是使用 Mail 类，推测应该是版本不同的原因，此处针对 5.2.45、5.5 版本进行的测试
附录 TestController.php 源代码以供参考

<?php
namespace App\Http\Controllers;
use Illuminate\Mail\Mailer;

class TestController extends Controller
{
    private $mailer;

    public function __construct(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }
    /**
     * 发送邮件
     */
    public function mail(){
		//测试数据
		$viewData = ['title' => '你若盛开，清风自来','author' => '木心'];
        $emailData = [
            'content' => '从前的日色变得慢 车 马 邮件 都慢',
            'subject' => '这是邮件主题，希望您能支持！',//邮件主题
            'addr' => 'xxxxxxxxx@qq.com',//邮件接收地址
        ];
        $this->sendText($emailData);
        //$this->sendHtml('mail',$viewData,$emailData);
        //TODO  $tag 判断发送是否成功，进行后续代码开发
        return view('mail',['title' => '你若盛开，清风自来','author' => '木心']);
    }
    
	/**
     * 发送纯文本 邮件
     * @param $emailData 邮件数据
     */
    public function sendText($emailData){
        //此处为文本内容
        $tag = $this->mailer
            ->raw($emailData['content'],
                function ($message)use ($emailData){
                    $message->subject($emailData['subject']);
                    $message->to($emailData['addr']);
                });
        return $tag;
    }
	/**
     * 发送自定义网页
     * @param $emailData 邮件数据
     * @param $viewPage html视图
     * @param $viewData html传输数据
     */
    public function sendHtml($viewPage,$viewData,$emailData){
        $tag = $this->mailer
            ->send($viewPage,$viewData,
                function ($message) use ($emailData){
                    $message->subject($emailData['subject']);
                    $message->to($emailData['addr']);
                });
        return $tag;
    }
}

三、代码说明

(1).`方法 sendText()`

此方法为发送纯文本邮件的功能实现，调用此方法发送的邮件截图如下：

(2).`方法 sendHtml()`

此方法为自定义格式邮件发送的功能实现
实现的前提需要有设计界面，代码中举例为我简单设计的 mail.blade.php 参考代码如下：

<html>
<style>
    *{
        font-family: 楷体;
    }
</style>
<h2>{{$title}}</h2>
![]({{asset('uploads/20170902/59aa05723e35d.jpg')}})
<pre>
      从前的日色
        变得慢
      车 马 邮件
         都慢
    一生只够爱一个人
                --{{$author}}
</pre>
</html>

调用此方法发送的邮件截图如下：

`☞ 附录`

①. `另一种简单写法`

其实可提供一种更简单的写法，与上面所处理的 raw(),send() 方法类似，举例：

use Illuminate\Support\Facades\Mail;

$tag = Mail::raw('你好，我们已经准备好了',function ($message){
            $message->to('9xxxxxxxxxx@qq.com');
        });

不过，测试发现会有如下报错：

FatalErrorException
 in ClassLoader.php line 373:Maximum function nesting level of '100' reached, aborting!

但是前面的第一种代码方案，不会出现此问题，并且邮件发送响应快一些（或许错觉），然而，此代码如果放在队列中执行，测试发现不做任何修改也是可以实现…
原因和解决方案，请参考文章 - PHP中的函数嵌套层数限制

②. `554 邮件发送报错`

有时邮件发送时，会有如下报错，例如 554 多表示邮件发送过多被系统禁止了，具体信息可通过提示信息中的网址进行查询.

开发测试中的报错信息参考

554 报错查询结果

具体代码可自行优化，有问题建议多多谷歌，还是能帮到不少忙的.

③. `post 请求500报错`

注意一点：laravel框架默认要求表单提交时需要添加

{{ csrf_field() }}

④. phpmailer 发送邮件成功了但是用户就是没收到邮件

出现原因：发送邮件太多导致邮箱服务器被腾讯封了发送的邮件统统进入了邮件服务器的草稿箱里。

解决方案：

重新修改密码，更换授权码即可

`⑤. PHP 使用 phpMailer 封装邮件发送方法）`（2024-01-09 补充）

首先，离线安装控件 - phpMailer (建议 composer 命令安装)

封装核心方法如下：

/**
     * @Notes:邮箱发送验证码
     * @param string $email_url 邮件地址
     * @param string $verif_code 验证码
     * @param int $lang_type 语言类型 1：中文，2：泰文
     * @return array
     * @User: zhanghj
     * @DateTime: 2023-12-15 18:54
     */
    public static function sendPHPMailerVerCode($email_url = '',$verif_code = '',$lang_type = 1){
        $sendFlag = false;
        $retMsg = '';
        includeFile(dirname(Yii::$app->basePath).'/common/PHPMailer/src/PHPMailer.php');

        $mail = new PHPMailer(true);
        if ($lang_type == 2){
            //泰文版
            $host_com = 'smtp.exmail.qq.com';
            $from_email = 'thailand@hwappu.com';
            $email_userName = 'thailand@hwappu.com';                // SMTP 用户名  即邮箱的用户名
            $email_password = 'Thaicust&123';

            $subject_str = 'รหัสยืนยันอีเมล';
            $body_content = "เรียนผู้ใช้............สวัสดีครับ/ค่ะ<br>";
            $body_content .= "รหัสยืนยันของคุณคือ:$verif_code<br>";
            $body_content .= "อย่าเปิดเผยรหัสยืนยันของคุณกับผู้อื่น<br><br>";
            $body_content .= "ข้อความนี้เป็นข้อความอัตโนมัติและไม่สามารถตอบกลับได้<br>";
            $body_content .= "ขอขอบคุณสำหรับการเข้าใช้งานและขอให้คุณมีความสุขในการใช้งาน";
            $alt_body = 'เนื้อหาเมลไม่รองรับการแสดงผล';
        }else{
            $host_com = 'smtp.exmail.qq.com';
            $from_email = 'lvluo@huapush.net';
            $email_userName = 'lvluo@huapush.net';                // SMTP 用户名  即邮箱的用户名
            $email_password = '123456@Dong';

            $subject_str = '邮箱验证码';
            //中文版邮件
            $body_content = "尊敬的用户，您好！<br><br>";
            $body_content .= "您的验证码是：$verif_code <br>";
            $body_content .= "请勿将验证码透露给其他人。<br><br>";

            $body_content .= "本邮件由系统自动发送，请勿直接回复！<br>";
            $body_content .= "感谢您的访问，祝您使用愉快";
            $alt_body = '邮件内容不支持显示';
        }

        try {
            //服务器配置
            $mail->CharSet ="UTF-8";                     //设定邮件编码
            $mail->SMTPDebug = 0;                        // 调试模式输出
            $mail->isSMTP();                             // 使用SMTP
            $mail->Host = $host_com;                     // SMTP服务器
            $mail->SMTPAuth = true;                      // 允许 SMTP 认证
            $mail->Username = $email_userName;           // SMTP 用户名  即邮箱的用户名
            $mail->Password = $email_password;           // SMTP 密码  部分邮箱是授权码(例如163邮箱)
            $mail->SMTPSecure = 'ssl';                   // 允许 TLS 或者ssl协议
            $mail->Port = 465;                           // 服务器端口 25 或者465 具体要看邮箱服务器支持

            $mail->setFrom($from_email, 'HWAPPU');  //发件人
            $mail->addAddress($email_url, 'Dear Friend');  // 收件人
            //$mail->addAddress('ellen@example.com');  // 可添加多个收件人
            //$mail->addReplyTo('xxxx@163.com', 'info'); //回复的时候回复给哪个邮箱 建议和发件人一致
            //$mail->addCC('cc@example.com');                   //抄送
            //$mail->addBCC('bcc@example.com');                 //密送

            //发送附件
            // $mail->addAttachment('../xy.zip');         // 添加附件
            // $mail->addAttachment('../thumb-1.jpg', 'new.jpg');    // 发送附件并且重命名

            $mail->isHTML(true);                               // 是否以HTML文档格式发送  发送后客户端可直接显示对应HTML内容
            $mail->Subject = $subject_str;
            $mail->Body    = $body_content;
            $mail->AltBody = $alt_body;

            $mail->send();
            $sendFlag = true;
        }catch (\Exception $exception){
            $retMsg = $exception->getMessage();
        }
        return [$sendFlag,$retMsg];
    }

执行效果如下：

moTzxx

关注

0
点赞
踩
4

收藏

觉得还不错? 一键收藏
1
评论
Laravel5.0+ 邮件发送功能实现

背景近期在接触传说中最优雅的 PHP 框架——Laravel，学习了一下邮件发送功能，在此分享一下，其中，我使用的框架版本为 5.2.45，参考时请注意差别. 对于 ThinkPHP 框架框架的邮件发送可参考文章 ThinkPHP 框架下邮件发送功能
复制链接

扫一扫