利用 Composer 完善自己的 PHP 框架（二）——发送邮件

crossea 发布于2019-06-27 10:54 / 2678人阅读

说明

原文发表在我的个人网站：利用 Composer 完善自己的 PHP 框架（二）——发送邮件

本教程示例代码见 https://github.com/johnlui/My-First-Framework-based-on-Composer

回顾

上一篇文章中，我们手工建造了一个简易的视图加载器，顺便引入了错误处理包，让我们的 MFFC 框架在 M、V、C 三个方面都达到了“好用”的水平。View 是一个可插拔组件，在本篇文章中我们要创建另一个可插拔组件——邮件发送模块。

正文

我们采用 nette/mail 包作为我们的邮件发送基础模块，在它的基础上封装一个 Mail 类，暴露出简洁的 API 给控制器使用，下面我们正式开始。

引入 nette/mail 包，修改 composer.json：

"require": {
  "codingbean/macaw": "dev-master",
  "illuminate/database": "*",
  "filp/whoops": "*",
  "nette/mail": "*"
},

运行 composer update，等待安装完成。nette/mail 的文档位于：http://doc.nette.org/en/2.2/mailing 让我们阅读它，然后设计 Mail 类：

新建 services/Mail.php 文件，内容如下：

config = require BASE_PATH."/config/mail.php";

    $this->setFrom($this->config["username"]);

    if ( is_array($to) ) {
      foreach ($to as $email) {
        $this->addTo($email);
      }
    } else {
      $this->addTo($to);
    }
  }

  public function from($from=null)
  {
    if ( !$from ) {
      throw new InvalidArgumentException("邮件发送地址不能为空！");
    }
    $this->setFrom($from);
    return $this;
  }

  public static function to($to=null)
  {
    if ( !$to ) {
      throw new InvalidArgumentException("邮件接收地址不能为空！");
    }
    return new Mail($to);
  }

  public function title($title=null)
  {
    if ( !$title ) {
      throw new InvalidArgumentException("邮件标题不能为空！");
    }
    $this->setSubject($title);
    return $this;
  }

  public function content($content=null)
  {
    if ( !$content ) {
      throw new InvalidArgumentException("邮件内容不能为空！");
    }
    $this->setHTMLBody($content);
    return $this;
  }
}

Mail 类和 View 类工作的方式基本一致：

$this->mail = Mail::to(["ooxx@gmail.com", "ooxx@qq.com"])
                    ->from("MotherFucker ")
                    ->title("Fuck Me!")
                    ->content("Hello~~");

上面这段代码位于 HomeController 中， View::make() 那行代码的下面。

新建 MFFC/config/mail.php，请自行替换邮件地址和密码：

 "smtp.163.com",
  "username" => "ooxx@163.com",
  "password" => "password",
  "secure" => ""
];

Mail 和 View 一样也在 BaseController 的析构函数 __destruct() 函数中处理，现在这个 function 长这样：

public function __destruct()
{
  $view = $this->view;
  if ( $view instanceof View ) {
    extract($view->data);
    require $view->view;
  }

  $mail = $this->mail;
  if ( $mail instanceof Mail ) {
    $mailer = new NetteMailSmtpMailer($mail->config);
    $mailer->send($mail);
  }
}

OK，准备的差不多了，运行 composer dump-autoload 把 Mail 类加入自动加载，刷新页面！

如果你看到以上页面，恭喜你！邮件发送成功了！

赶快去检查一下收件箱有木有邮件！:-D 这次页面加载可能会稍慢，因为邮件是同步发送的。异步的队列系统我们会在以后讲到。

分析

邮件发送的整体流程想必大家已经轻车熟路了，现在主要叙述一下 Mail 类的设计过程：

邮件发送的核心参数是 目标地址，即邮件要发送到的 E-mail 地址，所以我们设计 Mail::to("oo@xx.me") 作为发送的 触发 API。

目前我们采用最简单的 SMTP 方式发送邮件，文档在这里。配置文件放置在 MFFC/config/mail.php 中，依旧返回一个数组。

Mail 类继承了 NetteMailMessage 类。Mail::to() 的时候创建一个 Mail 类的实例（对象）并返回，这时候其实 BaseController 中的析构函数中的代码已经会被触发并处理这个对象了。默认的发送人是从配置文件中读取的 username。

Mail::to() 支持字符串或者数组作为参数，可以一次发送一封或多封邮件。

from()、title() 和 content() 方法用于丰富邮件内容。content() 方法可以直接传递 HTML 代码。

from() 配置不一定都能够成功，部分邮件服务商不支持修改发送人地址。

这个变量全部组装完成后，被赋值给控制器的 $mail 成员变量，然后被析构函数处理，邮件被发送，成功后页面代码被发送回客户端，流程结束。

预告

下一步：利用 Composer 完善自己的 PHP 框架（三）——Redis 缓存（待更新）

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/20851.html

利用 Composer 完善自己的 PHP 框架（一）——视图装载

摘要：我们先从目前用着最不爽的地方视图装载下手。实现装载器完成基础准备以后我们正式开始制造视图装载器。下一步利用完善自己的框架二发送邮件原文发表在我的个人网站：利用 Composer 完善自己的 PHP 框架（一）——视图装载本教程示例代码见 https://github.com/johnlui/My-First-Framework-based-on-Composer 回顾经...

LinkedME2016 2019-06-27 10:54 评论0 收藏0
【完结】利用 Composer 完善自己的 PHP 框架（三）——Redis 缓存

摘要：原文发表在我的个人网站利用完善自己的框架三缓存本教程示例代码见回顾上两篇文章中我们完成了视图加载类和邮件发送类的设计，完成了两个可插拔组件。相比使用文件作为缓存，拥有更高的性能更好地可维护性和更强大的操作。原文发表在我的个人网站：利用 Composer 完善自己的 PHP 框架（三）——Redis 缓存本教程示例代码见 https://github.com/johnlui/My...

icattlecoder 2019-08-06 13:13 评论0 收藏0
【完结】利用 Composer 完善自己的 PHP 框架（三）——Redis 缓存

摘要：原文发表在我的个人网站利用完善自己的框架三缓存本教程示例代码见回顾上两篇文章中我们完成了视图加载类和邮件发送类的设计，完成了两个可插拔组件。相比使用文件作为缓存，拥有更高的性能更好地可维护性和更强大的操作。原文发表在我的个人网站：利用 Composer 完善自己的 PHP 框架（三）——Redis 缓存本教程示例代码见 https://github.com/johnlui/My...

Charlie_Jade 2019-06-27 10:54 评论0 收藏0
使用 mixphp 打造多进程异步邮件发送

摘要：消费者开发本例我们使用的多进程开发工具来完成这个需求，通常使用常驻进程来处理队列的消费，所以我们使用的类型，模式。中进程负责执行邮件发送任务。此时终端将打印成功收到测试邮件官网注意：这个是 MixPHP V1 的范例邮件发送是很常见的需求，由于发送邮件的操作一般是比较耗时的，所以我们一般采用异步处理来提升用户体验，而异步通常我们使用消息队列来实现。传统 MVC 框架由于缺少多进程...

EdwardUp 2019-07-01 10:12 评论0 收藏0