如何实现PHP数据库Mock测试

在PHP项目开发过程中，涉及数据库操作的单元测试常常面临环境依赖、执行效率低等问题，数据库Mock测试通过模拟数据库交互行为，让测试脱离真实数据库环境，是提升测试质量的重要手段。

什么是数据库Mock测试

数据库Mock测试指的是在测试过程中，不连接真实的数据库，而是通过模拟数据库操作类的行为，返回预设的测试数据，验证业务逻辑是否正确的测试方法。这种方式可以避免测试过程中对真实数据库的读写操作，减少环境配置成本，同时让测试执行速度更快。

基于PHPUnit的Mock实现方式

PHPUnit是PHP生态中最常用的单元测试框架，自带Mock对象生成功能，可以直接用来模拟数据库操作类。假设我们有一个用户数据访问类UserDao，依赖PDO对象进行数据库查询，我们可以通过PHPUnit生成PDO的Mock对象来模拟查询行为。

示例代码

<?php
use PHPUnitFrameworkTestCase;

// 待测试的用户数据访问类
class UserDao {
    private $pdo;

    public function __construct(PDO $pdo) {
        $this->pdo = $pdo;
    }

    // 根据ID查询用户信息
    public function getUserById(int $id): array {
        $stmt = $this->pdo->prepare('SELECT * FROM users WHERE id = :id');
        $stmt->execute(['id' => $id]);
        return $stmt->fetch(PDO::FETCH_ASSOC);
    }
}

class UserDaoTest extends TestCase {
    public function testGetUserById() {
        // 创建PDO的Mock对象，禁用构造函数
        $pdoMock = $this->getMockBuilder(PDO::class)
            ->disableOriginalConstructor()
            ->getMock();

        // 创建PDOStatement的Mock对象
        $stmtMock = $this->getMockBuilder(PDOStatement::class)
            ->disableOriginalConstructor()
            ->getMock();

        // 预设PDO的prepare方法返回stmtMock
        $pdoMock->method('prepare')
            ->willReturn($stmtMock);

        // 预设stmtMock的execute方法返回true
        $stmtMock->method('execute')
            ->willReturn(true);

        // 预设fetch方法返回预设的用户数据
        $expectedUser = ['id' => 1, 'name' => '测试用户', 'email' => 'test@ipipp.com'];
        $stmtMock->method('fetch')
            ->willReturn($expectedUser);

        // 实例化UserDao并传入Mock的PDO对象
        $userDao = new UserDao($pdoMock);
        $result = $userDao->getUserById(1);

        // 验证返回结果是否符合预期
        $this->assertEquals($expectedUser, $result);
    }
}

自定义Mock类的实现方式

如果不想依赖PHPUnit的Mock功能，也可以自定义Mock类来模拟数据库操作。这种方式更灵活，适合需要定制复杂模拟逻辑的场景。我们可以创建一个MockPDO类，实现和PDO相同的接口，但是内部不连接真实数据库，而是返回预设数据。

示例代码

<?php
// 自定义MockPDO类，模拟PDO的基本行为
class MockPDO {
    private $mockData = [];

    // 设置模拟的查询结果，key为SQL语句，value为返回的数据
    public function setMockData(string $sql, array $data) {
        $this->mockData[$sql] = $data;
    }

    // 模拟prepare方法，返回MockPDOStatement对象
    public function prepare(string $sql) {
        return new MockPDOStatement($sql, $this->mockData);
    }
}

// 自定义MockPDOStatement类，模拟PDOStatement的行为
class MockPDOStatement {
    private $sql;
    private $mockData;
    private $executeParams = [];

    public function __construct(string $sql, array &$mockData) {
        $this->sql = $sql;
        $this->mockData = &$mockData;
    }

    // 模拟execute方法，保存参数
    public function execute(array $params = []) {
        $this->executeParams = $params;
        return true;
    }

    // 模拟fetch方法，返回预设的数据
    public function fetch(int $fetchStyle = PDO::FETCH_ASSOC) {
        if (isset($this->mockData[$this->sql])) {
            return $this->mockData[$this->sql];
        }
        return [];
    }
}

// 使用自定义Mock类的测试示例
class UserDaoCustomMockTest {
    public function testGetUserById() {
        $mockPdo = new MockPDO();
        // 设置对应SQL的返回数据
        $mockPdo->setMockData('SELECT * FROM users WHERE id = :id', ['id' => 1, 'name' => '自定义Mock用户']);

        $userDao = new UserDao($mockPdo);
        $result = $userDao->getUserById(1);

        assert($result['name'] === '自定义Mock用户');
    }
}

两种实现方式的对比

下面是两种实现方式的特点对比：

注意事项

• Mock测试仅用于单元测试，验证业务逻辑的正确性，不能替代集成测试验证真实数据库交互逻辑。
• 模拟的数据库操作行为需要和真实数据库的行为保持一致，比如返回的数据结构、异常抛出逻辑等，避免出现测试通过但真实环境报错的情况。
• 如果业务逻辑中直接使用了new PDO()这样的硬编码方式创建数据库连接，需要先重构代码，通过依赖注入的方式传入PDO对象，才能进行Mock测试。

PHPMock测试数据库测试PHPUnit修改时间：2026-06-30 11:30:35