当前位置：首页 > 文章列表 > 文章 > php教程 > PHP适配器模式实战应用解析

PHP适配器模式实战应用解析

2026-04-12 09:42:28 0浏览收藏

本文深入剖析了适配器模式在PHP支付系统架构中的关键应用，直击多第三方SDK（如支付宝、微信支付V3、Stripe）接口不兼容的痛点，通过定义统一的PayInterface并为各SDK编写轻量级适配器，仅专注参数转换、异常映射与返回值标准化，从而让同一套业务逻辑无缝对接不同支付渠道；文章不仅给出了清晰可复用的代码范例，还犀利指出常见误用陷阱（如混淆适配器与工厂、侵入业务逻辑）、适用边界（强调“变化点”驱动而非过度设计），并厘清其与策略模式的本质区别——适配器弥合接口鸿沟，策略选择算法路径，二者常协同构建高扩展、易维护的支付中台能力。

PHP架构里适配器模式怎么用_实例讲解【说明】

适配器模式解决什么问题

当你的 PHP 项目要对接多个第三方支付 SDK（比如 AlipaySdk、WechatPayV3、StripeClient），但它们的接口不统一——有的用 pay($order)，有的叫 createPayment($data)，还有的返回数组而另一个抛异常——这时直接写 if-else 调用会迅速失控。适配器模式不是为了“增强功能”，而是让这些不兼容的类“能被同一套业务逻辑调用”。

怎么写一个支付适配器

核心是定义统一接口，再为每个 SDK 写一个实现该接口的包装类。不要修改原 SDK 源码，也不继承它（除非 SDK 明确支持继承且无副作用）。

常见错误：把适配器写成工厂或门面；或者在适配器里加业务逻辑（比如自动重试、日志埋点），这会让适配器偏离单一职责。

统一接口必须只声明业务需要的操作，例如：PayInterface::pay() 和 PayInterface::query()
每个适配器构造函数接收对应 SDK 的实例（依赖注入），而不是在内部 new 它
适配器里只做参数转换、异常映射、返回值标准化，不处理订单状态机或金额校验

interface PayInterface
{
    public function pay(array $order): array;
    public function query(string $tradeNo): array;
}

class AlipayAdapter implements PayInterface
{
    private $sdk;

    public function __construct(\Alipay\AopClient $sdk)
    {
        $this->sdk = $sdk;
    }

    public function pay(array $order): array
    {
        $request = new \Alipay\Request\AlipayTradePagePayRequest();
        $request->setBizContent(json_encode([
            'out_trade_no' => $order['id'],
            'total_amount' => $order['amount'],
            'subject' => $order['title'],
        ]));
        $result = $this->sdk->execute($request);
        // 把支付宝的 stdClass / array / 异常转成统一 array 结构
        return [
            'success' => !empty($result->body),
            'redirect_url' => $result->body ?? '',
            'raw' => $result,
        ];
    }

    public function query(string $tradeNo): array
    {
        // 实现类似逻辑...
        return ['status' => 'paid'];
    }
}