萬盛學電腦網

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

PHP 設計模式實戰:單例模式完整實作與核心原理解析

單例模式確保某個類別在全域僅有一個實例,並提供全域存取點。常用於資料庫連線、配置管理、日誌記錄等「全域唯一」場景。本文從核心原理到完整程式碼逐層剖析。

核心三要素

  1. 私有建構子:防止外部 new 實例化
  2. 靜態私有實例變數:儲存唯一實例
  3. 公靜態取得方法:延遲初始化並回傳實例

標準實作程式碼

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

    // 2. 私有建構子:禁止外部 new
    private function __construct() {
        // 初始化資料庫連線等昂貴操作
        $this->pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }

    // 3. 禁止克隆
    private function __clone() {}

    // 4. 禁止反序列化
    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 query(string $sql, array $params = []): array {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetchAll(PDO::FETCH_ASSOC);
    }
}

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

執行流程圖解

首次呼叫 Database::getInstance()
        │
        ▼
self::$instance === null ? ──Yes──► new self() ──► 存入 self::$instance ──► 回傳
        │
       No
        │
        ▼
直接回傳 self::$instance

進階話題

執行緒安全(PHP-FPM 多進程)

PHP 以多進程模式運行,每個 Worker 進程有獨立記憶體空間,單例僅在單一進程內唯一。跨進程共享需借助 Redis、共享記憶體或資料庫鎖。

依賴注入容器整合

現代框架(Laravel、Symfony)透過服務容器管理單例生命週期,建議改用容器綁定:

// Laravel 服務提供者中
$this->app->singleton(Database::class, fn() => new Database());

// 控制器中自動注入
public function index(Database $db) { ... }

測試友善性

單例難以 Mock,單元測試時可:

  • 提供 setInstance(null) 重置方法(僅測試環境開放)
  • 改用介面 + 容器,測試時綁定 Mock 實作

PHP 8.1+ readonly 與 enum 單例

<?php
// 單例枚舉(PHP 8.1+)
enum Database: string {
    case Instance = 'default';

    private PDO $pdo;

    public function getPDO(): PDO {
        if (!isset($this->pdo)) {
            $this->pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        }
        return $this->pdo;
    }
}

// 使用
$pdo = Database::Instance->getPDO();

枚舉單例天然防禦反序列化、克隆、多執行緒競態,是現代 PHP 的最佳選擇。

copyright © 萬盛學電腦網 all rights reserved