萬盛學電腦網

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

PHP 設計模式:單例模式完整實戰指南(含資料庫連接、配置管理場景)

模式定義

單例模式 確保某個類在全局範圍內 僅有一個實例,並提供一個全局訪問點獲取該實例。它不創建副本,而是返回內部靜態實例的引用。

三大核心要素

  1. 私有靜態實例變量:private static $instance 保存唯一實例。
  2. 私有構造/克隆方法:private __construct()、private __clone() 禁止外部 new 和 clone。
  3. 公共靜態獲取方法:public static function getInstance() 延遲初始化並返回引用。

經典實現:資料庫連接單例

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

    // 1. 私有構造:建立真實連接
    private function __construct(string $dsn, string $user, string $pass, array $options = []) {
        $this->pdo = new PDO($dsn, $user, $pass, $options);
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        $this->pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
    }

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

    // 3. 禁止反序列化創建實例
    public function __wakeup() {
        throw new Exception("Cannot unserialize singleton");
    }

    // 4. 統一訪問入口
    public static function getInstance(string $dsn = '', string $user = '', string $pass = '', array $options = []): self {
        if (self::$instance === null) {
            if ($dsn === '') {
                throw new Exception("首次調用必須提供連接參數");
            }
            self::$instance = new self($dsn, $user, $pass, $options);
        }
        return self::$instance;
    }

    // 5. 代理 PDO 核心方法
    public function query(string $sql): PDOStatement|false {
        return $this->pdo->query($sql);
    }
    public function prepare(string $sql): PDOStatement|false {
        return $this->pdo->prepare($sql);
    }
    public function lastInsertId(string $name = null): string|false {
        return $this->pdo->lastInsertId($name);
    }
    // ... 其他需要代理的方法
}

// ===== 使用示例 =====
// 引導階段(如 bootstrap.php)初始化一次
Database::getInstance(
    'mysql:host=127.0.0.1;dbname=myapp;charset=utf8mb4',
    'app_user',
    'secret_pass',
    [PDO::ATTR_PERSISTENT => true]
);

// 業務代碼任意處獲取同一連接
$db = Database::getInstance();
$stmt = $db->prepare('SELECT * FROM users WHERE id = ?');
$stmt->execute([1]);
$user = $stmt->fetch();

應用場景二:全局配置管理器

class Config {
    private array $config = [];
    private static ?self $instance = null;

    private function __construct(array $configFiles = []) {
        foreach ($configFiles as $file) {
            if (is_file($file)) {
                $this->config = array_merge($this->config, require $file);
            }
        }
    }

    private function __clone() {}
    public function __wakeup() { throw new Exception("No unserialize"); }

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

    public function get(string $key, mixed $default = null): mixed {
        $keys = explode('.', $key);
        $val = $this->config;
        foreach ($keys as $k) {
            if (!is_array($val) || !array_key_exists($k, $val)) return $default;
            $val = $val[$k];
        }
        return $val;
    }

    public function set(string $key, mixed $value): void {
        $keys = explode('.', $key);
        $ref = &$this->config;
        foreach ($keys as $k) {
            if (!is_array($ref) || !array_key_exists($k, $ref)) {
                $ref[$k] = [];
            }
            $ref = &$ref[$k];
        }
        $ref = $value;
    }
}

// 使用
Config::getInstance([__DIR__.'/config/app.php', __DIR__.'/config/db.php']);
echo Config::getInstance()->get('db.host'); // 127.0.0.1

PHP 中的特殊考量:請求級單例

PHP 是「請求級」生命週期:每次 HTTP 請求都是全新進程,**單例實例不會跨請求共享**。這意味著:

  • ✅ 避免同一請求內重複 new PDO、重複解析配置文件。
  • ❌ 無法像 Java 一樣實現跨請求的真正全局單例(需借助 Redis、共享內存等外部存儲)。

進階:註冊表模式管理多個單例

當有多個「單例服務」(DB、Config、Logger、Cache)時,用註冊表統一管理:

class ServiceRegistry {
    private static array $services = [];

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

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

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

// 初始化
ServiceRegistry::set('db', Database::getInstance(...));
ServiceRegistry::set('config', Config::getInstance(...));

// 使用
$db = ServiceRegistry::get('db');

反模式與避坑

反模式危害修正
構造函數公開外部可 new 多個實例private __construct()
忘記禁用 __cloneclone $singleton 創建副本private __clone()
忘記禁用 __wakeupunserialize() 繞過構造創建實例public function __wakeup() { throw ... }
getInstance 內部邏輯複雜難以測試、隱藏依賴依賴注入容器管理生命週期
濫用單例存儲請求狀態導致狀態洩漏、難以測試請求數據用 Request 對象/上下文傳遞

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

在 Laravel/Symfony/ThinkPHP 等現代框架中,**容器自動管理服務單例**,無需手寫單例類:

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

// 控制器構造函數自動注入
class UserController {
    public function __construct(protected Database $db) {}
}

總結

單例模式在 PHP 中核心價值是 「請求內共享昂貴資源(DB連接、配置、日誌器)」。掌握標準實現、理解請求級生命週期、知曉現代框架如何用容器替代手寫單例,是 PHP 進階開發者的必修課。

copyright © 萬盛學電腦網 all rights reserved