概述

适配器模式（Adapter Pattern）是一种结构型设计模式，其核心思想是将一个类（或对象）的接口转换成客户端期望的另一个接口，使原本因接口不兼容而无法协同工作的类能够无缝配合。该模式扮演“转换器”的角色，在不修改原有类代码的前提下，解决接口兼容性问题，同时保留原有类的核心功能，实现代码的复用与扩展。

适配器模式遵循“开放-封闭原则”，通过引入适配器类隔离客户端与原始类的直接依赖，当原始类接口发生变化时，仅需修改适配器即可，无需调整客户端代码，大幅提升系统的灵活性和可维护性。

核心价值

适用场景

注意事项

完整代码

以“支付接口适配”为业务场景，构建适配器模式实现：现有系统期望通过统一的 PaymentAdapterInterface 接口调用支付功能，但需集成的第三方支付库（支付宝、微信支付）接口不一致，通过适配器将不同支付接口转换为统一格式。

<?php
declare(strict_types = 1);

/**
 * 目标接口：系统期望的统一支付接口规范
 */
interface PaymentAdapterInterface
{
    /**
     * 发起支付
     * @param float $amount 支付金额
     * @param string $orderNo 订单号
     * @return string 支付结果（含支付链接或状态信息）
     */
    public function pay(float $amount, string $orderNo): string;

    /**
     * 查询支付状态
     * @param string $orderNo 订单号
     * @return string 支付状态（未支付/支付成功/支付失败）
     */
    public function queryStatus(string $orderNo): string;
}

/**
 * 原始类1：第三方支付宝支付（接口与目标接口不兼容）
 */
class Alipay
{
    /**
     * 支付宝发起支付（方法名、参数与目标接口不同）
     * @param array $params 支付参数（含金额、订单号等）
     * @return string 支付宝支付链接
     */
    public function createAlipayOrder(array $params): string
    {
        $amount = $params['total_amount'] ?? 0.0;
        $orderNo = $params['out_trade_no'] ?? '';
        return sprintf("支付宝支付链接生成成功：https://pay.alipay.com/?order=%s&amount=%.2f", $orderNo, $amount);
    }

    /**
     * 支付宝查询支付状态（方法名与目标接口不同）
     * @param string $tradeNo 订单号
     * @return string 支付状态
     */
    public function getAlipayOrderStatus(string $tradeNo): string
    {
        // 模拟查询逻辑：随机返回支付状态
        $statusList = ['未支付', '支付成功', '支付失败'];
        return sprintf("支付宝订单【%s】状态：%s", $tradeNo, $statusList[array_rand($statusList)]);
    }
}

/**
 * 原始类2：第三方微信支付（接口与目标接口不兼容）
 */
class WechatPay
{
    /**
     * 微信发起支付（方法名、返回格式与目标接口不同）
     * @param string $orderId 订单号
     * @param float $money 支付金额
     * @return array 微信支付结果（含状态码和支付链接）
     */
    public function wechatPay(string $orderId, float $money): array
    {
        return [
            'code' => 200,
            'message' => '支付链接生成成功',
            'data' => [
                'pay_url' => sprintf("https://pay.weixin.qq.com/?order=%s&amount=%.2f", $orderId, $money),
                'order_no' => $orderId
            ]
        ];
    }

    /**
     * 微信查询支付状态（返回格式与目标接口不同）
     * @param string $orderId 订单号
     * @return array 微信支付状态结果
     */
    public function queryWechatPayStatus(string $orderId): array
    {
        $statusMap = [0 => '未支付', 1 => '支付成功', 2 => '支付失败'];
        $statusCode = rand(0, 2);
        return [
            'code' => 200,
            'message' => '查询成功',
            'data' => [
                'order_no' => $orderId,
                'status' => $statusMap[$statusCode],
                'status_code' => $statusCode
            ]
        ];
    }
}

/**
 * 具体适配器1：支付宝适配器（将支付宝接口适配为目标接口）
 */
class AlipayAdapter implements PaymentAdapterInterface
{
    /**
     * 持有原始支付宝对象（对象适配器：组合方式）
     * @var Alipay
     */
    private Alipay $alipay;

    public function __construct(Alipay $alipay)
    {
        $this->alipay = $alipay;
    }

    public function pay(float $amount, string $orderNo): string
    {
        // 适配参数格式：将目标接口的参数转换为支付宝所需格式
        $params = [
            'out_trade_no' => $orderNo,
            'total_amount' => $amount
        ];
        // 调用支付宝原始方法，返回统一格式结果
        return $this->alipay->createAlipayOrder($params);
    }

    public function queryStatus(string $orderNo): string
    {
        // 调用支付宝原始查询方法，适配返回格式
        return $this->alipay->getAlipayOrderStatus($orderNo);
    }
}

/**
 * 具体适配器2：微信支付适配器（将微信支付接口适配为目标接口）
 */
class WechatPayAdapter implements PaymentAdapterInterface
{
    /**
     * 持有原始微信支付对象（对象适配器：组合方式）
     * @var WechatPay
     */
    private WechatPay $wechatPay;

    public function __construct(WechatPay $wechatPay)
    {
        $this->wechatPay = $wechatPay;
    }

    public function pay(float $amount, string $orderNo): string
    {
        // 调用微信支付原始方法，适配参数顺序和返回格式
        $result = $this->wechatPay->wechatPay($orderNo, $amount);
        return sprintf("微信支付链接生成成功：%s", $result['data']['pay_url']);
    }

    public function queryStatus(string $orderNo): string
    {
        // 调用微信支付原始查询方法，适配返回格式
        $result = $this->wechatPay->queryWechatPayStatus($orderNo);
        return sprintf("微信订单【%s】状态：%s", $orderNo, $result['data']['status']);
    }
}

// 测试代码
try {
    // 1. 支付宝支付适配
    $alipay = new Alipay();
    $alipayAdapter = new AlipayAdapter($alipay);
    echo "支付宝支付：" . $alipayAdapter->pay(199.9, "OD20260106001") . "<br/>";
    echo "支付宝状态查询：" . $alipayAdapter->queryStatus("OD20260106001") . "<br/><br/>";

    // 2. 微信支付适配
    $wechatPay = new WechatPay();
    $wechatPayAdapter = new WechatPayAdapter($wechatPay);
    echo "微信支付：" . $wechatPayAdapter->pay(299.0, "OD20260106002") . "<br/>";
    echo "微信状态查询：" . $wechatPayAdapter->queryStatus("OD20260106002") . "<br/>";
} catch (\Exception $e) {
    echo "支付处理异常：" . $e->getMessage();
}

核心结构拆解

适配器模式的核心由“目标接口”“原始类”和“适配器类”三部分组成，结构清晰且职责明确：

关键优化点

常见错误规避

扩展场景示例（新增适配器无需修改原有代码）

若业务新增“银联支付”功能，其接口与现有目标接口不兼容，仅需新增适配器类，无需修改客户端和已有代码：

// 新增原始类：银联支付（接口不兼容目标接口）
class UnionPay
{
    public function unionPaySubmit(string $orderCode, float $payAmount): string
    {
        return sprintf("银联支付表单生成成功：<form action='https://pay.unionpay.com' method='post'><input name='order' value='%s'><input name='amount' value='%.2f'></form>", $orderCode, $payAmount);
    }

    public function unionPayQuery(string $orderCode): string
    {
        $statusList = ['未支付', '支付成功', '支付失败'];
        return sprintf("银联订单【%s】状态：%s", $orderCode, $statusList[array_rand($statusList)]);
    }
}

// 新增适配器：银联支付适配器
class UnionPayAdapter implements PaymentAdapterInterface
{
    private UnionPay $unionPay;

    public function __construct(UnionPay $unionPay)
    {
        $this->unionPay = $unionPay;
    }

    public function pay(float $amount, string $orderNo): string
    {
        return $this->unionPay->unionPaySubmit($orderNo, $amount);
    }

    public function queryStatus(string $orderNo): string
    {
        return $this->unionPay->unionPayQuery($orderNo);
    }
}

// 客户端调用新增适配器（无需修改原有代码）
$unionPay = new UnionPay();
$unionPayAdapter = new UnionPayAdapter($unionPay);
echo "银联支付：" . $unionPayAdapter->pay(399.5, "OD20260106003") . "<br/>";
echo "银联状态查询：" . $unionPayAdapter->queryStatus("OD20260106003") . "<br/>";

实际应用场景

适配器模式与其他模式对比