單例模式 是創建型設計模式之一,核心目標:確保某類別在全域僅有一個實例,並提供統一存取點。常用於資料庫連線、日誌記錄器、設定管理等資源密集型服務。
private __construct() 防止外部 new 實例化。private static $instance 儲存唯一實例。public static getInstance() 延遲實例化並回傳引用。補充: 實作 private __clone() 防止 clone 複製實例;PHP 5.4+ 可加上 private __wakeup() 防止反序列化繞過。
<?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 服務),保持類別純粹,由容器控制實例生命週期,更利於測試與解耦。