适配器模式通过定义统一接口DataAdapterInterface，使数组和对象数据源经ArrayDataAdapter和ObjectDataAdapter适配后，能以相同方式被displayUserInfo函数调用，实现接口兼容。
在PHP开发中，不同系统或模块之间数据格式不一致是常见问题。适配器模式（Adapter Pattern）能有效解决接口不兼容的问题，让原本无法协作的类可以一起工作。特别是在处理多种数据源（如数组、JSON、数据库记录等）时，使用适配器模式可以让上层代码无需关心底层数据结构，统一调用方式。
什么是适配器模式
适配器模式属于结构型设计模式，它的核心思想是：将一个类的接口转换成客户端期望的另一个接口。适配器起到“中间转化”的作用，就像电源插头转换器一样，让不同标准的设备可以正常工作。
在PHP中，适配器模式常用于：
- 整合第三方API返回的不同数据结构
- 统一本地与远程服务的数据输出格式
- 兼容旧版本接口和新系统之间的交互
定义统一的数据接口
为了让不同数据源能被统一处理，先定义一个标准化接口：
立即学习“PHP免费学习笔记（深入）”；
interface DataAdapterInterface {
public function getId();
public function getName();
public function getEmail();
}
这个接口规定了所有适配器必须实现的方法，上层业务逻辑只依赖该接口，而不关心具体实现。
为不同数据结构创建适配器
假设我们有两个数据来源：一个是关联数组，另一个是JSON字符串解析后的对象。它们结构不同，但需要提供相同访问方式。
数组数据适配器
class ArrayDataAdapter implements DataAdapterInterface {
private $data;
public function __construct(array $data) {
$this->data = $data;
}
public function getId() {
return $this->data['id'] ?? null;
}
public function getName() {
return $this->data['full_name'] ?? $this->data['name'] ?? '';
}
public function getEmail() {
return $this->data['email_address'] ?? $this->data['email'] ?? '';
}
}
对象/StdClass数据适配器
class ObjectDataAdapter implements DataAdapterInterface {
private $obj;
public function __construct($obj) {
$this->obj = $obj;
}
public function getId() {
return $this->obj->user_id ?? $this->obj->id ?? null;
}
public function getName() {
return $this->obj->username ?? $this->obj->name ?? '';
}
public function getEmail() {
return $this->obj->contact_email ?? $this->obj->email ?? '';
}
}
实际应用示例
现在我们可以用统一的方式处理不同类型的数据：
// 模拟从不同来源获取的数据
$arrayData = [
'id' => 1,
'full_name' => '张三',
'email_address' => 'zhangsan@example.com'
];
$jsonString = '{"user_id": 2, "username": "李四", "contact_email": "lisi@example.com"}';
$objData = json_decode($jsonString);
// 创建对应的适配器
$adapter1 = new ArrayDataAdapter($arrayData);
$adapter2 = new ObjectDataAdapter($objData);
// 统一调用
function displayUserInfo(DataAdapterInterface $adapter) {
echo "ID: " . $adapter->getId() . "\n";
echo "姓名: " . $adapter->getName() . "\n";
echo "邮箱: " . $adapter->getEmail() . "\n\n";
}
displayUserInfo($adapter1);
displayUserInfo($adapter2);
输出结果：
ID: 1 姓名: 张三 邮箱: zhangsan@example.com ID: 2 姓名: 李四 邮箱: lisi@example.com
即使原始数据结构完全不同，通过适配器模式，上层函数无需修改即可正确读取信息。
基本上就这些。适配器模式的关键在于抽象出通用接口，并封装差异细节。它提升了代码的扩展性和维护性，特别适合需要集成多个外部系统或遗留模块的项目。不复杂但容易忽略的是命名一致性与字段映射的完整性，建议结合配置或映射表来管理复杂字段对应关系。
