PHP 设计模式：适配器

适配器设计模式是一种结构模式，允许具有不兼容接口的对象一起工作。它充当两个对象之间的中介（或适配器），将一个对象的接口转换为另一个对象期望的接口。这使得那些因为具有不同接口而不兼容的类可以在不修改其原始代码的情况下进行协作。

适配器结构

适配器模式一般由三个主要元素组成：

• 客户端：期望与特定接口的对象一起工作的类。
• Adaptee：具有与客户端不兼容的接口，但其功能是必需的类。
• Adapter：实现客户端期望的接口的类，并将调用转换为Adaptee接口。

适配器类型

1. 对象适配器：基于组合。适配器包含它正在适配的类的实例。
2. 类适配器：基于继承（通常在支持多重继承的语言中）。

何时使用适配器？

• 当你想使用现有的类，但它的接口与客户端期望的不匹配时。
• 将新功能集成到遗留系统中，而无需修改旧代码。

此模式在需要使用外部库或 API 的系统中非常有用，允许您在不更改这些库的代码的情况下调整其功能。

使用 PHPMailer 的示例

这里是如何使用适配器设计模式将 PHPMailer 与自定义接口集成的示例。

情况：

假设您的系统期望任何电子邮件发送类实现一个名为 IMailer 的接口，但 PHPMailer 并不直接遵循此接口。 Adapter将用于使PHPMailer适应系统期望的接口。

通过 Composer 安装 PHPMailer

composer require phpmailer/phpmailer

目录系统

?Adapter
 ┣ ?src
 ┃ ┣ ?Interfaces
 ┃ ┃ ┗ ?IMailer.php
 ┃ ┣ ?Adapters
 ┃ ┃ ┗ ?PHPMailerAdapter.php
 ┃ ┗ ?Services
 ┃   ┗ ?ServicoDeEmail.php
 ┣ ?vendor
 ┣ ?composer.json
 ┗ ?index.php

自动加载

在composer.json文件（位于项目根目录）中，添加App命名空间以自动加载类：

{
    "autoload": {
        "psr-4": {
            "App\": "src/"
        }
    },
    "require": {
        "phpmailer/phpmailer": "^6.5"
    }
}

IMailer 接口

namespace App\Interfaces;

interface IMailer {
    public function send($to, $subject, $message);
}

PHPMailerAdapter 类

namespace App\Adapters;

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
use App\Interfaces\IMailer;

class PHPMailerAdapter implements IMailer {
    private $phpMailer;

    public function __construct() {
        $this->phpMailer = new PHPMailer(true);

        // Basic PHPMailer configuration
        $this->phpMailer->isSMTP();
        $this->phpMailer->Host = 'smtp.example.com';
        $this->phpMailer->SMTPAuth = true;
        $this->phpMailer->Username = 'your-email@example.com';
        $this->phpMailer->Password = 'password';
        $this->phpMailer->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
        $this->phpMailer->Port = 587;
        $this->phpMailer->setFrom('your-email@example.com', 'Your Name');
    }
}

• 方法发送

public function send($to, $subject, $message) {
    try {
        $this->phpMailer->addAddress($to);
        $this->phpMailer->Subject = $subject;
        $this->phpMailer->Body = $message;
        $this->phpMailer->send();
        echo 'Email sent successfully!';
    } catch (Exception $e) {
        echo "Failed to send email: {$this->phpMailer->ErrorInfo}";
    }
}

类电子邮件服务

namespace App\Services;

use App\Interfaces\IMailer;

class EmailService {
    private $mailer;

    public function __construct(IMailer $mailer) {
        $this->mailer = $mailer;
    }
}

• 方法sendEmailToClient

public function sendEmailToClient($to, $subject, $message) {
    $this->mailer->send($to, $subject, $message);
}

文件index.php

composer require phpmailer/phpmailer

结构说明

• IMailer.php：定义任何电子邮件系统都应该实现的 IMailer 接口。
• PHPMailerAdapter.php：将 PHPMailer 适配为 IMailer 接口。
• EmailService.php：使用IMailer接口发送电子邮件的电子邮件服务。
• index.php：使用电子邮件服务发送消息的主文件。

以上是PHP 设计模式：适配器的详细内容。更多信息请关注PHP中文网其他相关文章！