PHP 設計模式實戰：適配器模式統一異構數據庫介面

標準實現代碼

<?php
// Target：統一標準介面
interface IDatabase {
    public function connect(string $host, string $user, string $pass, string $db);
    public function query(string $sql): array;
    public function close();
}

// Adapter：MySQL 適配器
class MysqlAdapter implements IDatabase {
    private $conn;
    public function connect($host, $user, $pass, $db) {
        $this->conn = mysqli_connect($host, $user, $pass, $db);
        if (!$this->conn) throw new RuntimeException(mysqli_connect_error());
        mysqli_set_charset($this->conn, 'utf8mb4');
    }
    public function query($sql) {
        $res = mysqli_query($this->conn, $sql);
        if (!$res) throw new RuntimeException(mysqli_error($this->conn));
        return mysqli_fetch_all($res, MYSQLI_ASSOC);
    }
    public function close() { mysqli_close($this->conn); }
}

// Adapter：PostgreSQL 適配器
class PostgresqlAdapter implements IDatabase {
    private $conn;
    public function connect($host, $user, $pass, $db) {
        $dsn = "host=$host dbname=$db user=$user password=$pass";
        $this->conn = pg_connect($dsn);
        if (!$this->conn) throw new RuntimeException(pg_last_error());
    }
    public function query($sql) {
        $res = pg_query($this->conn, $sql);
        if (!$res) throw new RuntimeException(pg_last_error());
        return pg_fetch_all($res) ?: [];
    }
    public function close() { pg_close($this->conn); }
}

// 客戶端：僅依賴 IDatabase
function getUserList(IDatabase $db, int $limit = 10): array {
    return $db->query("SELECT * FROM users LIMIT $limit");
}

// 使用：配置驅動切換實現
$driver = $_ENV['DB_DRIVER'] ?? 'mysql';
$adapter = match ($driver) {
    'mysql'     => new MysqlAdapter(),
    'postgresql' => new PostgresqlAdapter(),
    default     => throw new InvalidArgumentException("Unknown driver: $driver"),
};

$adapter->connect('localhost', 'user', 'pass', 'app_db');
$users = getUserList($adapter);
$adapter->close();
print_r($users);

進階變體：雙向適配器 / 物件適配器

• 類適配器： 繼承 Adaptee + 實現 Target（PHP 單繼承限制較少用）
• 物件適配器（組合）： 持有 Adaptee 實例，委託調用（推薦，靈活解耦）
• 雙向適配器： 同時實現兩個 Target 介面，雙向轉換

現代 PHP 生態中的最佳實踐

• 數據庫層：直接使用 Doctrine DBAL 或 PDO（原生適配器模式實現）
• 緩存層：PSR-16 Simple Cache / Symfony Cache / Laravel Cache 統一介面
• HTTP 客戶端：PSR-18 HTTP Client / Guzzle / Symfony HttpClient
• 日誌：PSR-3 LoggerInterface / Monolog

適配器模式是「介面導向程式設計」的經典落地，**不要重複造輪子**——優先採用社區標準介面（PSR 系列），專注業務邏輯創新。