PHP项目装饰器与适配器

本文目录导读：

1. 核心定义
2. PHP 项目中的典型场景
3. 关键区别（面试常问）
4. 如何在 PHP 项目中做选择？
5. 常见陷阱

在 PHP 项目中，装饰器模式 和 适配器模式 都是结构型设计模式，但它们的目的和使用场景有本质区别。

下面从核心定义、PHP 示例、典型场景以及关键区别来详细说明。

核心定义

• 适配器模式（Adapter）：

  • 目标： 让原本不兼容的接口能够协同工作，它把一个类的接口转换成客户端期望的另一个接口。
  • 本质： “接口转换器” 或 “封装器”。
  • 关注点： 解决接口不匹配问题，重写、适配已有接口。

• 装饰器模式（Decorator）：

  • 目标： 动态地给一个对象添加额外的职责或行为，而无需修改其原始类。
  • 本质： “包装器” + “增强器”。
  • 关注点： 解决功能扩展问题，不改变接口，只增加行为。

PHP 项目中的典型场景

适配器 —— 集成第三方支付

假设你的系统设计了一个统一的支付接口 PaymentInterface，但你要集成的支付宝 SDK 使用的是完全不同的一套方法。

<?php
// --- 你的系统标准接口 ---
interface PaymentInterface {
    public function pay(float $amount): void;
}
// --- 系统内部类（使用标准接口） ---
class OrderProcessor {
    public function processOrder(PaymentInterface $payment, float $amount) {
        // 这里只依赖 PaymentInterface
        $payment->pay($amount);
    }
}
// --- 第三方支付宝类（不兼容的接口） ---
class AlipaySDK {
    public function sendPayment(string $orderId, float $totalAmount): string {
        // 实际调用支付宝 API
        echo "支付宝支付：订单 {$orderId}，金额 {$totalAmount}\n";
        return "success";
    }
}
// --- 适配器：将 AlipaySDK 转换成 PaymentInterface ---
class AlipayAdapter implements PaymentInterface {
    private AlipaySDK $alipay;
    public function __construct(AlipaySDK $alipay) {
        $this->alipay = $alipay;
    }
    public function pay(float $amount): void {
        // 适配：转换方法名和参数
        $orderId = 'ORD' . uniqid();
        $this->alipay->sendPayment($orderId, $amount);
    }
}
// --- 使用 ---
$alipay = new AlipaySDK();
$adapter = new AlipayAdapter($alipay);
$processor = new OrderProcessor();
$processor->processOrder($adapter, 99.99); // 输出：支付宝支付：订单...，金额 99.99

装饰器 —— 消息通知增强

假设你有一个基础的消息发送器,现在希望在发送消息前/后进行一些增强（如记录日志、添加签名、或者推送渠道切换）。

<?php
// --- 基础接口 ---
interface NotifierInterface {
    public function send(string $message): void;
}
// --- 核心组件 ---
class BasicNotifier implements NotifierInterface {
    public function send(string $message): void {
        echo "发送消息: {$message}\n";
    }
}
// --- 基础装饰器（抽象类，也可以直接类实现接口） ---
abstract class NotifierDecorator implements NotifierInterface {
    protected NotifierInterface $wrapped;
    public function __construct(NotifierInterface $notifier) {
        $this->wrapped = $notifier;
    }
    // 抽象类中通常不重写 send，交由子类实现
    abstract public function send(string $message): void;
}
// --- 具体装饰器 1：添加日志 ---
class LoggingDecorator extends NotifierDecorator {
    public function send(string $message): void {
        echo "[日志] 记录发送操作: " . date('Y-m-d H:i:s') . "\n";
        $this->wrapped->send($message);
    }
}
// --- 具体装饰器 2：添加签名 ---
class SignatureDecorator extends NotifierDecorator {
    public function send(string $message): void {
        $signedMessage = $message . "\n--- 由系统自动生成 ---";
        $this->wrapped->send($signedMessage);
    }
}
// --- 使用 ---
$notifier = new BasicNotifier();
// 先加日志，再加签名
$notifier = new LoggingDecorator($notifier);
$notifier = new SignatureDecorator($notifier);
$notifier->send("Hello World");
// 输出：
// [日志] 记录发送操作: 2025-03-25 10:00:00
// 发送消息: Hello World
// --- 由系统自动生成 ---

关键区别（面试常问）

如何在 PHP 项目中做选择？

常见陷阱

• 装饰器可能改变原始类型（错误做法）： 如果装饰器返回的不是同一个接口类型，那就变成了适配器或代理，失去了装饰器的可叠加特性。
• 适配器不应增加新行为： 适配器主要做翻译/转换，不应添加功能（如缓存、日志），如果既转换接口又增强功能，请分层：内部用适配器，外部用装饰器。
• 过度使用装饰器： 太多层装饰会导致调试困难，可以考虑用 Pipeline 模式（管道模式）替代多层装饰器。

如果你需要完整的代码示例文件或 Laravel/Symfony 框架下的具体实现模板，我可以帮你进一步展开。