單例模式確保類**全局僅有一個實例**,並提供**全局訪問點**。在 PHP 中主要用於資料庫連接、配置管理、日誌記錄器等「重資源、全局共享」場景。本文給出標準實現、三要素解析、PHP 特有陷阱與現代依賴注入替代方案。
private __construct() 防止 new Class()。private static $instance = null; 持有唯一實例。public static function getInstance() 延遲創建並返回實例。**補充**:private __clone() 防止克隆、private __wakeup() 防止反序列化繞過。
pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
$this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
}
// 2. 防止克隆
private function __clone() {
trigger_error('Clone not allowed.', E_USER_ERROR);
}
// 3. 防止反序列化
public function __wakeup() {
throw new \Exception('Unserialize not allowed.');
}
// 4. 靜態工廠方法
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();
}
}
// 使用
$db = Database::getInstance();
$users = $db->query('SELECT * FROM users WHERE status = ?', [1]);
| 陷阱 | 後果 | 應對 |
|---|---|---|
| 請求級單例 vs 進程級單例 | PHP-FPM 每請求重置,$instance 不跨請求共享 | 理解 PHP 生命週期,單例僅在**單次請求**內唯一 |
| Swoole/RoadRunner 長駐進程 | 跨請求真正共享,可能導致連接池洩漏、狀態汙染 | 實現 resetInstance() 或使用連接池組件 |
| 繼承破壞單例 | 子類可 new Child() 繞過 | final class 或構造函數 final private |
| 序列化繞過 | unserialize(serialize($obj)) 創建新實例 | 實現 __wakeup 拋異常 |
| 反射實例化 | (new ReflectionClass())->newInstanceWithoutConstructor() | 極少見,框架級防護可用 ReflectionProperty::setAccessible 檢測 |
| 場景 | 適合單例? | 更好替代 |
|---|---|---|
| PDO 數據庫連接 | ⚠️ 僅單請求 | 依賴注入容器管理連接池 |
| 配置對象 | ✅ 只讀、全局訪問 | 容器綁定單例 $app->singleton() |
| 日誌記錄器 | ✅ 無狀態、高頻調用 | PSR-3 LoggerInterface + 容器綁定 |
| 緩存客戶端 | ⚠️ 有狀態連接 | 容器管理生命週期 |
| 業務服務類 | ❌ 有狀態、需測試替換 | 依賴注入 + 接口綁定 |
// AppServiceProvider::register()
$this->app->singleton(Database::class, function () {
return new Database(config('database'));
});
// 控制器構造子注入(自動解析單例)
public function __construct(Database $db) {
$this->db = $db;
}
優勢:可測試(測試時綁定 Mock)、可替換(換實現只改綁定)、生命週期可控(請求級/單例/瞬態隨意切換)。
單例模式在 PHP 傳統請求響應模型中作用有限(天然請求隔離),但在長駐進程、CLI 腳本、框架核心組件中仍有價值。**現代 PHP 開發首選依賴注入容器管理共享實例**,單例模式作為容器的「單例綁定」實現細節存在,而非業務代碼直接調用的靜態方法。