萬盛學電腦網

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

PHP 單例模式完整指南:實作細節、頁面級生命週期限制與資料庫連線應用

前言

單例模式確保類別在全域只有唯一實例,並提供全域存取點。但在 PHP 「分享無物件」的請求生命週期模型下,單例模式的意義與 Java/C# 截然不同。本文深入解析 PHP 單例實作細節、頁面級限制、資料庫連線應用場景與現代替代方案。

單例模式三要素標準實作

<?php
class Singleton {
    // 1. 私有靜態屬性保存唯一實例
    private static ?self $instance = null;

    // 2. 私有建構子,防止外部 new
    private function __construct() {
        // 初始化邏輯(如資料庫連線)
    }

    // 3. 私有克隆方法,防止 clone
    private function __clone() {}

    // 4. 私有反序列化,防止 unserialize 繞過
    public function __wakeup() {
        throw new Exception("不能反序列化單例");
    }

    // 5. 公共靜態方法取得實例
    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    // 業務方法
    public function doSomething(): void {
        echo "單例實例操作\n";
    }
}

// 使用
$instance = Singleton::getInstance();
$instance->doSomething();

// 以下會報錯
// $obj = new Singleton(); // Error: private constructor
// $obj2 = clone $instance; // Error: private clone
// $obj3 = unserialize(serialize($instance)); // Error: __wakeup
?>

PHP 頁面級生命週期的關鍵限制

PHP 是「請求級」執行模型:每個 HTTP 請求獨立啟動 PHP 進程/執行緒,載入腳本、執行、銷毀所有記憶體變數(含靜態屬性)。

  • 單例實例無法跨請求保持:請求 A 建立的單例,請求 B 完全看不到,會重新建立。
  • 適用場景:單一請求內 多處需共享同一資源(如資料庫連線、設定物件、日誌器)。
  • 不適用場景:跨請求快取、長連線狀態保持(需用 Redis、資料庫、Session)。

經典應用:資料庫連線單例

PDO 單例封裝

<?php
class Database {
    private static ?self $instance = null;
    private PDO $pdo;

    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,
            PDO::ATTR_PERSISTENT         => true, // 持久連線(跨請求複用 TCP 連線)
        ]);
    }

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

    private function __clone() {}
    public function __wakeup() { throw new Exception("不可反序列化"); }

    public function getPdo(): PDO {
        return $this->pdo;
    }

    // 便利查詢方法
    public function fetchOne(string $sql, array $params = []): ?array {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetch() ?: null;
    }

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

    public function execute(string $sql, array $params = []): bool {
        $stmt = $this->pdo->prepare($sql);
        return $stmt->execute($params);
    }

    public function lastInsertId(): string {
        return $this->pdo->lastInsertId();
    }
}

// 控制器/服務中使用
$db = Database::getInstance();
$user = $db->fetchOne('SELECT * FROM users WHERE email = ?', [$email]);
$db->execute('INSERT INTO logs (message) VALUES (?)', ['User logged in']);
?>

關鍵點:PDO::ATTR_PERSISTENT = true

這才是真正跨請求複用資料庫連線的關鍵(由 PHP 進程池管理),而非單例模式本身。單例只是確保同一請求內不重複建立 PDO 物件。

進階:註冊表模式(Registry Pattern)管理多單例

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

    public static function set(string $key, object $instance): void {
        self::$instances[$key] = $instance;
    }

    public static function get(string $key): ?object {
        return self::$instances[$key] ?? null;
    }

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

// 註冊各種單例服務
Registry::set('db', Database::getInstance());
Registry::set('config', Config::getInstance());
Registry::set('logger', Logger::getInstance());

// 任何地方取用
$db = Registry::get('db');
$logger = Registry::get('logger');
?>

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

單例模式屬於「服務定位器」反模式,隱藏相依性、難以測試、耦合全域狀態。現代框架(Laravel、Symfony、Hyperf)採用 依賴注入容器:

<?php
// 概念示意(非完整容器實作)
class Container {
    private array $bindings = [];
    private array $instances = [];

    public function bind(string $abstract, callable $concrete, bool $singleton = false): void {
        $this->bindings[$abstract] = ['concrete' => $concrete, 'singleton' => $singleton];
    }

    public function make(string $abstract): mixed {
        if (isset($this->instances[$abstract])) {
            return $this->instances[$abstract];
        }
        if (!isset($this->bindings[$abstract])) {
            throw new Exception("未綁定: $abstract");
        }
        $binding = $this->bindings[$abstract];
        $instance = $binding['concrete']($this);
        if ($binding['singleton']) {
            $this->instances[$abstract] = $instance;
        }
        return $instance;
    }
}

// 綁定
$container = new Container();
$container->bind(PDO::class, fn() => new PDO($dsn, $user, $pass, $options), true); // 單例
$container->bind(UserService::class, fn($c) => new UserService($c->make(PDO::class)));

// 使用(自動遞迴解析相依)
$userService = $container->make(UserService::class);
?>

單例模式適用性檢核表

條件是否適合單例
需跨請求保持狀態❌ 不適合(用 Redis/DB/Session)
單一請求內多處共享昂貴資源(DB連線、設定、Logger)✅ 適合
無狀態工具類(如 Utils、Helpers)❌ 不需實例,用 static 方法或函數
需支援多實例配置(如多資料庫連線)❌ 不適合(用工廠模式)
單元測試需隔離、Mock❌ 單例難測試(用 DI 容器)

結語

PHP 單例模式的核心價值在於單一請求內避免重複建立昂貴資源,而非跨請求全域唯一。理解「請求級生命週期」是正確應用的前提。現代專案建議採用依賴注入容器管理服務生命週期,獲得更好的可測試性、解耦合與擴展性。單例模式可作為容器內部的單例綁定實現細節存在,而非直接暴露於業務代碼中。

copyright © 萬盛學電腦網 all rights reserved