0

0

Laravel 测试中实现数据库仅在测试开始时重置的正确实践

聖光之護

聖光之護

发布时间:2026-01-09 09:24:35

|

599人浏览过

|

来源于php中文网

原创

Laravel 测试中实现数据库仅在测试开始时重置的正确实践

laravel 的 `refreshdatabase` 特性默认在每个测试前后均重置数据库,但实际测试应聚焦于可重复、自验证的行为断言,而非人工查看 phpmyadmin;本文详解如何通过合理建模、工厂数据与精准断言替代“手动检查”,确保测试真正可靠、可移植且符合 laravel 最佳实践。

在 Laravel 测试中,刻意保留测试后数据库状态以供人工验证(如通过 phpMyAdmin 查看)是一种反模式。原因在于:测试的本质是自动化、可重复、环境无关的契约验证。若依赖外部工具人工核对结果,不仅破坏了测试的原子性与可移植性,还违背了 Laravel 官方倡导的“测试即文档”原则——理想中的测试应能被任何人、在任何干净环境中一键运行(如 php artisan test --group=cleanup),并明确告知“什么被修改了、是否符合预期”。

RefreshDatabase 的设计初衷正是保障这种隔离性:它在测试方法执行前清空并迁移数据库(确保初始状态一致),并在执行后立即回滚或重建(防止测试间污染)。因此,不存在官方支持的“仅开始刷新”选项——这不是功能缺失,而是有意为之的架构约束

正确的解决方案是将验证逻辑内化到测试本身,通过断言(assertions)精确描述预期状态。以下为推荐实践:

Mapify
Mapify

Mapify是由Xmind推出的AI思维导图生成工具,原名ChatMind

下载
  1. 使用工厂构建可控的初始数据集
    避免模糊的“创建一些用户”,而应显式定义每条记录的关键属性与分类标识(如 type 字段),便于后续精准断言。

  2. 执行待测逻辑(如 Artisan 命令)并验证其副作用
    使用 $this->artisan(...)->assertSuccessful() 确保命令成功执行,再通过 Eloquent 查询获取实际结果。

  3. 编写语义清晰的断言
    优先使用 assertEquals、assertNull、assertCount 等匹配业务意图的断言,而非 assertTrue(DB::table(...)->count() > 0) 这类模糊判断。

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Server\Models\User;
use Tests\TestCase;

class TestRemoveCertainData extends TestCase
{
    use RefreshDatabase;

    public function test_removes_emails_for_specific_user_types()
    {
        // Arrange: 创建四种类型用户,明确邮箱状态
        $user1 = User::factory()->create(['type' => 'type1', 'email' => 'user1@example.com']);
        $user2 = User::factory()->create(['type' => 'type2', 'email' => 'user2@example.com']);
        $user3 = User::factory()->create(['type' => 'type3', 'email' => 'user3@example.com']);
        $user4 = User::factory()->create(['type' => 'type4', 'email' => 'user4@example.com']);

        // Act: 执行清理命令
        $this->artisan('remove_data_command')->assertSuccessful();

        // Assert: 验证仅 type2 和 type4 用户邮箱被清空
        $this->assertNull($user2->fresh()->email);
        $this->assertNull($user4->fresh()->email);
        $this->assertNotNull($user1->fresh()->email);
        $this->assertNotNull($user3->fresh()->email);

        // 或批量断言(更简洁)
        $emails = User::orderBy('id')->pluck('email')->toArray();
        $this->assertEquals([
            'user1@example.com',
            null,
            'user3@example.com',
            null,
        ], $emails);
    }
}
⚠️ 注意事项: *勿在测试中调用非 `test方法**(如原示例中的removeCertainData()):PHPUnit 仅自动执行以test开头或标记@test` 的方法;否则该逻辑不会被执行。 避免 factory(...)->create() 在 Laravel 9+ 中已废弃:请改用模型工厂的静态 ::factory()->create() 方法(如上例所示)。 如需调试 SQL,启用日志而非依赖 phpMyAdmin:在 phpunit.xml 中设置 DB_LOG_QUERIES=true,或临时在测试中使用 DB::enableQueryLog() + dd(DB::getQueryLog())。

总结而言,放弃“手动检查数据库”的思维,转向“声明式断言预期状态”,不仅是 Laravel 测试的最佳实践,更是构建高可信度、易维护应用的基石。真正的测试价值,不在于你看到了什么,而在于你证明了什么。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2302

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1514

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1410

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1413

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1233

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1444

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1304

2023.11.13

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

3

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.4万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号