單例模式確保某個類別在全域僅有一個實例,並提供全域存取點。常用於資料庫連線、配置管理、日誌記錄等「全域唯一」場景。本文從核心原理到完整程式碼逐層剖析。
new 實例化<?php
class Database {
// 1. 靜態私有屬性:保存唯一實例
private static ?self $instance = null;
// 2. 私有建構子:禁止外部 new
private function __construct() {
// 初始化資料庫連線等昂貴操作
$this->pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
$this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
}
// 3. 禁止克隆
private function __clone() {}
// 4. 禁止反序列化
public function __wakeup() {
throw new Exception("不能反序列化單例");
}
// 5. 公靜態存取點
public static function getInstance(): self {
if (self::$instance === null) {
self::$instance = new self();
}
return self::$instance;
}
// 業務方法範例
public function query(string $sql, array $params = []): array {
$stmt = $this->pdo->prepare($sql);
$stmt->execute($params);
return $stmt->fetchAll(PDO::FETCH_ASSOC);
}
}
// 使用方式
$db = Database::getInstance();
$users = $db->query('SELECT * FROM users WHERE status = ?', [1]);
var_dump($users);
首次呼叫 Database::getInstance()
│
▼
self::$instance === null ? ──Yes──► new self() ──► 存入 self::$instance ──► 回傳
│
No
│
▼
直接回傳 self::$instance
PHP 以多進程模式運行,每個 Worker 進程有獨立記憶體空間,單例僅在單一進程內唯一。跨進程共享需借助 Redis、共享記憶體或資料庫鎖。
現代框架(Laravel、Symfony)透過服務容器管理單例生命週期,建議改用容器綁定:
// Laravel 服務提供者中
$this->app->singleton(Database::class, fn() => new Database());
// 控制器中自動注入
public function index(Database $db) { ... }
單例難以 Mock,單元測試時可:
setInstance(null) 重置方法(僅測試環境開放)<?php
// 單例枚舉(PHP 8.1+)
enum Database: string {
case Instance = 'default';
private PDO $pdo;
public function getPDO(): PDO {
if (!isset($this->pdo)) {
$this->pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
}
return $this->pdo;
}
}
// 使用
$pdo = Database::Instance->getPDO();
枚舉單例天然防禦反序列化、克隆、多執行緒競態,是現代 PHP 的最佳選擇。