單例模式確保一個類僅有一個實例,並提供全局訪問點。在 PHP 中,由於請求隔離特性,單例的生命周期僅限於單次請求,但對資源密集型對象(數據庫連接、配置管理、日志記錄器)仍有顯著價值。
<?php
declare(strict_types=1);
namespace App\Patterns;
final class DatabaseConnection {
// 1. 私有靜態實例屬性
private static ?self $instance = null;
// 2. 私有構造函數,防止外部 new
private function __construct(
private string $host,
private string $username,
private string $password,
private string $database,
private int $port = 3306
) {
// 實際連接邏輯
$this->connect();
}
// 3. 私有克隆方法,防止 clone
private function __clone(): void {
throw new \LogicException('單例模式禁止克隆');
}
// 4. 私有反序列化方法,防止 unserialize
public function __wakeup(): void {
throw new \LogicException('單例模式禁止反序列化');
}
// 5. 公共靜態獲取實例方法
public static function getInstance(string $host, string $username, string $password, string $database, int $port = 3306): self {
if (self::$instance === null) {
self::$instance = new self($host, $username, $password, $database, $port);
}
return self::$instance;
}
// 6. 實際業務方法
public function query(string $sql): array {
// 執行查詢...
return [];
}
private function connect(): void {
// PDO 連接邏輯
}
}
// 使用方式
$db = DatabaseConnection::getInstance('localhost', 'user', 'pass', 'dbname');
$results = $db->query('SELECT * FROM users');
?>
<?php
declare(strict_types=1);
final class ConfigManager {
/** @var array<string, self> */
private static array $instances = [];
private function __construct(
private readonly string $environment,
private readonly array $config
) {}
private function __clone(): void {}
public function __wakeup(): void {}
public static function getInstance(string $environment = 'default'): self {
if (!isset(self::$instances[$environment])) {
$configFile = __DIR__ . "/config/{$environment}.php";
$config = is_file($configFile) ? require $configFile : [];
self::$instances[$environment] = new self($environment, $config);
}
return self::$instances[$environment];
}
public function get(string $key, mixed $default = null): mixed {
return $this->config[$key] ?? $default;
}
public function set(string $key, mixed $value): void {
$this->config[$key] = $value;
}
}
// 使用
$prodConfig = ConfigManager::getInstance('production');
$devConfig = ConfigManager::getInstance('development');
?>
現代 PHP 框架(Laravel、Symfony)通過 DI 容器管理單例,而非手寫單例類:
<?php
// Laravel 服務提供者註冊
// App\Providers\AppServiceProvider.php
public function register(): void {
$this->app->singleton(DatabaseConnection::class, function ($app) {
return new DatabaseConnection(
config('database.connections.mysql.host'),
config('database.connections.mysql.username'),
config('database.connections.mysql.password'),
config('database.connections.mysql.database')
);
});
}
// 控制器中自動注入(非單例寫法,但容器保證單例)
class UserController {
public function __construct(
private DatabaseConnection $db // 容器自動解析單例
) {}
public function index() {
$users = $this->db->query('SELECT * FROM users');
return view('users.index', compact('users'));
}
}
?>
<?php
final class Logger {
private static ?self $instance = null;
private array $logs = [];
private function __construct() {}
private function __clone() {}
public function __wakeup() {}
// 測試專用:重置實例
public static function resetForTesting(): void {
self::$instance = null;
}
// 測試專用:注入模擬實例
public static function setInstance(self $instance): void {
self::$instance = $instance;
}
public static function getInstance(): self {
return self::$instance ??= new self();
}
public function log(string $level, string $message): void {
$this->logs[] = "[$level] $message";
}
public function getLogs(): array {
return $this->logs;
}
}
// 測試代碼
class LoggerTest extends \PHPUnit\Framework\TestCase {
protected function tearUp(): void {
Logger::resetForTesting();
}
public function testLog() {
$logger = Logger::getInstance();
$logger->log('info', 'test');
$this->assertCount(1, $logger->getLogs());
}
public function testWithMock() {
$mockLogger = $this->createMock(Logger::class);
Logger::setInstance($mockLogger);
$mockLogger->expects($this->once())
->method('log')
->with('error', 'test error');
Logger::getInstance()->log('error', 'test error');
}
}
?>
重要:PHP 的單例生命周期 = 單次 HTTP 請求。每次請求重新初始化,不像 Java/Spring 的應用級單例。因此:
final 防止繼承破壞單例privategetInstance() 靜態方法resetForTesting() 支持單元測試