萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 設計模式深度解析:單例模式 從 PHP 4 到 PHP 8 的演進實作

模式意圖

確保某類別**全域僅有一個實例**,並提供全域存取點。典型用途:資料庫連線、設定管理、日誌記錄器、快取客戶端。

PHP 4 時代寫法(歷史參考)

<?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 5.3+ 現代標準寫法

<?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 8.1+ readonly class + static factory(更簡潔)

<?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 替換)、解耦、支援多實例(測試用不同資料庫)。

單例反模式與替代

問題後果替代方案
隱性全域狀態單元測試難隔離、平行測試互相干擾依賴注入、工廠模式
緊耦合具體實作難以替換為測試雙件介面綁定、容器解析
生命週期失控長連線洩漏、記憶體不釋放容器管理作用域

最佳實務建議

  1. **能用 DI 容器管理單例,就別手寫單例類別**
  2. 若必須手寫:final、private __construct、__clone/__wakeup 防禦、static ?self $instance 型別宣告
  3. 考慮 **多例模式** (Multiton):依參數區分實例(如多資料庫連線)
  4. 記錄建立堆疊:debug_backtrace() 除錯濫用情況
copyright © 萬盛學電腦網 all rights reserved