萬盛學電腦網

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

PHP 單例模式深度解析:請求級生命週期、資源共享與現代替代方案

單例模式在 PHP 的特殊意義

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();

經典應用場景

1. 數據庫連接共享(最典型)

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();

2. 全局配置管理

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;
    }
}

為什麼 PHP 單例常被誤解?

誤區真相
「單例能跨請求共享連接」❌ 無法跨進程。需用 PDO::ATTR_PERSISTENT、連接池、Swoole 進程常駐
「單例就是全局變量」✅ 本質是受控的全局訪問點,但封裝了創建邏輯
「所有服務都要做成單例」❌ 只有「昂貴資源、無狀態、全局唯一」才適合
「單例好測試」❌ 靜態調用難以 Mock,反而增加測試難度

單例的測試難題與解決

問題:靜態 getInstance() 導致測試間狀態洩漏。

解決方案:

  1. 注入介面而非調用單例:構造函數傳入 DatabaseInterface,測試時傳 Mock。
  2. 提供重置方法(僅測試環境):
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();
}

現代替代方案:依賴注入容器 (DIC)

框架容器管理服務生命週期,默認即為單例**:

// 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 單例模式的核心是 「請求內唯一實例 + 延遲初始化 + 禁止外部創建」。理解其 請求級生命週期限制,不濫用於有狀態對象,並在現代框架中優先選擇 依賴注入容器管理單例生命週期**,才是成熟的架構決策。

copyright © 萬盛學電腦網 all rights reserved