PHP与设计模式：适配器模式详解与实战

在实际开发中，不同的模块或组件之间可能因为接口不兼容而无法直接协作。为了让这些模块可以无缝配合，适配器模式（Adapter Pattern）提供了一种解决方案。本文将详细讲解适配器模式的概念、结构，以及如何在PHP中实现适配器模式，并通过案例展示其实战应用。

---

1. 什么是适配器模式？

• 定义
  适配器模式是一种结构型设计模式，通过在现有接口和目标接口之间架设一个中间层（适配器），使接口不兼容的类能够协同工作。
  将一个类的接口转换成客户希望的另外一个接口。Adapter模式使得原本由于接口不兼容而不能一起工作的那些类可以一起工作.
• 特点
  接口转换：适配器可以将一个类的接口转换为客户端期望的接口。
  解耦：客户端代码无需修改即可使用不兼容的对象。
  适用场景
  系统中有多个接口不兼容的类，需要统一它们的接口。
  希望复用现有的类，但其接口与当前需求不匹配。
  在不改变现有类代码的情况下让其适应新的接口。

---

2. 适配器模式的组成

适配器模式包含以下组件：

1.目标接口（Target）：定义客户端期望的接口。
2.适配者（Adaptee）：需要适配的现有类。
3.适配器（Adapter）：将适配者的接口转换为目标接口。
4.客户端（Client）：通过目标接口与适配器交互。

---

3. PHP实现适配器模式

<?php

// 目标接口（客户端需要的接口）
interface Target {
    public function request(): string;
}

// 适配者（需要适配的类）
class Adaptee {
    public function specificRequest(): string {
        return "Adaptee's specific behavior.";
    }
}

// 适配器（将适配者的接口转换为目标接口）
class Adapter implements Target {
    private Adaptee $adaptee;

    public function __construct(Adaptee $adaptee) {
        $this->adaptee = $adaptee;
    }

    public function request(): string {
        // 调用适配者的具体实现并返回结果
        return $this->adaptee->specificRequest();
    }
}

// 客户端代码
function clientCode(Target $target) {
    echo $target->request() . PHP_EOL;
}

// 测试适配器模式
$adaptee = new Adaptee();
$adapter = new Adapter($adaptee);

clientCode($adapter); // 输出: Adaptee's specific behavior.
?>

---

4. 代码解析

1. 目标接口（Target）
   定义了客户端所期待的接口，客户端通过调用该接口实现功能。
2. 适配者（Adaptee）
   是现有的类，它的接口与客户端期望的接口不兼容。
3. 适配器（Adapter）
   实现了目标接口，同时内部持有适配者的实例。
   在实现目标接口的方法中，调用适配者的具体方法，将其行为适配为客户端需要的形式。
4. 客户端代码
   通过目标接口与适配器交互，客户端无需关心适配者的具体实现。

---

5. 优缺点分析

• 优点
  复用性强：可以在不修改现有代码的情况下复用已有类。
  解耦：适配器隔离了客户端与适配者，客户端无需感知适配者的具体实现。
  扩展性好：新增适配器时无需修改客户端代码。
• 缺点
  类数量增加：每个适配器对应一个目标接口与适配者组合，可能导致类数量增加。
  复杂性提高：如果需要适配多个类，可能会增加维护难度。

---

6. 实际应用场景

假设你正在开发一个系统，需要与第三方支付接口对接，但该接口的实现与系统现有的支付接口不兼容。

<?php

// 系统定义的支付接口
interface PaymentInterface {
    public function pay(float $amount): string;
}

// 第三方支付类
class ThirdPartyPayment {
    public function makePayment(float $amount): string {
        return "Paid $amount using ThirdPartyPayment.";
    }
}

// 适配器
class PaymentAdapter implements PaymentInterface {
    private ThirdPartyPayment $thirdPartyPayment;

    public function __construct(ThirdPartyPayment $thirdPartyPayment) {
        $this->thirdPartyPayment = $thirdPartyPayment;
    }

    public function pay(float $amount): string {
        return $this->thirdPartyPayment->makePayment($amount);
    }
}

// 客户端代码
function processPayment(PaymentInterface $payment, float $amount) {
    echo $payment->pay($amount) . PHP_EOL;
}

// 测试
$thirdPartyPayment = new ThirdPartyPayment();
$adapter = new PaymentAdapter($thirdPartyPayment);

processPayment($adapter, 100.0); // 输出: Paid 100 using ThirdPartyPayment.
?>