萬盛學電腦網

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

PHP 設計模式實戰:單例模式完整實作、變體與現代替代方案

前言

單例模式確保類別全域唯一實例,並提供全域存取點。雖然因「全域狀態、難測試、違反單一職責」備受爭議,但在資料庫連線、配置管理、日誌記錄、快取驅動等場景仍是實務常見選擇。本文提供標準實作、執行緒安全考量、PHP 特有變體、現代依賴注入替代方案與反模式警示。

一、經典單例模式實作(PHP 7.4+)

<?php
declare(strict_types=1);

namespace App\Patterns;

final class DatabaseConnection {
    /** @var self|null 唯一實例 */
    private static ?self $instance = null;

    /** @var PDO 實際連線物件 */
    private PDO $pdo;

    /** 私有建構子:防止外部 new */
    private function __construct() {
        $dsn = 'mysql:host=localhost;dbname=app;charset=utf8mb4';
        $this->pdo = new PDO($dsn, 'user', 'pass', [
            PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES   => false,
        ]);
    }

    /** 防止 clone */
    private function __clone(): void {}

    /** 防止反序列化建立新實例 */
    public function __wakeup(): void {
        throw new \Exception("不能反序列化單例");
    }

    /** 取得唯一實例(執行緒不安全,PHP 通常單執行緒) */
    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    /** 對外暴露 PDO 實例 */
    public function getPdo(): PDO {
        return $this->pdo;
    }

    /** 方便直接呼叫 PDO 方法 */
    public function __call(string $name, array $arguments) {
        return $this->pdo->$name(...$arguments);
    }
}

// 使用
$pdo = DatabaseConnection::getInstance()->getPdo();
$stmt = $pdo->query('SELECT VERSION()');
echo $stmt->fetchColumn();
?>

二、關鍵實作細節解析

1. final 類別

防止繼承破壞單例(子類別會有各自的 static $instance)。

2. private __construct() + private __clone() + __wakeup()

三重保障:禁止 new、clone、unserialize() 建立新實例。

3. 靜態屬性 self::$instance

儲存於類別層級,請求生命週期內唯一。PHP 為單執行緒(PHP-FPM/CLI),無競態條件問題;Swoole/RoadRunner 等長駐環境需額外加鎖。

4. 晚期靜態綁定 (LSB) 支援繼承

<?php
abstract class Singleton {
    private static array $instances = [];

    final public static function getInstance(): static {
        $class = static::class; // LSB:取得實際呼叫的子類別
        if (!isset(self::$instances[$class])) {
            self::$instances[$class] = new static();
        }
        return self::$instances[$class];
    }

    protected function __construct() {}
    private function __clone() {}
    public function __wakeup() { throw new \Exception('No unserialize'); }
}

class Config extends Singleton {
    public array $settings = [];
}

class Logger extends Singleton {
    public function log(string $msg) { echo "[LOG] $msg\n"; }
}

Config::getInstance()->settings['debug'] = true;
Logger::getInstance()->log('App started');
// Config 與 Logger 各自擁有獨立單例
?>

三、單例模式優缺點權衡

優點缺點
全域唯一存取點,避免重複建立昂貴資源(DB 連線、Redis 連線)隱性依賴:類別間耦合隱藏在 ::getInstance() 呼叫中
延遲初始化:首次使用才建立難以單元測試:無法輕易 Mock、狀態殘留汙染測試
比全域變數更受控(封裝在類別內)違反單一職責:類別同時負責業務邏輯與生命週期管理
可透過 LSB 支援多單例(每個子類一個實例)擴充性差:新增參數需修改 getInstance() 簽名

四、現代替代方案:依賴注入 (DI) 容器

現代框架均採用 DI 容器管理共享服務,單例成為服務定義範疇而非類別職責。

PSR-11 容器介面示範

<?php
// 介面定義
interface ContainerInterface {
    public function get(string $id): mixed;
    public function has(string $id): bool;
}

// 簡易實作
class Container implements ContainerInterface {
    private array $services = [];
    private array $instances = [];

    public function register(string $id, callable $factory, bool $singleton = true): void {
        $this->services[$id] = [$factory, $singleton];
    }

    public function get(string $id): mixed {
        if (!isset($this->services[$id])) {
            throw new \InvalidArgumentException("Service $id not found");
        }
        [$factory, $singleton] = $this->services[$id];
        if ($singleton) {
            return $this->instances[$id] ??= $factory($this);
        }
        return $factory($this);
    }

    public function has(string $id): bool {
        return isset($this->services[$id]);
    }
}

// 註冊服務
$container = new Container();
$container->register('db', fn($c) => new PDO('mysql:host=localhost;dbname=app', 'u', 'p'));
$container->register('logger', fn($c) => new Logger($c->get('db')), singleton: true);

// 使用(建構子注入)
class UserService {
    public function __construct(
        private PDO $db,
        private Logger $logger
    ) {}
}

$userService = new UserService($container->get('db'), $container->get('logger'));
?>

優勢

  • 明確依賴:建構子宣告需求,IDE 可分析、測試可 Mock。
  • 生命週期外部化:單例/原型/請求範圍由容器配置決定。
  • 解耦:業務類別零依賴容器,符合 DIP。

五、單例模式適用場景判斷清單

✅ 適合使用單例:

  • 真正昂貴且全域共享的資源:DB 連線池、Redis 連線、檔案鎖管理器。
  • 無狀態工具類:Str::uuid()、DateTimeHelper(靜態方法即可,無需單例)。
  • 框架核心元件:Router、EventDispatcher、Container 本身。

❌ 避免使用單例:

  • 業務邏輯類別:OrderService、UserRepository。
  • 需依賴請求上下文的服務:Session、Auth、CurrentUser。
  • 任何需在測試中替換實作的介面。

六、反模式:偽單例與全域狀態濫用

<?php
// ❌ 反模式:全域陣列當單例儲存
$GLOBALS['db'] = new PDO(...);
function getUser($id) {
    return $GLOBALS['db']->query(...); // 隱性依賴、難測試
}

// ❌ 反模式:靜態屬性儲存請求狀態
class Request {
    public static $input = []; // 併發災難!
}

// ✅ 正確:請求資料注入或從容器取得
class Request {
    public function __construct(
        private array $query,
        private array $body
    ) {}
}
?>

結語

單例模式在 PHP 中實作簡單(得益於單執行緒),但濫用即技術債。現代最佳實踐:資源型服務交給 DI 容器管理單例範疇,業務類別走建構子注入,靜態工具類直接用靜態方法。若確需在舊專案引入單例,請嚴守「final、私有建構子、防 clone/wakeup、LSB 支援」四大鐵律,並寫入架構決策記錄 (ADR) 供未來重構參考。

copyright © 萬盛學電腦網 all rights reserved