如何测试PHP PDO数据库单例连接类？兼询单例弊端与替代方案

一、优化PDOSingleConnection以支持单元测试 #

原代码的核心问题是静态属性的全局耦合和直接实例化PDO的硬编码，导致无法Mock依赖。可以通过以下方式重构：

1. 重构后的代码 #

class PDOSingleConnection
{
    protected static ?PDO $pdo = null;

    // 私有构造函数，禁止外部随意实例化
    private function __construct() {}

    // 允许外部注入PDO实例，用于测试或自定义连接
    public static function setPDO(PDO $pdo): void
    {
        self::$pdo = $pdo;
    }

    // 重置静态实例，确保测试用例之间的状态隔离
    public static function reset(): void
    {
        self::$pdo = null;
    }

    public static function getPDO(
        string $hostName = 'localhost',
        string $username = 'root',
        string $password = '12345'
    ): PDO
    {
        if (is_null(self::$pdo)) {
            self::$pdo = self::createPDO($hostName, $username, $password);
        }

        return self::$pdo;
    }

    // 抽离PDO创建逻辑，方便测试时Mock
    protected static function createPDO(string $hostName, string $username, string $password): PDO
    {
        try {
            $pdo = new PDO("mysql:host=$hostName;", $username, $password);
            $pdo->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION);
            return $pdo;
        } catch (\PDOException $e) {
            // 保留原始异常的栈信息，便于调试
            throw new \PDOException($e->getMessage(), (int)$e->getCode(), $e);
        }
    }
}

2. 单元测试示例（PHPUnit） #

use PHPUnit\Framework\TestCase;

class PDOSingleConnectionTest extends TestCase
{
    protected function setUp(): void
    {
        // 每次测试前重置单例状态
        PDOSingleConnection::reset();
    }

    public function testGetPDOReturnsMockInstance(): void
    {
        // 创建Mock的PDO实例
        $mockPdo = $this->createMock(PDO::class);
        
        // 注入Mock实例
        PDOSingleConnection::setPDO($mockPdo);
        
        // 验证获取的是Mock实例
        $this->assertSame($mockPdo, PDOSingleConnection::getPDO());
    }

    public function testCreatePDOCreatesValidConnection(): void
    {
        $connection = PDOSingleConnection::getPDO('test-host', 'test-user', 'test-pass');
        $this->assertInstanceOf(PDO::class, $connection);
    }
}

二、关于单例模式的争议与替代方案 #

1. 为什么说单例模式是不良实践？ #

• 全局状态污染：单例的静态属性是全局共享的，不同测试用例、模块之间会互相影响，调试时很难追踪状态变化。
• 紧耦合：依赖单例的代码直接绑定到具体类，而非抽象接口，无法灵活替换实现（比如切换到PostgreSQL连接）。
• 测试难度高：静态依赖无法通过常规依赖注入Mock，导致单元测试难以隔离依赖，容易变成集成测试。
• 扩展性差：单例通常会把构造函数设为私有，无法继承扩展，限制了代码的复用和定制。
• 资源管理僵化：单例持有资源（如数据库连接）时，无法手动释放，可能导致资源泄漏或无法按需重建连接。

2. 不使用单例，如何实现数据库连接单实例？ #

最常用的方案是依赖注入容器（DI Container），由容器统一管理对象的生命周期，确保连接实例唯一：

示例：简单DI容器实现单例连接

class SimpleContainer
{
    private array $singletons = [];

    public function getPDO(): PDO
    {
        if (!isset($this->singletons['pdo'])) {
            $this->singletons['pdo'] = $this->createPDOConnection();
        }
        return $this->singletons['pdo'];
    }

    private function createPDOConnection(): PDO
    {
        $pdo = new PDO("mysql:host=localhost;", 'root', '12345');
        $pdo->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION);
        return $pdo;
    }
}

// 使用方式
$container = new SimpleContainer();
// 多次获取都是同一个实例
$conn1 = $container->getPDO();
$conn2 = $container->getPDO();
var_dump($conn1 === $conn2); // 输出 bool(true)

其他方案：

• 工厂模式+上层控制：创建一个连接工厂类，由应用的入口或配置层控制只调用一次工厂方法，将实例注入到所有需要的类中。
• 依赖注入框架：使用成熟的DI框架（如Symfony DI、Laravel容器），将数据库连接注册为单例服务，通过注解或配置自动注入。

内容的提问来源于stack exchange，提问作者izmatlDev