当前位置：首页 > 文章列表 > 文章 > php教程 > PHP架构中适配器模式实例解析

PHP架构中适配器模式实例解析

2026-01-01 14:29:39 0浏览收藏

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《PHP架构中适配器模式应用实例详解》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

适配器模式解决接口不兼容问题，使AlipaySdk、WechatPayV3、StripeClient等第三方支付SDK能被同一套业务逻辑统一调用，通过定义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'];
    }
}