萬盛學電腦網

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

PHP 設計模式實戰:單例模式與多例模式的深度解析與應用場景

Singleton 與 Multiton 模式:控制實例數量的藝術

創建型模式中,單例 確保類全局僅有一個實例,多例 則按鍵管理多個單例。本文深入剖析實現細節、線程安全、反序列化攻擊防護、依賴注入容器集成,並給出生產級代碼骨架。

單例模式:經典實現與現代寫法

1. 懶漢式(線程不安全,PHP 單請求單線程無影響)

<?php
class SingletonClassic
{
    private static ?self $instance = null;

    private function __construct() {}
    private function __clone() {}
    public function __wakeup() { throw new \Exception('不能反序列化單例'); }

    public static function getInstance(): self
    {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    public function doSomething(): void { echo "Singleton working\n"; }
}

// 使用
$obj1 = SingletonClassic::getInstance();
$obj2 = SingletonClassic::getInstance();
var_dump($obj1 === $obj2); // true
?>

2. 靜態局部變量(PHP 5.3+,更簡潔、延遲初始化)

<?php
class SingletonStaticLocal
{
    private function __construct() {}
    private function __clone() {}
    public function __wakeup() { throw new \Exception('不能反序列化單例'); }

    public static function getInstance(): self
    {
        static $instance = null; // 函數級靜態變量,首次調用初始化
        if ($instance === null) {
            $instance = new self();
        }
        return $instance;
    }
}
?>

3. 依賴注入容器友好型(可配置、可測試、可替換)

<?php
interface LoggerInterface { public function log(string $msg): void; }

class DatabaseLogger implements LoggerInterface
{
    // 單例特性由容器管理,類本身不強制單例
    public function __construct(private PDO $pdo) {}
    public function log(string $msg): void { /* ... */ }
}

// 容器配置(如 PHP-DI, Symfony DI, Laravel Container)
$container->set(LoggerInterface::class, \DI\object(DatabaseLogger::class)->scope(\DI\Scope::SINGLETON));

// 使用時由容器注入,業務代碼無感知單例
class OrderService
{
    public function __construct(private LoggerInterface $logger) {}
    public function placeOrder(): void { $this->logger->log('Order placed'); }
}
?>

現代最佳實踐:**類本身不實現單例**,而是由 **DI 容器管理生命週期**(Singleton Scope)。這樣:

  • 便於單元測試(可注入 Mock)
  • 避免全局狀態耦合
  • 支援多租戶/多配置場景(容器可按條件創建不同實例)

多例模式:按鍵管理實例

適用場景:數據庫連接池(不同配置)、多租戶配置、不同緩存節點客戶端、不同 API 客戶端實例。

標準實現

<?php
class Multiton
{
    /** @var array */
    private static array $instances = [];

    private function __construct(private string $key, private array $config) {}
    private function __clone() {}
    public function __wakeup() { throw new \Exception('不能反序列化多例'); }

    public static function getInstance(string $key, array $config = []): self
    {
        if (!isset(self::$instances[$key])) {
            if (empty($config)) throw new \Exception("首次獲取鍵 '$key' 必須提供配置");
            self::$instances[$key] = new self($key, $config);
        }
        return self::$instances[$key];
    }

    public static function hasInstance(string $key): bool
    {
        return isset(self::$instances[$key]);
    }

    public static function removeInstance(string $key): void
    {
        unset(self::$instances[$key]);
    }

    public static function clearInstances(): void
    {
        self::$instances = [];
    }

    public function getKey(): string { return $this->key; }
    public function getConfig(): array { return $this->config; }
    public function doSomething(): void { echo "Multiton[$this->key] working\n"; }
}

// 使用
$dbMaster = Multiton::getInstance('db_master', ['host'=>'10.0.0.1', 'db'=>'master']);
$dbSlave  = Multiton::getInstance('db_slave',  ['host'=>'10.0.0.2', 'db'=>'slave']);
$redisCache = Multiton::getInstance('redis_cache', ['host'=>'10.0.0.3', 'port'=>6379]);

var_dump($dbMaster === Multiton::getInstance('db_master')); // true
var_dump($dbMaster === $dbSlave); // false
?>

進階:泛型多例工廠(PHP 8.1+ readonly、泛型註釋)

<?php
/**
 * @template T of object
 */
class MultitonFactory
{
    /** @var array */
    private static array $instances = [];

    /**
     * @param class-string $class
     * @param array $config
     * @return T
     */
    public static function getInstance(string $key, string $class, array $config = []): object
    {
        if (!isset(self::$instances[$key])) {
            if (empty($config)) throw new \Exception("Config required for new instance '$key'");
            // 支援構造函數參數自動注入(簡化版)
            $ref = new ReflectionClass($class);
            self::$instances[$key] = $ref->newInstanceArgs($config);
        }
        return self::$instances[$key];
    }
}

// 使用
$logger = MultitonFactory::getInstance('file_logger', FileLogger::class, ['path'=>'/var/log/app.log']);
$logger2 = MultitonFactory::getInstance('file_logger', FileLogger::class); // 同一實例
?>

單例 vs 多例 vs 依賴注入容器:選型指南

場景推薦方案理由
全局配置管理DI 容器 Singleton Scope可測試、可替換、生命週期托管
數據庫連接(單主庫)DI 容器 Singleton / 連接池避免硬編碼單例,支援多環境
多數據庫/多 Redis 節點Multiton (按配置鍵)鍵隔離,運行時動態增減
多租戶隔離配置/服務Multiton (租戶 ID 為鍵)每租戶獨立實例,互不干擾
第三方 API 客戶端 (不同 AppID)Multiton按憑證隔離實例
舊代碼重構/全局工具類類靜態方法 / 靜態局部變量單例低成本改造,逐步遷移至 DI

常見陷阱與防護

  1. 反序列化破壞單例:必須實現 __wakeup() 拋出異常,或實現 Serializable 接口控制。
  2. 克隆破壞單例:聲明 private __clone()。
  3. 全局狀態污染測試:單例保留狀態導致測試相互干擾 → 用 DI 容器管理作用域,測試時創建新容器。
  4. 多例內存洩漏:長運行進程中鍵無限增長 → 提供 removeInstance()、clearInstances()、或弱引用 WeakMap (PHP 8.0+)。
  5. 併發環境(Swoole/Workerman):靜態變量進程隔離,每個 Worker 進程擁有獨立單例/多例,通常符合預期;跨進程共享需用 Redis/共享內存。

總結

  • 單例:全局唯一實例。現代首選 **DI 容器管理單例作用域**,類本身保持普通類。
  • 多例:鍵隔離的多個單例。適用於**多配置、多租戶、多資源連接**場景。
  • 核心原則:封裝構造器、禁止克隆/反序列化、提供靜態工廠方法、考慮生命週期管理與測試友好性。
copyright © 萬盛學電腦網 all rights reserved