確保某類別**全域僅有一個實例**,並提供全域存取點。典型用途:資料庫連線、設定管理、日誌記錄器、快取客戶端。
<?php
class DbConn {
private static $instance;
private function __construct() { /* 連線初始化 */ }
// 防止 clone、unserialize
public function __clone() { trigger_error('Clone not allowed', E_USER_ERROR); }
public function __wakeup() { trigger_error('Unserialize not allowed', E_USER_ERROR); }
public static function &getInstance() {
if (!isset(self::$instance)) {
self::$instance = new self();
}
return self::$instance;
}
}
// 使用:$db =& DbConn::getInstance(); // 必須用引用賦值
?>
<?php
final class Database
{
private static ?self $instance = null;
private 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]
);
}
public static function getInstance(): self
{
if (self::$instance === null) {
self::$instance = new self();
}
return self::$instance;
}
public function getPdo(): PDO { return $this->pdo; }
// 禁止複製與反序列化
private function __clone() {}
public function __wakeup() { throw new \Exception('Cannot unserialize singleton'); }
}
// 使用
$pdo = Database::getInstance()->getPdo();
$stmt = $pdo->query('SELECT 1');
?>
<?php
final readonly class Config
{
public function __construct(
public string $appEnv,
public string $dbDsn,
public string $redisHost,
) {}
private static ?self $instance = null;
public static function getInstance(): self
{
return self::$instance ??= new self(
$_ENV['APP_ENV'] ?? 'production',
$_ENV['DB_DSN'] ?? 'mysql:host=127.0.0.1;dbname=app',
$_ENV['REDIS_HOST'] ?? '127.0.0.1'
);
}
}
// 使用
$cfg = Config::getInstance();
echo $cfg->dbDsn;
現代框架(Laravel、Symfony)透過 **服務容器** 管理單例生命週期:
// Laravel 服務提供者
$this->app->singleton(Database::class, fn() => new Database(config('database')));
// 任何地方注入
class UserService {
public function __construct(protected Database $db) {}
}
**優點**:可測試(Mock 替換)、解耦、支援多實例(測試用不同資料庫)。
| 問題 | 後果 | 替代方案 |
|---|---|---|
| 隱性全域狀態 | 單元測試難隔離、平行測試互相干擾 | 依賴注入、工廠模式 |
| 緊耦合具體實作 | 難以替換為測試雙件 | 介面綁定、容器解析 |
| 生命週期失控 | 長連線洩漏、記憶體不釋放 | 容器管理作用域 |
final、private __construct、__clone/__wakeup 防禦、static ?self $instance 型別宣告debug_backtrace() 除錯濫用情況