如何在 PHPUnit 中跨测试类共享数据：构建可复用的测试固件-php教程-PHP中文网

如何在 PHPUnit 中跨测试类共享数据：构建可复用的测试固件

本文介绍如何通过测试固件（Fixture）机制，在不同 PHPUnit 测试类间安全、高效地共享如自增 ID 等关键测试数据，避免滥用 @depends 导致的耦合与执行顺序问题。

本文介绍如何通过测试固件（fixture）机制，在不同 phpunit 测试类间安全、高效地共享如自增 id 等关键测试数据，避免滥用 `@depends` 导致的耦合与执行顺序问题。

在集成测试中（尤其是涉及数据库操作时），常需将前一个测试生成的关键数据（如新插入用户的 customer_id）传递给后续其他测试类使用——例如先创建客户，再为该客户创建地址。但直接依赖 @depends 跨类引用（如 @depends CustomerRepositoryTest::testInsertNewCustomer）会引发严重问题：它强制测试执行顺序、破坏测试隔离性、导致单个测试无法独立运行，且一旦前置测试失败，所有依赖测试均被跳过，极大削弱可维护性与调试效率。

✅ 正确方案是采用 集中式测试固件（Test Fixture） ——即在测试启动阶段统一初始化共享状态，而非在测试方法间传递返回值。

1. 构建可复用的基类固件

创建抽象基类 DatabaseTestCase，封装数据库初始化逻辑与共享数据：

<?php // tests/DatabaseTestCase.php
use PHPUnit\Framework\TestCase;

abstract class DatabaseTestCase extends TestCase
{
    protected static $customer_id = null;

    protected function setUp(): void
    {
        parent::setUp();

        // 仅在首次运行时插入测试客户（避免重复）
        if (self::$customer_id === null) {
            $this->initializeTestCustomer();
        }
    }

    private function initializeTestCustomer(): void
    {
        // 使用真实仓库或模拟对象插入客户
        $repository = new CustomerRepository(/* ... */);
        self::$customer_id = $repository->insertNewUser(
            'testuser.test.com', 'password', 'test', 'user'
        );

        $this->assertIsInt(self::$customer_id);
        $this->assertGreaterThan(0, self::$customer_id);
    }
}

所有需要该客户 ID 的测试类均继承此基类：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php // tests/CustomerRepositoryTest.php
class CustomerRepositoryTest extends DatabaseTestCase
{
    public function testInsertNewCustomer(): void
    {
        $this->assertNotNull(self::$customer_id);
        $this->assertIsInt(self::$customer_id);
    }
}

<?php // tests/AddressRepositoryTest.php
class AddressRepositoryTest extends DatabaseTestCase
{
    public function testInsertNewAddress(): void
    {
        $this->dropData('address');

        $addressRepo = new AddressRepository(/* ... */);
        $addressId = $addressRepo->insertNewAddress(
            self::$customer_id, // ✅ 直接使用静态属性
            'Test Street', 'Test', 22222, 'Test', 'billing'
        );

        $this->assertIsInt($addressId);
        $this->assertGreaterThan(0, $addressId);
    }
}

2. 进阶优化：按需初始化 + 清理保障

为提升性能与可靠性，建议将昂贵操作（如数据库重建）移至 setUpBeforeClass()，并确保清理逻辑：

abstract class DatabaseTestCase extends TestCase
{
    protected static $customer_id = null;

    public static function setUpBeforeClass(): void
    {
        parent::setUpBeforeClass();
        // 一次性克隆/重置测试数据库（耗时操作放此处）
        self::resetTestDatabase();
        self::initializeSharedTestData();
    }

    private static function resetTestDatabase(): void
    {
        // 执行 SQL TRUNCATE 或调用迁移工具重置 schema
        exec('php artisan migrate:fresh --env=testing');
    }

    private static function initializeSharedTestData(): void
    {
        $repo = new CustomerRepository(/* ... */);
        self::$customer_id = $repo->insertNewUser(
            'fixture-user@example.com', 'pass', 'Fixture', 'User'
        );
    }

    protected function tearDown(): void
    {
        // 每个测试后清理关联数据（可选，视业务而定）
        if ($this->hasCleanUp()) {
            $this->cleanUpAfterTest();
        }
        parent::tearDown();
    }
}

⚠️ 关键注意事项

禁止在 setUp() 中重复插入：使用 static 属性 + setUpBeforeClass() 确保全局唯一初始化，避免每个测试都执行 DB 写入。
勿滥用 @depends 跨类：@depends 仅适用于同一类内严格有序的单元测试链（如“创建→更新→删除”），不适用于跨类数据共享。
优先考虑更轻量级替代方案：
- 对纯逻辑层，用 Mock 对象替代真实 DB 调用；
- 使用内存数据库（如 SQLite in-memory）加速固件加载；
- 利用数据库事务回滚（@beforeTransaction / @afterTransaction）实现零成本隔离。
固件即契约：明确文档化固件状态（如“self::$customer_id 总是有效客户 ID”），所有测试必须尊重该约定。