萬盛學電腦網

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

PHP 設計模式:單例模式完整實現、核心要素、應用場景與現代替代方案

單例模式確保類**全局僅有一個實例**,並提供**全局訪問點**。在 PHP 中主要用於資料庫連接、配置管理、日誌記錄器等「重資源、全局共享」場景。本文給出標準實現、三要素解析、PHP 特有陷阱與現代依賴注入替代方案。

單例三要素(鐵律)

  1. 私有構造函數:private __construct() 防止 new Class()。
  2. 靜態實例屬性:private static $instance = null; 持有唯一實例。
  3. 公共靜態獲取方法:public static function getInstance() 延遲創建並返回實例。

**補充**:private __clone() 防止克隆、private __wakeup() 防止反序列化繞過。

標準實現代碼

pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }

    // 2. 防止克隆
    private function __clone() {
        trigger_error('Clone not allowed.', E_USER_ERROR);
    }

    // 3. 防止反序列化
    public function __wakeup() {
        throw new \Exception('Unserialize not allowed.');
    }

    // 4. 靜態工廠方法
    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    // 業務方法
    public function query(string $sql, array $params = []): array {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetchAll();
    }
}

// 使用
$db = Database::getInstance();
$users = $db->query('SELECT * FROM users WHERE status = ?', [1]);

PHP 特有陷阱與應對

陷阱後果應對
請求級單例 vs 進程級單例PHP-FPM 每請求重置,$instance 不跨請求共享理解 PHP 生命週期,單例僅在**單次請求**內唯一
Swoole/RoadRunner 長駐進程跨請求真正共享,可能導致連接池洩漏、狀態汙染實現 resetInstance() 或使用連接池組件
繼承破壞單例子類可 new Child() 繞過final class 或構造函數 final private
序列化繞過unserialize(serialize($obj)) 創建新實例實現 __wakeup 拋異常
反射實例化(new ReflectionClass())->newInstanceWithoutConstructor()極少見,框架級防護可用 ReflectionProperty::setAccessible 檢測

應用場景對比

場景適合單例?更好替代
PDO 數據庫連接⚠️ 僅單請求依賴注入容器管理連接池
配置對象✅ 只讀、全局訪問容器綁定單例 $app->singleton()
日誌記錄器✅ 無狀態、高頻調用PSR-3 LoggerInterface + 容器綁定
緩存客戶端⚠️ 有狀態連接容器管理生命週期
業務服務類❌ 有狀態、需測試替換依賴注入 + 接口綁定

現代替代:Laravel 服務容器單例綁定

// AppServiceProvider::register()
$this->app->singleton(Database::class, function () {
    return new Database(config('database'));
});

// 控制器構造子注入(自動解析單例)
public function __construct(Database $db) {
    $this->db = $db;
}

優勢:可測試(測試時綁定 Mock)、可替換(換實現只改綁定)、生命週期可控(請求級/單例/瞬態隨意切換)。

總結

單例模式在 PHP 傳統請求響應模型中作用有限(天然請求隔離),但在長駐進程、CLI 腳本、框架核心組件中仍有價值。**現代 PHP 開發首選依賴注入容器管理共享實例**,單例模式作為容器的「單例綁定」實現細節存在,而非業務代碼直接調用的靜態方法。

copyright © 萬盛學電腦網 all rights reserved