PHP项目适配器与接口转换

本文目录导读：

1. 核心概念区分
2. 适配器模式的两种实现方式
3. 实战场景示例
4. 接口转换的几种情况
5. 最佳实践与注意事项

在PHP项目中,适配器模式和接口转换是解决系统间不兼容问题的核心手段，它们可以帮助你在不修改现有代码的情况下，让原本不兼容的类协同工作。

以下是关于PHP项目中适配器与接口转换的详细讲解和实战示例。

核心概念区分

1. 接口（Interface）：
   • 定义了一套行为规范（方法签名）。
   • 确保实现该接口的类都提供相同的方法。
2. 适配器（Adapter）：
   • 一个中间类,它将一个类的接口转换成客户端所期望的另一个接口。
   • 目标：让不兼容的类能够合作。

适配器模式的两种实现方式

类适配器（继承 & 实现）

• 原理：适配器同时继承（或实现）目标接口和待适配的类。
• PHP特点：PHP是单继承，无法同时继承两个类，因此通常用“继承一个类 + 实现一个接口”。

对象适配器（组合，推荐）

• 原理：适配器持有待适配对象的实例，并通过实现目标接口来封装对其的调用。
• 优点：更灵活，符合“组合优于继承”原则，可以适配多个不同的子系统。

实战场景示例

假设你有一个旧版支付系统（OldPayment），它的方法名是payWithCard($amount)，但你的新系统需要调用pay($amount)。

场景1：对象适配器（最常用）

<?php
// 1. 目标接口（新系统期望的规范）
interface PaymentInterface {
    public function pay(float $amount): string;
}
// 2. 待适配的类（旧系统，接口不兼容）
class OldPayment {
    public function payWithCard(float $amount): string {
        return "旧系统：通过卡支付了 " . $amount . " 元";
    }
}
// 3. 适配器类
class PaymentAdapter implements PaymentInterface {
    private OldPayment $oldPayment;
    // 构造函数注入待适配对象
    public function __construct(OldPayment $oldPayment) {
        $this->oldPayment = $oldPayment;
    }
    // 转换接口：将新系统的 pay 转换为旧系统的 payWithCard
    public function pay(float $amount): string {
        // 可以在这里进行参数转换、日志、格式处理等
        return $this->oldPayment->payWithCard($amount);
    }
}
// 4. 客户端使用（新系统）
function processPayment(PaymentInterface $payment, float $amount) {
    echo $payment->pay($amount);
}
// 使用适配器
$oldPayment = new OldPayment();
$adapter = new PaymentAdapter($oldPayment);
// 新系统无需修改，传入适配器即可
processPayment($adapter, 100.50);
// 输出：旧系统：通过卡支付了 100.5 元

场景2：适配多个不同的第三方SDK

<?php
// 统一接口
interface SMSInterface {
    public function send(string $phone, string $message): bool;
}
// 第三方A：阿里云短信（方法不同）
class AliyunSMS {
    public function sendSMS(string $mobile, string $content): bool {
        // ... 实际调用阿里云API
        return true;
    }
}
// 第三方B：腾讯云短信（方法不同）
class TencentSMS {
    public function sendMessage(string $phoneNumber, string $msgContent): bool {
        // ... 实际调用腾讯云API
        return true;
    }
}
// 适配器A
class AliyunAdapter implements SMSInterface {
    private AliyunSMS $aliyun;
    public function __construct(AliyunSMS $aliyun) {
        $this->aliyun = $aliyun;
    }
    public function send(string $phone, string $message): bool {
        return $this->aliyun->sendSMS($phone, $message);
    }
}
// 适配器B
class TencentAdapter implements SMSInterface {
    private TencentSMS $tencent;
    public function __construct(TencentSMS $tencent) {
        $this->tencent = $tencent;
    }
    public function send(string $phone, string $message): bool {
        return $this->tencent->sendMessage($phone, $message);
    }
}
// 客户端：随意切换短信服务商
function notifyUser(SMSInterface $sms, string $phone, string $msg) {
    if ($sms->send($phone, $msg)) {
        echo "短信发送成功\n";
    }
}
// 使用阿里云
notifyUser(new AliyunAdapter(new AliyunSMS()), "13800138000", "你好");
// 使用腾讯云
notifyUser(new TencentAdapter(new TencentSMS()), "13900139000", "Hello");

接口转换的几种情况

除了适配器模式,你在PHP项目中还会遇到以下几种接口转换的需求：

数据格式转换（DTO/Data Transfer Object）

• 问题：外部API返回的JSON结构与内部实体类的属性不一致。
• 解决：创建一个转换器类，将API响应映射为内部对象。

// 外部数据
$apiData = [
    'full_name' => '张三',
    'user_age' => 30,
];
// 内部实体
class User {
    public string $name;
    public int $age;
}
// 转换器
class UserMapper {
    public static function fromApi(array $data): User {
        $user = new User();
        $user->name = $data['full_name'];
        $user->age = (int) $data['user_age'];
        return $user;
    }
}
$user = UserMapper::fromApi($apiData);

参数签名转换（不同类型的参数传递）

• 问题：一个组件期望接收数组，另一个期望对象。
• 解决：在调用层进行解包/打包。

// A组件需要对象
function handleObject(User $user) { ... }
// B组件返回数组
function getData(): array { ... }
// 转换
$user = new User();
$user->name = $data['name'];
handleObject($user);

事件/回调适配

• 问题：不同库的事件监听器格式不同。
• 解决：包装一个通用的监听器。

最佳实践与注意事项

1. 优先使用对象适配器：组合比继承更灵活，易于测试和维护。
2. 保持适配器简单：适配器只做“接口翻译”，不要在里面塞入业务逻辑。
3. 明确适配的目的是什么：是为了统一入口？还是为了解耦？不要让适配器过度复杂。
4. 不要过度设计：如果只有一种第三方实现，没必要提前写适配器，当出现第二个同类服务时再考虑重构。
5. 利用PHP的动态特性：PHP弱类型可以简化一些转换，但会降低类型安全，建议使用declare(strict_types=1)来补强。

在你的PHP项目中,遇到“老代码改不动，新代码又想用统一接口”的情况时，找一个适配器准没错。