前言：
门面模式属于设计模式中三大分类之一的结构类型，也叫外观模式。其作用对客户端低耦合底层功能的封装，客户端不用知道子系统间的调用。
举例：
门面模式就相当于电脑主机，用户要打开某个应用程序，只需要知道两步。打开开机按钮，电脑开机后再打开应用。开机按钮就相当于一个门面，里面的开机需要调用不同的模块，比如硬件自检，选择启动盘，加载引导，加载内核，OS 初始化，启动指定级任务等，以下也通过发邮件的例子描述门面一模式。
涉及：
\1. call_user_func 函数的使用\2. 异常类的自定义处理\3. 类的分层封装\4. 发邮件功能的实现与配置
编码：
\1. 必须先 composer require phpmailer/phpmailer 安装依赖库。
\2. 创建扩展类目录，里面包括独立的配置文件，门面角色类，邮件功能类，校验类，异常类。
\3. 独立的配置类，包括 smtp 服务地址，端口，中转邮箱账号，授权码，邮件发送者昵称(唯一标识)。
<?php/** * @Notes: 邮箱SMTP服务配置 * @Interface getCondition * @Return mixed * @Author: bqs * @Time: 2020/8/31 10:15 */
return [ 'smtp_server' => 'smtp.qq.com', // QQ邮箱开启的smtp 'smtp_port' => 465, // QQsmtp服务端口 'smtp_user' => '2652364582@qq.com', // 北桥苏邮箱 'smtp_pwd' => 'ynxdedefduuhecbj', // SMTP服务开启后授权码 'email_id' => '酷D' // 邮件发送者的唯一标识(自定义的昵称)];
复制代码
\4. 门面角色类，也就是客户直接调用的，只有一个发送方法，但是该方法需要调用校验和实际发送的方法实现。
<?php/** * @Notes: 邮件门面 * @Interface getCondition * @Return mixed * @Author: bqs * @Time: 2020/8/31 13:10 */
namespace mail;
use think\Container;use mail\facade\MailException;use mail\facade\Mail;use mail\facade\Validate;
class MailFacade{
protected $error;
public static function __callStatic($method, $params) { //return (new static)->{$method}(...$params); return call_user_func([new MailFacade(),$method],$params); }
/** * @Notes: 面向客户的邮件发送调用 * @Author: bqs * @Time: 2020/8/31 13:33 * @Interface send * @param $params * @Return boolean 成功|失败 */ private function send($params) { // 校验参数 $validate = Validate::make(__FUNCTION__);
$res = $validate->check($params);
if (!$res) { // 抛出自定义异常 throw new MailException($validate->getError(),422); return false; }
// 发送邮件 $mail = new Mail(); $res = $mail->send($params);
return $res; }
}
复制代码
\5. 自定义异常类，可以在门面角色中以该类抛出，然后在客户调用中以该类捕捉，以下自定义了错误消息的输出。
<?php/** * @Notes: 邮件发送校验器 * @Interface getCondition * @Return mixed * @Author: bqs * @Time: 2020/8/31 13:03 */
namespace mail\facade;
class MailException extends \Exception{
public function errorMessage() { return "mail error: ".$this->getMessage(); }
}
复制代码
\6. 校验器，主要判断客户调用传入的参数。
<?php/** * @Notes: 邮件发送校验器 * @Interface getCondition * @Return mixed * @Author: bqs * @Time: 2020/8/31 13:03 */
namespace mail\facade;
class Validate{ protected $error;
protected $type; // 方法名
public function __construct($type) { $this->type = $type; }
// 创建验证器对象 public static function make($type) { return new self($type); }
// 与实际传入的参数做校验 public function check($params = []) { if (empty($params)) { $this->error = "参数不足,非法请求"; }
$this->error = call_user_func([new self($this->type),$this->type],$params);
return $this->error ? false : true; }
// 发送参数校验 public function send($params) { $res = "";
// 邮件 if (!isset($params[0]) || empty($params[0])) { return "邮箱不能为空"; }
$email = []; if (is_array($params[0])) { $email = $params[0]; }else { $email[0] = $params[0]; }
foreach ($email as $key => $val) { if (!preg_match("/^[A-Za-z0-9\u4e00-\u9fa5]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/",$val)) { return "邮箱格式不正确"; } }
// 邮件标题 if (!isset($params[1]) || !$params[1]) { return "邮件标题不能为空"; }
if (!isset($params[2]) || !$params[2]) { return "邮件内容不能为空"; }
return $res; }
// 获取错误信息 public function getError() { return $this->error; }
}
复制代码
\7. 实际的邮件发送，需要使用 phpmail 库。
<?php/** * @Notes: 邮件实际发送 * @Interface getCondition * @Return mixed * @Author: bqs * @Time: 2020/8/31 13:03 */
namespace mail\facade;
use PHPMailer\PHPMailer\PHPMailer;
class Mail{ protected $config = [];
public function __construct() { $this->config = include(dirname(__DIR__) . "../config/mail_config.php"); }
/** * @Notes: 发邮件 * @Author: bqs * @Time: 2020/8/31 13:07 * @Interface send * @Return mixed */ public function send($params) { $to = $params[0]; // 接收者 $subject = $params[1]; // 邮件标题 $content = $params[2]; // 邮件内容
$emails = new PHPMailer();
$emails->CharSet = 'UTF-8'; //设定邮件编码，默认ISO-8859-1，如果发中文此项必须设置，否则乱码 $emails->isSMTP();
//Enable SMTP debugging // 0 = off (for production use) // 1 = client messages // 2 = client and server messages $emails->SMTPDebug = 0;
//调试输出格式 //$emails->Debugoutput = 'html'; //smtp服务器 $emails->Host = $this->config['smtp_server'];
//端口 - likely to be 25, 465 or 587 $emails->Port = $this->config['smtp_port'];
if ($emails->Port === 465) $emails->SMTPSecure = 'ssl';// 使用安全协议 //Whether to use SMTP authentication $emails->SMTPAuth = true; //发送邮箱 $emails->Username = $this->config['smtp_user']; //密码 $emails->Password = $this->config['smtp_pwd']; //Set who the message is to be sent from $emails->setFrom($this->config['smtp_user'], $this->config['email_id']);
//回复地址 //$emails->addReplyTo('replyto@example.com', 'First Last');
// 接收邮件方 if (is_array($to)) {
foreach ($to as $v) { $emails->addAddress($v); }
} else {
$emails->addAddress($to); }
$emails->isHTML(true);// send as HTML
//标题 $emails->Subject = $subject;
//HTML内容转换 $emails->msgHTML($content);
//Replace the plain text body with one created manually //$emails->AltBody = 'This is a plain-text message body';
//添加附件 //$emails->addAttachment('images/phpmailer_mini.png'); //send the message, check for errors
return $emails->send(); }
}
复制代码
\8. 客户调用部分。
// 测试发邮件的门面 public function sendMail() {
try {
$res = \mail\MailFacade::send(["1641181271@qq.com"], "测试标题", "测试内容");
var_dump($res); die;
} catch (MailException $e) { // 捕捉自定义异常类抛出
var_dump($e->errorMessage()); die;
} catch (\Exception $e) {
var_dump($e->getMessage()); die; }
}
复制代码
\9. 返回 true 后查看邮件是否接收。
环境要求：
实现邮件发送是需要特定的环境和相关的配置才能实现，以下就以实现成功发送补充的操作。
第一步：
打开网址https://github.com/PHPMailer/PHPMailer/ 下载 PHPMailer，PHPMailer 需要 PHP 的 sockets 扩展支持，而登录 QQ 邮箱 SMTP 服务器则必须通过 SSL 加密的， PHP 还得包含 openssl 的支持。
第二步：使用 phpinfo() 函数查看 socket 和 openssl 扩展信息（wamp server 默认启用了该扩展）。
openssl 如果没有开启请打开 php.ini 文件进行开启
首先检查 php.ini 中；extension=php_openssl.dll 是否存在， 如果存在的话去掉前面的注释符‘；’， 如果不存在这行，那么添加 extension=php_openssl.dll。
PHPMailer 核心文件
第三步：**QQ 邮箱设置
所有的主流邮箱都支持 SMTP 协议，但并非所有邮箱都默认开启，您可以在邮箱的设置里面手动开启。
第三方服务在提供了账号和密码之后就可以登录 SMTP 服务器，通过它来控制邮件的中转方式。
第四步：开启 SMTP 服务
选择 IMAP/SMTP 服务，点击开启服务
第五步：验证密保
发送短信“配置邮件客户端”至 1069-0700-69
第六步：获取授权码
SMTP 服务器认证密码，也就是授权码，使用的时候没有空格，需要妥善保管。
评论