萬盛學電腦網

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

PHP 單例模式完整實作與資料庫連線範例

確保全域唯一實例:單例模式深度解析

單例模式 是創建型設計模式之一,核心目標:確保某類別在全域僅有一個實例,並提供統一存取點。常用於資料庫連線、日誌記錄器、設定管理等資源密集型服務。

單例模式三大核心要素

  1. 私有化建構子:private __construct() 防止外部 new 實例化。
  2. 靜態實例屬性:private static $instance 儲存唯一實例。
  3. 公開靜態取得方法:public static getInstance() 延遲實例化並回傳引用。

補充: 實作 private __clone() 防止 clone 複製實例;PHP 5.4+ 可加上 private __wakeup() 防止反序列化繞過。

資料庫連線單例實作(PDO 版)

<?php
class Database {
    private static $instance = null;
    private $pdo;

    // 私有建構子:建立 PDO 連線
    private function __construct() {
        $dsn = 'mysql:host=127.0.0.1;dbname=myapp;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() {}
    // 防止反序列化
    private function __wakeup() {}

    // 統一存取點
    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    // 代理 PDO 方法
    public function query(string $sql, array $params = []) {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt;
    }

    public function getPdo(): PDO {
        return $this->pdo;
    }
}

// 使用方式
$db = Database::getInstance();
$users = $db->query('SELECT * FROM users WHERE status = ?', [1])->fetchAll();

// 任何地方呼叫 getInstance() 都拿到同一個連線
$db2 = Database::getInstance();
var_dump($db === $db2); // true
?>

單例模式優缺點權衡

優點缺點
全域唯一存取點,資源共享隱藏依賴關係,單元測試較難 mock
延遲初始化,節省資源違反單一職責(同時負責業務與生命週期)
避免重複建立昂貴連線多執行緒環境需額外同步(PHP 通常無此問題)

現代替代方案:依賴注入容器

在現代框架中,傾向使用 DI 容器 管理共享服務(如 Laravel 的 singleton 綁定、Symfony 的 shared: true 服務),保持類別純粹,由容器控制實例生命週期,更利於測試與解耦。

copyright © 萬盛學電腦網 all rights reserved