萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 單例模式完整實現:資料庫連線經典應用與現代寫法對比

單例模式確保類別全域僅有一個實例,並提供全域存取點。資料庫連線是經典應用場景:避免重複連線消耗資源、防止「too many connections」錯誤。本文展示經典寫法、PHP 8.1+ 唯讀屬性現代寫法、依賴注入容器整合與測試策略。

核心三要素

  1. 私有靜態屬性儲存唯一實例
  2. 私有建構子防止外部 new
  3. 公開靜態方法 getInstance() 提供全域存取

經典寫法(PHP 5.3+ 相容)

<?php
class Database {
    private static $instance = null;
    private $pdo;
    
    // 私有建構子:建立實際連線
    private function __construct() {
        $dsn = 'mysql:host=127.0.0.1;dbname=app;charset=utf8mb4';
        $this->pdo = new PDO($dsn, 'user', 'pass', [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES => false,
        ]);
    }
    
    // 防止克隆
    private function __clone() {}
    
    // 防止反序列化建立新實例
    public function __wakeup() {
        throw new Exception("Cannot unserialize singleton");
    }
    
    // 靜態工廠方法
    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }
    
    // 代理 PDO 方法
    public function __call(string $method, array $args) {
        return $this->pdo->$method(...$args);
    }
}

// 使用
$db = Database::getInstance();
$stmt = $db->query("SELECT * FROM users LIMIT 1");
var_dump($stmt->fetch());

現代寫法(PHP 8.1+ readonly + 型別系統)

<?php
final class Database {
    private static ?self $instance = null;
    private readonly PDO $pdo;
    
    private function __construct() {
        $this->pdo = new PDO(
            'mysql:host=127.0.0.1;dbname=app;charset=utf8mb4',
            'user', 'pass',
            [
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::ATTR_EMULATE_PREPARES => false,
            ]
        );
    }
    
    public static function getInstance(): self {
        return self::$instance ??= new self(); // nullsafe operator + 懶惰初始化
    }
    
    // 直接暴露 PDO(或定義精確介面方法)
    public function getPdo(): PDO {
        return $this->pdo;
    }
    
    // 禁止克隆/序列化(final 類別隱含防止繼承破壞)
}

// 使用
$users = Database::getInstance()->getPdo()->query("SELECT * FROM users")->fetchAll();

依賴注入容器整合(Laravel/Symfony/ThinkPHP 風格)

<?php
// 服務提供者註冊(單例綁定)
$container->singleton(Database::class, function () {
    return Database::getInstance();
});

// 或綁定 PDO 介面
$container->singleton(PDO::class, function () {
    return Database::getInstance()->getPdo();
});

// 控制器建構子注入
class UserController {
    public function __construct(private PDO $db) {}
    
    public function index() {
        return $this->db->query("SELECT * FROM users")->fetchAll();
    }
}

單例模式的爭議與替代方案

多資料庫單例 Map 擴展

class DatabaseManager {
    private static array $instances = [];
    
    public static function connection(string $name = 'default'): PDO {
        if (!isset(self::$instances[$name])) {
            $config = config("database.connections.$name");
            self::$instances[$name] = new PDO(
                "{$config['driver']}:host={$config['host']};dbname={$config['database']};charset={$config['charset']}",
                $config['username'], $config['password'],
                [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
            );
        }
        return self::$instances[$name];
    }
}

// 使用
$mainDb = DatabaseManager::connection('default');
$logDb = DatabaseManager::connection('logging');

測試策略

<?php
// PHPUnit 測試中重置單例(利用反射)
function resetSingleton(string $className): void {
    $reflection = new ReflectionClass($className);
    $property = $reflection->getProperty('instance');
    $property->setAccessible(true);
    $property->setValue(null, null);
}

// 測試案例
public function testDatabaseQuery() {
    resetSingleton(Database::class);
    $mockPdo = $this->createMock(PDO::class);
    // 綁定 Mock 到容器...
    $result = Database::getInstance()->query("SELECT 1");
    $this->assertEquals(1, $result);
}

總結

  • 單例模式解決「全域唯一實例」需求,資料庫連線是教科書級應用場景
  • 現代 PHP 推薦 依賴注入 + 容器單例綁定 替代靜態 getInstance(),提升可測試性
  • 若必須用靜態單例,務必實現 __clone、__wakeup 防禦、支援重置機制
  • PHP 8.1+ readonly、final、nullsafe 讓實現更簡潔安全
copyright © 萬盛學電腦網 all rights reserved
爭議點說明緩解方案
全域狀態難以測試、隱藏依賴、併發風險注入介面而非具體類、測試時用 Mock 替換容器綁定
單一資料庫限制多資料庫場景無法直接支援改用連線池、或以「連線名稱」為鍵的多單例 Map
記憶體洩漏長期運行程式累積連線/資源定期重連、實現 close() 釋放、配合進程管理器重啟