單例模式確保類別全域唯一實例,並提供全域存取點。雖然因「全域狀態、難測試、違反單一職責」備受爭議,但在資料庫連線、配置管理、日誌記錄、快取驅動等場景仍是實務常見選擇。本文提供標準實作、執行緒安全考量、PHP 特有變體、現代依賴注入替代方案與反模式警示。
<?php
declare(strict_types=1);
namespace App\Patterns;
final class DatabaseConnection {
/** @var self|null 唯一實例 */
private static ?self $instance = null;
/** @var PDO 實際連線物件 */
private PDO $pdo;
/** 私有建構子:防止外部 new */
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,
]);
}
/** 防止 clone */
private function __clone(): void {}
/** 防止反序列化建立新實例 */
public function __wakeup(): void {
throw new \Exception("不能反序列化單例");
}
/** 取得唯一實例(執行緒不安全,PHP 通常單執行緒) */
public static function getInstance(): self {
if (self::$instance === null) {
self::$instance = new self();
}
return self::$instance;
}
/** 對外暴露 PDO 實例 */
public function getPdo(): PDO {
return $this->pdo;
}
/** 方便直接呼叫 PDO 方法 */
public function __call(string $name, array $arguments) {
return $this->pdo->$name(...$arguments);
}
}
// 使用
$pdo = DatabaseConnection::getInstance()->getPdo();
$stmt = $pdo->query('SELECT VERSION()');
echo $stmt->fetchColumn();
?>
final 類別防止繼承破壞單例(子類別會有各自的 static $instance)。
private __construct() + private __clone() + __wakeup()三重保障:禁止 new、clone、unserialize() 建立新實例。
self::$instance儲存於類別層級,請求生命週期內唯一。PHP 為單執行緒(PHP-FPM/CLI),無競態條件問題;Swoole/RoadRunner 等長駐環境需額外加鎖。
<?php
abstract class Singleton {
private static array $instances = [];
final public static function getInstance(): static {
$class = static::class; // LSB:取得實際呼叫的子類別
if (!isset(self::$instances[$class])) {
self::$instances[$class] = new static();
}
return self::$instances[$class];
}
protected function __construct() {}
private function __clone() {}
public function __wakeup() { throw new \Exception('No unserialize'); }
}
class Config extends Singleton {
public array $settings = [];
}
class Logger extends Singleton {
public function log(string $msg) { echo "[LOG] $msg\n"; }
}
Config::getInstance()->settings['debug'] = true;
Logger::getInstance()->log('App started');
// Config 與 Logger 各自擁有獨立單例
?>
| 優點 | 缺點 |
|---|---|
| 全域唯一存取點,避免重複建立昂貴資源(DB 連線、Redis 連線) | 隱性依賴:類別間耦合隱藏在 ::getInstance() 呼叫中 |
| 延遲初始化:首次使用才建立 | 難以單元測試:無法輕易 Mock、狀態殘留汙染測試 |
| 比全域變數更受控(封裝在類別內) | 違反單一職責:類別同時負責業務邏輯與生命週期管理 |
| 可透過 LSB 支援多單例(每個子類一個實例) | 擴充性差:新增參數需修改 getInstance() 簽名 |
現代框架均採用 DI 容器管理共享服務,單例成為服務定義範疇而非類別職責。
<?php
// 介面定義
interface ContainerInterface {
public function get(string $id): mixed;
public function has(string $id): bool;
}
// 簡易實作
class Container implements ContainerInterface {
private array $services = [];
private array $instances = [];
public function register(string $id, callable $factory, bool $singleton = true): void {
$this->services[$id] = [$factory, $singleton];
}
public function get(string $id): mixed {
if (!isset($this->services[$id])) {
throw new \InvalidArgumentException("Service $id not found");
}
[$factory, $singleton] = $this->services[$id];
if ($singleton) {
return $this->instances[$id] ??= $factory($this);
}
return $factory($this);
}
public function has(string $id): bool {
return isset($this->services[$id]);
}
}
// 註冊服務
$container = new Container();
$container->register('db', fn($c) => new PDO('mysql:host=localhost;dbname=app', 'u', 'p'));
$container->register('logger', fn($c) => new Logger($c->get('db')), singleton: true);
// 使用(建構子注入)
class UserService {
public function __construct(
private PDO $db,
private Logger $logger
) {}
}
$userService = new UserService($container->get('db'), $container->get('logger'));
?>
✅ 適合使用單例:
Str::uuid()、DateTimeHelper(靜態方法即可,無需單例)。❌ 避免使用單例:
OrderService、UserRepository。<?php
// ❌ 反模式:全域陣列當單例儲存
$GLOBALS['db'] = new PDO(...);
function getUser($id) {
return $GLOBALS['db']->query(...); // 隱性依賴、難測試
}
// ❌ 反模式:靜態屬性儲存請求狀態
class Request {
public static $input = []; // 併發災難!
}
// ✅ 正確:請求資料注入或從容器取得
class Request {
public function __construct(
private array $query,
private array $body
) {}
}
?>
單例模式在 PHP 中實作簡單(得益於單執行緒),但濫用即技術債。現代最佳實踐:資源型服務交給 DI 容器管理單例範疇,業務類別走建構子注入,靜態工具類直接用靜態方法。若確需在舊專案引入單例,請嚴守「final、私有建構子、防 clone/wakeup、LSB 支援」四大鐵律,並寫入架構決策記錄 (ADR) 供未來重構參考。