單例模式 確保某個類在全局範圍內 僅有一個實例,並提供一個全局訪問點獲取該實例。它不創建副本,而是返回內部靜態實例的引用。
private static $instance 保存唯一實例。private __construct()、private __clone() 禁止外部 new 和 clone。public static function getInstance() 延遲初始化並返回引用。<?php
class Database {
private PDO $pdo;
private static ?self $instance = null;
// 1. 私有構造:建立真實連接
private function __construct(string $dsn, string $user, string $pass, array $options = []) {
$this->pdo = new PDO($dsn, $user, $pass, $options);
$this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$this->pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
}
// 2. 禁止克隆
private function __clone() {}
// 3. 禁止反序列化創建實例
public function __wakeup() {
throw new Exception("Cannot unserialize singleton");
}
// 4. 統一訪問入口
public static function getInstance(string $dsn = '', string $user = '', string $pass = '', array $options = []): self {
if (self::$instance === null) {
if ($dsn === '') {
throw new Exception("首次調用必須提供連接參數");
}
self::$instance = new self($dsn, $user, $pass, $options);
}
return self::$instance;
}
// 5. 代理 PDO 核心方法
public function query(string $sql): PDOStatement|false {
return $this->pdo->query($sql);
}
public function prepare(string $sql): PDOStatement|false {
return $this->pdo->prepare($sql);
}
public function lastInsertId(string $name = null): string|false {
return $this->pdo->lastInsertId($name);
}
// ... 其他需要代理的方法
}
// ===== 使用示例 =====
// 引導階段(如 bootstrap.php)初始化一次
Database::getInstance(
'mysql:host=127.0.0.1;dbname=myapp;charset=utf8mb4',
'app_user',
'secret_pass',
[PDO::ATTR_PERSISTENT => true]
);
// 業務代碼任意處獲取同一連接
$db = Database::getInstance();
$stmt = $db->prepare('SELECT * FROM users WHERE id = ?');
$stmt->execute([1]);
$user = $stmt->fetch();
class Config {
private array $config = [];
private static ?self $instance = null;
private function __construct(array $configFiles = []) {
foreach ($configFiles as $file) {
if (is_file($file)) {
$this->config = array_merge($this->config, require $file);
}
}
}
private function __clone() {}
public function __wakeup() { throw new Exception("No unserialize"); }
public static function getInstance(array $configFiles = []): self {
if (self::$instance === null) {
self::$instance = new self($configFiles);
}
return self::$instance;
}
public function get(string $key, mixed $default = null): mixed {
$keys = explode('.', $key);
$val = $this->config;
foreach ($keys as $k) {
if (!is_array($val) || !array_key_exists($k, $val)) return $default;
$val = $val[$k];
}
return $val;
}
public function set(string $key, mixed $value): void {
$keys = explode('.', $key);
$ref = &$this->config;
foreach ($keys as $k) {
if (!is_array($ref) || !array_key_exists($k, $ref)) {
$ref[$k] = [];
}
$ref = &$ref[$k];
}
$ref = $value;
}
}
// 使用
Config::getInstance([__DIR__.'/config/app.php', __DIR__.'/config/db.php']);
echo Config::getInstance()->get('db.host'); // 127.0.0.1
PHP 是「請求級」生命週期:每次 HTTP 請求都是全新進程,**單例實例不會跨請求共享**。這意味著:
new PDO、重複解析配置文件。當有多個「單例服務」(DB、Config、Logger、Cache)時,用註冊表統一管理:
class ServiceRegistry {
private static array $services = [];
public static function set(string $key, object $service): void {
self::$services[$key] = $service;
}
public static function get(string $key): ?object {
return self::$services[$key] ?? null;
}
public static function has(string $key): bool {
return isset(self::$services[$key]);
}
}
// 初始化
ServiceRegistry::set('db', Database::getInstance(...));
ServiceRegistry::set('config', Config::getInstance(...));
// 使用
$db = ServiceRegistry::get('db');
| 反模式 | 危害 | 修正 |
|---|---|---|
| 構造函數公開 | 外部可 new 多個實例 | private __construct() |
| 忘記禁用 __clone | clone $singleton 創建副本 | private __clone() |
| 忘記禁用 __wakeup | unserialize() 繞過構造創建實例 | public function __wakeup() { throw ... } |
| getInstance 內部邏輯複雜 | 難以測試、隱藏依賴 | 依賴注入容器管理生命週期 |
| 濫用單例存儲請求狀態 | 導致狀態洩漏、難以測試 | 請求數據用 Request 對象/上下文傳遞 |
在 Laravel/Symfony/ThinkPHP 等現代框架中,**容器自動管理服務單例**,無需手寫單例類:
// Laravel 服務提供者
$this->app->singleton(Database::class, fn() => new Database(...));
// 控制器構造函數自動注入
class UserController {
public function __construct(protected Database $db) {}
}
單例模式在 PHP 中核心價值是 「請求內共享昂貴資源(DB連接、配置、日誌器)」。掌握標準實現、理解請求級生命週期、知曉現代框架如何用容器替代手寫單例,是 PHP 進階開發者的必修課。