您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 綜合知識

PHP 單例模式深度解析：實現原理、核心要點與實戰應用場景

編輯：PHP 綜合知識

單例模式是創建型設計模式中最簡單、應用最廣泛的一種。它確保某個類在整個應用生命周期中只有一個實例，並提供一個全局訪問點獲取該實例。本文將從核心代碼實現、三大要素、PHP 中的特殊性、典型應用場景四個維度深度解析。

核心代碼實現

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

    // 2. 私有構造函數，防止外部 new 實例化
    private function __construct() {
        // 初始化邏輯（如資料庫連接、配置加載等）
    }

    // 3. 私有克隆方法，防止 clone 複製對象
    private function __clone() {
        trigger_error('克隆單例對象是被禁止的', E_USER_ERROR);
    }

    // 4. 私有反序列化方法，防止 unserialize 重建對象
    private function __wakeup() {
        trigger_error('反序列化單例對象是被禁止的', E_USER_ERROR);
    }

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

    // 業務方法示例
    public function doSomething() {
        echo "單例模式業務邏輯執行中...";
    }
}

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

// 嘗試 new / clone / unserialize 都會報錯
// $obj = new Singleton();        // Fatal error
// $obj2 = clone $instance;       // Fatal error
// $obj3 = unserialize(serialize($instance)); // Fatal error
?>

單例模式三大核心要素

唯一實例：類只能有一個實例對象。
自行創建：類必須自行實例化自己（通過私有構造函數 + 靜態工廠方法）。
全局訪問：類必須向整個系統提供這個實例的訪問入口（靜態方法）。

PHP 中單例模式的特殊性 ⚠️

與 Java、C# 等長運行進程語言不同，PHP 是請求級別的生命周期：每次 HTTP 請求都會重新啟動腳本，請求結束時所有內存資源（包括單例對象）都會被銷毀。因此：

PHP 單例無法跨請求共享實例，每個請求都會重新創建。
它的價值不在於「節省跨請求的實例化開銷」，而在於單次請求內避免重複創建、統一資源管理、提供全局訪問點。

典型應用場景

1. 數據庫連接管理（最經典）

避免同一請求中多次 new PDO() 或 mysqli_connect() 導致連接數耗盡。

class Database {
    private static $instance = null;
    private $pdo;

    private function __construct() {
        $this->pdo = new PDO("mysql:host=localhost;dbname=test", 'user', 'pass');
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }

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

    public function getConnection() {
        return $this->pdo;
    }
}

// 任何地方獲取同一連接
$pdo = Database::getInstance()->getConnection();
$stmt = $pdo->query("SELECT * FROM users");
?>

2. 配置管理器

全局配置只需加載一次，之後隨處可用：

class Config {
    private static $instance = null;
    private $settings = [];

    private function __construct() {
        $this->settings = require __DIR__ . '/config/app.php';
    }

    public static function getInstance() { /* ... */ }

    public function get($key, $default = null) {
        return $this->settings[$key] ?? $default;
    }
}

// 使用
$dbHost = Config::getInstance()->get('database.host');
?>

3. 日誌記錄器

統一日誌寫入入口，避免多處打開文件句柄：

class Logger {
    private static $instance = null;
    private $logFile;

    private function __construct() {
        $this->logFile = fopen(__DIR__ . '/storage/logs/app.log', 'a');
    }

    public static function getInstance() { /* ... */ }

    public function log($level, $message) {
        fwrite($this->logFile, "[" . date('Y-m-d H:i:s') . "] {$level}: {$message}\n");
    }
}

Logger::getInstance()->log('INFO', '用戶登錄成功');
?>

4. 緩存客戶端

Redis、Memcached 連接復用：

class Cache {
    private static $instance = null;
    private $redis;

    private function __construct() {
        $this->redis = new Redis();
        $this->redis->connect('127.0.0.1', 6379);
    }
    // ...
}
?>

進階：依賴注入容器中的單例綁定

現代框架（Laravel、Symfony）通常不直接使用靜態 getInstance()，而是通過服務容器綁定單例：

// Laravel 風格
$app->singleton('database', function () {
    return new DatabaseConnection(config('database'));
});

// 之後在控制器/服務中通過構造函數注入
class UserService {
    public function __construct(DatabaseConnection $db) { /* ... */ }
}
?>

這樣做的優點：可測試性更強（可輕鬆 Mock）、解耦（不依賴具體類）、生命周期由容器統一管理。