單例模式確保類別在全域只有唯一實例,並提供全域存取點。但在 PHP 「分享無物件」的請求生命週期模型下,單例模式的意義與 Java/C# 截然不同。本文深入解析 PHP 單例實作細節、頁面級限制、資料庫連線應用場景與現代替代方案。
<?php
class Singleton {
// 1. 私有靜態屬性保存唯一實例
private static ?self $instance = null;
// 2. 私有建構子,防止外部 new
private function __construct() {
// 初始化邏輯(如資料庫連線)
}
// 3. 私有克隆方法,防止 clone
private function __clone() {}
// 4. 私有反序列化,防止 unserialize 繞過
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 doSomething(): void {
echo "單例實例操作\n";
}
}
// 使用
$instance = Singleton::getInstance();
$instance->doSomething();
// 以下會報錯
// $obj = new Singleton(); // Error: private constructor
// $obj2 = clone $instance; // Error: private clone
// $obj3 = unserialize(serialize($instance)); // Error: __wakeup
?>
PHP 是「請求級」執行模型:每個 HTTP 請求獨立啟動 PHP 進程/執行緒,載入腳本、執行、銷毀所有記憶體變數(含靜態屬性)。
<?php
class Database {
private static ?self $instance = null;
private PDO $pdo;
private function __construct() {
$dsn = 'mysql:host=localhost;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,
PDO::ATTR_PERSISTENT => true, // 持久連線(跨請求複用 TCP 連線)
]);
}
public static function getInstance(): self {
if (self::$instance === null) {
self::$instance = new self();
}
return self::$instance;
}
private function __clone() {}
public function __wakeup() { throw new Exception("不可反序列化"); }
public function getPdo(): PDO {
return $this->pdo;
}
// 便利查詢方法
public function fetchOne(string $sql, array $params = []): ?array {
$stmt = $this->pdo->prepare($sql);
$stmt->execute($params);
return $stmt->fetch() ?: null;
}
public function fetchAll(string $sql, array $params = []): array {
$stmt = $this->pdo->prepare($sql);
$stmt->execute($params);
return $stmt->fetchAll();
}
public function execute(string $sql, array $params = []): bool {
$stmt = $this->pdo->prepare($sql);
return $stmt->execute($params);
}
public function lastInsertId(): string {
return $this->pdo->lastInsertId();
}
}
// 控制器/服務中使用
$db = Database::getInstance();
$user = $db->fetchOne('SELECT * FROM users WHERE email = ?', [$email]);
$db->execute('INSERT INTO logs (message) VALUES (?)', ['User logged in']);
?>
這才是真正跨請求複用資料庫連線的關鍵(由 PHP 進程池管理),而非單例模式本身。單例只是確保同一請求內不重複建立 PDO 物件。
<?php
class Registry {
private static array $instances = [];
public static function set(string $key, object $instance): void {
self::$instances[$key] = $instance;
}
public static function get(string $key): ?object {
return self::$instances[$key] ?? null;
}
public static function has(string $key): bool {
return isset(self::$instances[$key]);
}
}
// 註冊各種單例服務
Registry::set('db', Database::getInstance());
Registry::set('config', Config::getInstance());
Registry::set('logger', Logger::getInstance());
// 任何地方取用
$db = Registry::get('db');
$logger = Registry::get('logger');
?>
單例模式屬於「服務定位器」反模式,隱藏相依性、難以測試、耦合全域狀態。現代框架(Laravel、Symfony、Hyperf)採用 依賴注入容器:
<?php
// 概念示意(非完整容器實作)
class Container {
private array $bindings = [];
private array $instances = [];
public function bind(string $abstract, callable $concrete, bool $singleton = false): void {
$this->bindings[$abstract] = ['concrete' => $concrete, 'singleton' => $singleton];
}
public function make(string $abstract): mixed {
if (isset($this->instances[$abstract])) {
return $this->instances[$abstract];
}
if (!isset($this->bindings[$abstract])) {
throw new Exception("未綁定: $abstract");
}
$binding = $this->bindings[$abstract];
$instance = $binding['concrete']($this);
if ($binding['singleton']) {
$this->instances[$abstract] = $instance;
}
return $instance;
}
}
// 綁定
$container = new Container();
$container->bind(PDO::class, fn() => new PDO($dsn, $user, $pass, $options), true); // 單例
$container->bind(UserService::class, fn($c) => new UserService($c->make(PDO::class)));
// 使用(自動遞迴解析相依)
$userService = $container->make(UserService::class);
?>
| 條件 | 是否適合單例 |
|---|---|
| 需跨請求保持狀態 | ❌ 不適合(用 Redis/DB/Session) |
| 單一請求內多處共享昂貴資源(DB連線、設定、Logger) | ✅ 適合 |
| 無狀態工具類(如 Utils、Helpers) | ❌ 不需實例,用 static 方法或函數 |
| 需支援多實例配置(如多資料庫連線) | ❌ 不適合(用工廠模式) |
| 單元測試需隔離、Mock | ❌ 單例難測試(用 DI 容器) |
PHP 單例模式的核心價值在於單一請求內避免重複建立昂貴資源,而非跨請求全域唯一。理解「請求級生命週期」是正確應用的前提。現代專案建議採用依賴注入容器管理服務生命週期,獲得更好的可測試性、解耦合與擴展性。單例模式可作為容器內部的單例綁定實現細節存在,而非直接暴露於業務代碼中。