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('us@example.com', 'Laravel'); // 发件人
    $message->to('foo@example.com')->cc('bar@example.com'); // 收件人 & 抄送人
    });
     
    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 方法，使用队列！(猜测应该是这样)