PHP 是 請求級生命週期:每次 HTTP 請求啟動新進程,請求結束銷毀所有資源。**單例實例無法跨請求共享**(不同於 Java/Spring 的 JVM 級單例)。因此 PHP 單例的核心價值是:單次請求內避免重複創建昂貴資源(DB 連接、配置解析、日誌器初始化)。
<?php
final class Singleton {
private static ?self $instance = null;
private mixed $resource = null;
// 1. 私有構造:初始化昂貴資源
private function __construct() {
$this->resource = $this->initializeExpensiveResource();
}
// 2. 禁止克隆
private function __clone() {}
// 3. 禁止反序列化
public function __wakeup() {
throw new Exception("Cannot unserialize singleton");
}
// 4. 統一訪問入口(延遲初始化)
public static function getInstance(): self {
if (self::$instance === null) {
// 雙重檢查鎖模式在 PHP 單線程下無意義,但保留結構清晰
self::$instance = new self();
}
return self::$instance;
}
private function initializeExpensiveResource(): mixed {
// 如:new PDO(...), parse_ini_file(...), new Logger(...)
return "Resource Handle";
}
public function doSomething(): void {
echo "Using {$this->resource}
";
}
}
// 使用
$singleton = Singleton::getInstance();
$singleton->doSomething();
class Database {
private PDO $pdo;
private static ?self $instance = null;
private function __construct(array $config) {
$this->pdo = new PDO($config['dsn'], $config['user'], $config['pass'], [
PDO::ATTR_PERSISTENT => true, // 持久連接跨請求復用(慎用)
]);
}
public static function getInstance(array $config): self {
if (self::$instance === null) {
self::$instance = new self($config);
}
return self::$instance;
}
public function getPdo(): PDO { return $this->pdo; }
}
// bootstrap.php
Database::getInstance(['dsn'=>'mysql:host=127.0.0.1;dbname=app', 'user'=>'u', 'pass'=>'p']);
// 任意處
$db = Database::getInstance([])->getPdo();
class Config {
private array $data = [];
private static ?self $instance = null;
private function __construct(string $path) {
$this->data = require $path; // 解析配置文件
}
public static function getInstance(string $path = ''): self {
if (self::$instance === null) {
if (!$path) throw new Exception("Config path required");
self::$instance = new self($path);
}
return self::$instance;
}
public function get(string $key, mixed $default = null): mixed {
$keys = explode('.', $key);
$val = $this->data;
foreach ($keys as $k) {
if (!is_array($val) || !array_key_exists($k, $val)) return $default;
$val = $val[$k];
}
return $val;
}
}
| 誤區 | 真相 |
|---|---|
| 「單例能跨請求共享連接」 | ❌ 無法跨進程。需用 PDO::ATTR_PERSISTENT、連接池、Swoole 進程常駐 |
| 「單例就是全局變量」 | ✅ 本質是受控的全局訪問點,但封裝了創建邏輯 |
| 「所有服務都要做成單例」 | ❌ 只有「昂貴資源、無狀態、全局唯一」才適合 |
| 「單例好測試」 | ❌ 靜態調用難以 Mock,反而增加測試難度 |
問題:靜態 getInstance() 導致測試間狀態洩漏。
解決方案:
DatabaseInterface,測試時傳 Mock。class Database {
// ...
public static function resetForTesting(): void {
if (getenv('APP_ENV') === 'testing') {
self::$instance = null;
}
}
}
// PHPUnit tearDown
protected function tearDown(): void {
Database::resetForTesting();
parent::tearDown();
}
框架容器管理服務生命週期,默認即為單例**:
// Laravel 服務提供者
$this->app->singleton(Database::class, fn($app) => new Database($app['config']['database']));
// Symfony services.yaml
services:
App\Database:
class: App\Database
arguments: ['%database_config%']
# 默認 shared: true (單例)
// 使用:構造函數自動注入
class UserRepository {
public function __construct(private Database $db) {}
}
Str、Arr 助手類)PHP 單例模式的核心是 「請求內唯一實例 + 延遲初始化 + 禁止外部創建」。理解其 請求級生命週期限制,不濫用於有狀態對象,並在現代框架中優先選擇 依賴注入容器管理單例生命週期**,才是成熟的架構決策。