3分钟短文:Laravel是怎么发出一封电子邮件的?

335 阅读2分钟

引言

上一章我们为发电子邮件准备了贴心的表单,完善的数据验证,那么本篇我们讲解如何在laravel内发送一封电子邮件。

img

电子邮件非常方便,大家切勿滥用。

代码时间

laravel集成了热门且功能强大的SwiftMailer库,为我们封装了发送邮件所需要的底层逻辑,所以我们只需关注发送的逻辑, 如何准备电子邮件的内容即可。

laravel配置文件 config/mail.php 内默认的 smtp 参数:

'smtp' => [
    'transport' => 'smtp',
    'host' => env('MAIL_HOST', 'smtp.mailgun.org'),
    'port' => env('MAIL_PORT', 587),
    'encryption' => env('MAIL_ENCRYPTION', 'tls'),
    'username' => env('MAIL_USERNAME'),
    'password' => env('MAIL_PASSWORD'),
    'timeout' => null,
    'auth_mode' => null,
],

主要用于指定传输协议,主机地址,端口号,加密方式,用户名与密码等。 因为国外的缘故,默认使用了mailgun作为邮件服务器,这样免得使我们自己的邮件服务器发送的邮件, 被识别为垃圾邮件,影响业务流程。

注册免费额度的账户,可提供每月相应数额的邮件发送数量。申请之后,在 app/services.php 配置文件内可以看到如下代码:

'mailgun' => [
    'domain' => env('MAILGUN_DOMAIN'),
    'secret' => env('MAILGUN_SECRET'),
    'endpoint' => env('MAILGUN_ENDPOINT', 'api.mailgun.net'),
],

我们把相应的变量在.env文件内声明即可。

邮件发送类

把邮件发送逻辑集中起来处理,我们需要把传入的数据渲染出来,然后使用邮件将其发给用户。

使用下面的指令生成邮件处理类:

php artisan make:mail ContactEmail

生成的文件位于 app/Mail/ContactEmail.php,初始内容如下:

namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Contracts\Queue\ShouldQueue;

class ContactEmail extends Mailable
{
    use Queueable, SerializesModels;
    public function __construct()
    {
        //
    }
    public function build()
    {
        return $this->view('view.name');
    }
}

实例化的时候,我们需要接收一些数据:

public $contact;
public function __construct($contact)
{
    $this->contact = $contact;
}

给用户发一封样式友好的邮件,能大大提升用户的粘度。所以在我们使用视图渲染邮件:

public function build()
{
    return $this->to(config('mail.from.address'))->subject('HackerPair Inquiry')->view('emails.contact');
}

创建视图文件 resources/views/emails/contact.blade.php,简要地编写数据渲染及格式:

Hi,
A Laravel user has sent you a message.

Name: {{ $contact['name'] }}
E-mail: {{ $contact['email'] }}
Message: {{ $contact['msg'] }}

发送邮件

上一篇文章,我们使用 $contact 变量接收来自 request 请求体的字段值。 上一节我们又把邮件发送的模板准备好了,“万事俱备只欠东风”,接下来就是发送邮件的主流程逻辑了!

记得使用之前在头部引入 App\Mail\ContactEmail

Mail::to(config('mail.support.address'))->send(new ContactEmail($contact));

没错,一行就可以了!

写在最后

整体而言还很初阶,都是借助于第三方的力量在实现功能。 比如邮件服务器就有很多可定制方法。还有邮件发送类,可以做很多定制模板, 那些都是细化的方面了。

Happy coding :-)

我是@程序员小助手,专注编程知识,圈子动态的IT领域原创作者