單例模式確保類別全域僅有一個實例,並提供全域存取點。資料庫連線是經典應用場景:避免重複連線消耗資源、防止「too many connections」錯誤。本文展示經典寫法、PHP 8.1+ 唯讀屬性現代寫法、依賴注入容器整合與測試策略。
newgetInstance() 提供全域存取<?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
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();
<?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();
}
}
| 爭議點 | 說明 | 緩解方案 |
|---|---|---|
| 全域狀態 | 難以測試、隱藏依賴、併發風險 | 注入介面而非具體類、測試時用 Mock 替換容器綁定 |
| 單一資料庫限制 | 多資料庫場景無法直接支援 | 改用連線池、或以「連線名稱」為鍵的多單例 Map |
| 記憶體洩漏 | 長期運行程式累積連線/資源 | 定期重連、實現 close() 釋放、配合進程管理器重啟 |