如何在PHP中实现适配器模式_通过中间层兼容不同接口-php教程-PHP中文网

PHP适配器模式核心是编写显式转换参数/返回值的中间类，而非仅实现接口；因interface不自动重排参数或转换类型，需在适配器中手动映射并严格匹配PHP 8.5类型声明。

如何在php中实现适配器模式_通过中间层兼容不同接口

PHP里实现适配器模式，核心不是“实现接口”，而是写一个明确包装旧对象、严格转换参数/返回值的中间类——否则光有implements根本跑不起来。

为什么直接 implements 同一个 interface 不起作用

常见错误是让新旧类都实现 MailInterface，就以为能互换。但老类方法可能是 sendMail($to, $subject, $body)，新接口要求的是 send($recipient, $title, $content)。PHP 的 interface 只校验方法名和签名，不自动做参数重排或类型转换。

调用方传进来的参数顺序、键名、类型，必须由适配器显式接收并转给被适配对象
如果老类返回 bool，而新接口声明返回 string|null，适配器里就得补上 return $success ? 'ok' : null;
PHP 8.5 下，类型不匹配会直接报 Fatal error: Declaration of ... must be compatible with ...

对象适配器怎么写：构造函数 + 委托调用

PHP 不支持多继承，所以只用对象适配器（组合），不用类适配器（继承）。关键点在构造函数注入被适配对象，并在每个方法里手动转发。

class OldMailer
{
    public function sendMail($to, $subject, $body)
    {
        // legacy logic
        return true;
    }
}
<p>interface MailInterface
{
public function send(string $recipient, string $title, string $content): bool;
}</p><p>class OldMailerAdapter implements MailInterface
{
public function __construct(private OldMailer $oldMailer) {}</p><pre class="brush:php;toolbar:false;">public function send(string $recipient, string $title, string $content): bool
{
    // 参数顺序转换：$recipient → $to, $title → $subject, $content → $body
    return $this->oldMailer->sendMail($recipient, $title, $content);
}

}

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

构造函数必须显式接收 $oldMailer 实例，不能靠 new OldMailer() 硬编码
方法体内不做业务逻辑，只做映射；异常也别吞掉，该 throw 就 throw，但建议统一转成你自己的 AdapterException
PHP 8.5 要求返回类型严格匹配，sendMail() 返回 bool，那 send() 就不能声明为 void 或 mixed

PHP 8.5 下最容易翻车的三个类型坑

PHP 8.5 没废掉适配器模式，但它会让旧适配器代码立刻暴露问题，尤其在类型声明模糊的地方。

老接口返回 array，新接口要 list<string></string>？得在适配器里加 array_values(array_filter($arr, 'is_string')) 显式转换，不能依赖隐式行为
用了 #[\ReturnTypeWillChange] 的旧适配器，在 declare(strict_types=1) 下可能升级为 fatal error，建议直接补全返回类型
__call() 方法必须声明返回类型，比如底层可能返回 string|false，那就得写成 public function __call(string $name, array $arguments): string|false，写 mixed 是自欺欺人