laravel 发送邮件

    系统目前的通知使用了:
    短信通知
    微信模板消息通知
     
    一直未使用 『邮件通知』,由于项目需要,得添加上这个功能,下面记录下此次从头开始经历的一些过程:
     
    项目使用的是 laravel 5.2
    首先,查看官方文档,官方文档是默认支持了 发送邮件
    http://laravelacademy.org/post/3239.html
     
    一定要多读几遍,好好理解它都提供了哪些内容,laravel 中发送邮件很简单:
     
    use Mail;
    Mail::send('emails.welcome', $data, function ($message) { // 'email.welcome' 支持解析了 blade 模板后,作为邮件内容。 '$data' 是 blade 模板分配的数据变量
    $message->from('[email protected]', 'Laravel'); // 发件人
    $message->to('[email protected]')->cc('[email protected]'); // 收件人 & 抄送人
    });
     
    Mail::send(['text' => 'view'], $data, $callback); // 支持 '纯文本邮件'
    Mail::raw('欢迎您!', $callback); // 支持 '原生字符串邮件'
     
    支持 『附件』
    支持 『邮件视图中插入附件 - html邮件格式的图片等』
     
    支持 『邮件队列』
     
    等等...,就不一一说明了,查看文档
     
     
    关于邮件的配置,同一般服务配置一样,涉及:
    .env
    config/mail.php
     
    关于 '驱动'
    laravel 的邮件服务支持多种 driver:
    "smtp", "mail", "sendmail", "mailgun", "mandrill", "ses", "log"
     
    log 是记录到 '日志' 里,供我们本地模拟测试,而不是真实发送邮件
    mailgun, mandrill, ses 是一些第三方服务。
    smpt, mail, sendmail 是我们自己可以通过配置,发送邮件的
     
    之前自己真没有搞过邮件发送,自己都感觉有点不可思议,经常听说,但是就是没有测试过。正好通过这个机会稍微了解下。
     
    邮件发送,是需要 '邮件服务器' 的。我们自己不搭建的话,只能借助第三方的邮件服务。
     
    1.关注PHP中发送邮件,参考:
    http://www.php.cn/php-weizijiaocheng-381273.html
     
    2.本地 laravel 使用 smtp 发送邮件,参考:
    https://www.jianshu.com/p/8ccb2820df23
     
    3.163或126邮箱 开启 SMTP 服务:
    http://www.yii-china.com/post/detail/10.html
     
    4.邮件服务端口:
    https://blog.csdn.net/zhangpan19910604/article/details/45065629
     
    5.搭建邮件服务器(没搭建过,百度或google搜索一大堆):
    https://www.jianshu.com/p/610d9bf0ae8b
    https://bfchengnuo.com/2017/03/21/%E7%94%A8Centos%E6%90%AD%E5%BB%BA%E8%87%AA%E5%B7%B1%E7%9A%84%E9%82%AE%E4%BB%B6%E7%B3%BB%E7%BB%9F/
     
    6.邮件的参数:
    /*
    $message->from($address, $name = null);
    $message->sender($address, $name = null);
    $message->to($address, $name = null);
    $message->cc($address, $name = null);
    $message->bcc($address, $name = null);
    $message->replyTo($address, $name = null);
    $message->subject($subject);
    $message->priority($level);
    $message->attach($pathToFile, array $options = []);
    // 从$data字符串追加文件...
    $message->attachData($data, $name, array $options = []);
    // 获取底层SwiftMailer消息实例...
    $message->getSwiftMessage();
    */
    发现文档中,邮件的一些参数,完全不明白是啥意思,就想找找邮件参数里的解释,看了点 laravel 源码,了解到使用的是:
    swiftmailer
     
    查看 swiftmailer 文档,里面有一些见解,当然更多的、具体的内容,我们可以自己展开搜索:
    https://swiftmailer.symfony.com/docs/messages.html
     
    看过文档之后,简单了解了下 邮件发送 的一些基础知识,我们按照上面的 '2' 参考教程,配置后,可以正常发送邮件了。
     
    但考虑到,是不是通过这种情况(或 免费的服务),不专业啊?会不会效率很慢等等,想到是不是应该使用一个第三方服务。
    就直接搜索 "阿里云",果然有 "邮件服务",就开启使用。
     
    阿里云 - 邮件推送文档:
    https://help.aliyun.com/product/29412.html
     
    这里得吐槽下,开启 "邮件服务" 我是搞了半天,半天不懂一堆域名啥是干嘛的!
     
    "设置发信域名",不明白的是,发送邮件为什么还需要域名,域名只有一个,因为怕影响线上的业务,和客服沟通了大半天,才敢尝试。
     
    直接按这个 '域名配置相关问题',一步步执行即可。
    https://help.aliyun.com/document_detail/57804.html
     
    又开始看 '阿里云-发送邮件文档',对于一个全新的东西,得好好了解...
    阿里云发送邮件,支持3种方式:
    1.控制台发送批量邮件。
    2.API 发送触发邮件和批量邮件。
    3.SMTP 发送触发邮件和批量邮件。
     
    2 和 3,都是程序实现
    API 接口 - 目前暂不支持添加附件
    SMTP 接口 - 支持附件
     
    我搜索下 laravel 的 阿里云邮件服务的包,使用的是 'API' 接口方式(因为当时还没总结,搜索到的包就是 API 接口方式,当时都还不知道有 SMTP 接口),这里就先总结下这个包的使用:
     
    github地址:
    https://github.com/HyanCat/aliyun-direct-mail
     
    这里提一个参数:region - 区域
    hyancat/aliyun-direct-mail/lib/aliyun-php-sdk-core/Regions/EndpointConfig.php 里是所有可以填写的 region(不清楚用处是干嘛的...)
     
    另外,可能是版本的问题,我修改了下源码:
    hyancat/aliyun-direct-mail/src/DirectMailTransport.php
     
    1.将 'Swift_Mime_SimpleMessage' 类,改为:'Swift_Mime_Message'
    2.修改 sendSingle() 方法,适合我们的返回方式:
    protected function sendSingle(\Swift_Mime_Message $message)
    {
    $request = new DM\SingleSendMailRequest();
     
    // 控制台创建的发信地址
    $request->setAccountName($this->accountName);
    // 发信人昵称,长度小于 15 个字符
    $request->setFromAlias($this->accountAlias);
    // 取值范围 0~1: 0 为随机账号;1 为发信地址(参考阿里邮箱文档)
    $request->setAddressType(1);
    // 使用管理控制台中配置的回信地址(状态必须是验证通过)(参考阿里邮箱文档)
    $request->setReplyToAddress('true');
    // 目标地址,多个 email 地址可以用逗号分隔,最多100个地址(参考阿里邮箱文档)
    $request->setToAddress($this->getToAddress($message));
    // 邮件主题
    $request->setSubject($message->getSubject());
    // 邮件HTML正文
    $request->setHtmlBody($message->getBody());
     
    try {
    $response = $this->createClient()->getAcsResponse($request);
     
    return error(0, '发送邮件成功!', (Array) $response);
    } catch (\ClientException $e) {
    return error(1, $e->getErrorMessage());
    } catch (\ServerException $e) {
    return error(1, $e->getErrorMessage());
    } catch (\Exception $e) {
    return error(1, $e->getMessage());
    } catch (\Throwable $e) {
    return error(1, $e->getMessage());
    }
    }
     
     
    测试过程中,出现了好多白痴问题:
    1.composer require 安装时,composer 一直报错!
    可能问题:
    .env 文件错误
    config/services.php 当时语法错误
    composer self-update composer自身版本落后
     
    2.配置不生效问题:
    可能开启了 config 缓存,当时不小心,执行了下命令
    php artisan config:cache
    或
    php artisan config:clear
     
    3.关于 .env 环境变量配置:
     
    # HyanCat 阿里邮箱推送配置
    #DIRECT_MAIL_APP_KEY=null
    #DIRECT_MAIL_APP_SECRET=null
    #DIRECT_MAIL_REGION=null
    #DIRECT_MAIL_ACCOUNT_ALIAS=null
    #DIRECT_MAIL_ACCOUNT_NAME=null
     
    env('配置项', '默认值') 函数,我一直的一个误区!一直以为不写 或者 为null,会使用默认值!发现并不生效!
    DIRECT_MAIL_APP_KEY= // 不填写值
    DIRECT_MAIL_APP_KEY=null // 填写为null
     
    我们来解析下 env() 源码
    function env($key, $default = null)
    {
    $value = getenv($key); // getenv() 函数,下面详细解释下
     
    if ($value === false) {
    return value($default);
    }
     
    switch (strtolower($value)) {
    case 'true':
    case '(true)':
    return true;
    case 'false':
    case '(false)':
    return false;
    case 'empty':
    case '(empty)':
    return '';
    case 'null':
    case '(null)':
    return;
    }
     
    if (strlen($value) > 1 && Str::startsWith($value, '"') && Str::endsWith($value, '"')) {
    return substr($value, 1, -1);
    }
     
    return $value;
    }
     
     
    环境变量的范围,参照:http://www.faqs.org/rfcs/rfc3875.html
    getenv($key)
    返回环境变量 varname 的值, 如果环境变量 varname 不存在则返回 FALSE。
    所以:
    DIRECT_MAIL_APP_KEY= // 不填写值,getenv() 返回的是 ''
    DIRECT_MAIL_APP_KEY=null // 填写为null,getenv() 返回的是 null
    # DIRECT_MAIL_APP_KEY= // 只有不存在时,getenv() 返回的才是 false
    而我们的 env() 函数,会判断 "$value === false",才会使用 '默认值',所以要保证使用默认值,我们不可以添加该变量变量(或注释掉)
     
     
    关于 阿里云的 SMPT API,应该是同其他的(163/126/qq邮箱的) SMTP 服务一样,我们已经开启了,laravel 默认也支持,我们直接使用即可!
    参考:
    https://help.aliyun.com/knowledge_detail/51622.html
     
    这里我进行测试了,没有问题!
    唯一需要注意的是:
    认证用户名是:控制台创建的发信地址(调试邮箱时各种问题,这个也是个坑)
     
    发送邮件,会阻塞程序进行,为了优化,我们应该采用 laravel 邮件服务的 queue 方法,使用队列!(猜测应该是这样)

https://blog.csdn.net/beyond__devil/article/details/80934291

猜你喜欢

转载自www.cnblogs.com/lxwphp/p/9282973.html