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 方法，使用队列！(猜测应该是这样)