萬盛學電腦網

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

PHP 單例模式完整實作與深度解析

什麼是單例模式

單例模式確保某個類別在整個應用程式生命週期中只存在一個實例,並提供全域存取點。常用於資料庫連線、設定管理、日誌記錄等需要共享資源的場景。

標準實作程式碼

<?php
/**
 * 單例模式基礎實作
 */
class Single {
    private $name;
    private static $single = null;

    // 私有建構子,防止外部 new Single()
    private function __construct() {
    }

    // 防止複製
    private function __clone() {
    }

    // 防止反序列化建立新實例
    public function __wakeup() {
        throw new Exception("Cannot unserialize a singleton.");
    }

    // 靜態工廠方法,取得唯一實例
    public static function init() {
        if (self::$single === null) {
            self::$single = new Single();
        }
        return self::$single;
    }

    public function getName() {
        return $this->name;
    }

    public function setName($name) {
        $this->name = $name;
    }
}

// 使用示範
$s = Single::init();
$s->setName('hhhh');
echo '$s: ' . $s->getName() . "\n";

unset($s); // 釋放變數,但實例仍存在於 static 變數中

$m = Single::init();
echo '$m: ' . $m->getName() . "\n"; // 輸出 'hhhh',證明是同一實例
?>

核心機制深度解析

1. 三大私有化防護

  • private __construct():阻止 new Single()
  • private __clone():阻止 clone $single
  • __wakeup() 拋出例外:阻止 unserialize() 重建實例

2. 靜態變數儲存實例

private static $single 儲存於類別層級,不屬於任何物件實例,生命週期贯穿整個請求。

3. 延遲初始化

只有首次呼叫 init() 時才建立實例,節省資源。

進階變體:執行緒安全(PHP 非必要)

PHP 是單執行緒模型(除非使用 pthreads 擴展),一般 Web 應用不需雙重檢查鎖定。但若在支援多執行緒的環境下:

public static function init() {
    if (self::$single === null) {
        // PHP 一般環境不需此鎖,僅作示範
        $lock = fopen(__FILE__, 'r');
        flock($lock, LOCK_EX);
        if (self::$single === null) {
            self::$single = new Single();
        }
        flock($lock, LOCK_UN);
        fclose($lock);
    }
    return self::$single;
}

常見應用場景

1. 資料庫連線管理

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;
    }
}

// 使用
$db = Database::getInstance()->getConnection();
$stmt = $db->query('SELECT * FROM users');

2. 設定管理器

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

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

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

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

// 使用
$appEnv = Config::getInstance()->get('app.env', 'production');

單例模式的爭議與替代方案

缺點

  • 全域狀態:難以追蹤依賴關係,單元測試困難
  • 違反單一職責:類別同時負責業務邏輯與實例控制
  • 隱性依賴:類別間耦合不明顯
  • 擴充性差:難以繼承或替換實作

現代替代:依賴注入

// 使用容器管理單例生命週期
$container = new Container();
$container->singleton(Database::class, function () {
    return new Database('mysql:host=localhost;dbname=test', 'user', 'pass');
});

// 需要時由容器注入
class UserService {
    public function __construct(private Database $db) {}
}

$userService = $container->get(UserService::class);

總結

單例模式在 PHP 中實作簡單,透過私有建構子、靜態實例變數與工廠方法即可達成。雖然在資料庫連線、設定管理等場景實用,但現代開發推薦使用依賴注入容器管理共享實例,提升可測試性與維護性。理解單例模式原理有助於識別既有程式碼架構,並在適當場合權衡利弊。

copyright © 萬盛學電腦網 all rights reserved