Laravel中使用PHPUnit编写单元测试时，如何在测试类执行前统一准备数据库数据

针对你遇到的需求——在某个测试类的所有方法执行前统一准备数据库数据，不用每个测试重复操作，同时保留原有数据库数据，我给你几个实用的方案和关键词参考：

核心解决方案：利用PHPUnit的类级前置钩子 #

PHPUnit提供了setUpBeforeClass静态方法，它会在整个测试类的所有测试方法执行前只运行一次，非常适合做类级别的数据准备。结合Laravel的特性，你可以这样实现：

示例代码 #

use Illuminate\Foundation\Testing\DatabaseTransactions;
use Tests\TestCase;

class UserManagementTests extends TestCase
{
    use DatabaseTransactions;

    // 用静态属性存储所有测试共享的数据
    protected static $sharedTestUser;
    protected static $existingAdminUser;

    /**
     * 所有测试方法执行前只运行一次
     */
    public static function setUpBeforeClass(): void
    {
        parent::setUpBeforeClass();
        
        // 初始化Laravel应用，确保数据库连接正常
        static::createApplication();

        // 1. 查询现有数据库数据（比如固定的管理员账号），供所有测试复用
        static::$existingAdminUser = \App\Models\User::where('role', 'admin')->first();

        // 2. 插入测试专用数据（如果需要的话）
        static::$sharedTestUser = \App\Models\User::create([
            'name' => 'Shared Test User',
            'email' => 'shared-test@example.com',
            'password' => bcrypt('test123456'),
        ]);
    }

    /**
     * 所有测试方法执行完成后清理数据
     */
    public static function tearDownAfterClass(): void
    {
        // 手动清理setUpBeforeClass中插入的数据（因为不在DatabaseTransactions的事务范围内）
        if (static::$sharedTestUser) {
            static::$sharedTestUser->delete();
        }

        parent::tearDownAfterClass();
    }

    // 测试方法1：直接使用共享数据
    public function test_user_update_function()
    {
        $response = $this->put("/users/{$this::$sharedTestUser->id}", [
            'name' => 'Updated Shared User',
        ]);

        $response->assertStatus(200);
        $this->assertEquals('Updated Shared User', static::$sharedTestUser->fresh()->name);
    }

    // 测试方法2：复用现有管理员数据
    public function test_admin_access_user_list()
    {
        $this->actingAs(static::$existingAdminUser);
        
        $response = $this->get('/users');
        $response->assertStatus(200);
        $response->assertSee(static::$sharedTestUser->name);
    }
}

关键注意事项 #

1. 静态属性存储共享数据：因为setUpBeforeClass是静态方法，必须用静态属性来保存数据，才能让所有测试方法访问到。
2. 初始化Laravel应用：一定要调用static::createApplication()，否则Laravel的数据库连接、模型都无法正常工作。
3. 多数据库处理：如果需要操作指定数据库，可以在模型操作时指定连接，比如：

   // 操作secondary_db数据库的User表
   static::$sharedTestUser = \App\Models\User::on('secondary_db')->create([/* ... */]);
   

4. 清理手动插入的数据：DatabaseTransactions trait只包裹单个测试方法的数据库操作，类级别的插入不会自动回滚，所以要在tearDownAfterClass里手动删除，避免污染数据库。

你需要搜索的关键词 #

如果你想找更多相关资料，可以用这些关键词：

• PHPUnit setUpBeforeClass Laravel
• Laravel test class-wide database setup
• Laravel PHPUnit share data between test methods
• Laravel DatabaseTransactions class level

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