首先创建单元测试文件并编写测试方法,使用 php artisan make:test 命令生成测试类,在测试中通过 RefreshDatabase 保证数据隔离,利用 Mail::fake() 等模拟外部依赖,并通过清晰命名和单一职责原则组织测试,最后运行 php artisan test 执行验证。

在使用 Laravel 这个流行的 PHP 框架时,单元测试是确保代码质量的重要环节。Laravel 内置了对 PHPUnit 的支持,让你可以轻松为应用中的逻辑编写测试用例。下面通过实际流程说明如何在 Laravel 中实现单元测试。
创建和运行基本测试
Laravel 自带 tests 目录,其中包含 Unit(单元测试)和 Feature(功能测试)两个子目录。单元测试用于验证独立的类或方法,不涉及完整的 HTTP 请求流程。
使用 Artisan 命令创建一个单元测试:
php artisan make:test UserServiceTest –unit
这会在 tests/Unit 目录下生成 UserServiceTest.php 文件。打开文件后,你可以添加测试方法:
立即学习“PHP免费学习笔记(深入)”;
示例:测试用户服务中计算活跃用户数量的方法
public function test_it_counts_active_users()
{
// 创建测试数据
User::factory()->create([‘active’ => true]);
User::factory()->create([‘active’ => false]);
$service = new UserService();
$count = $service->getActiveUserCount();
$this->assertEquals(1, $count);
}
运行这个测试:
php artisan test –filter=UserServiceTest
测试中使用数据库
即使在单元测试中,有时也需要访问数据库。Laravel 提供了 RefreshDatabase trait 来清空测试期间的数据,保证测试独立性。
在测试类中引入该 trait:

简单好用的日语面试辅助工具
57
查看详情
use Illuminate\Foundation\Testing\RefreshDatabase;
class UserServiceTest extends TestCase
{
use RefreshDatabase;
// 测试方法…
}
这样每次测试运行前后数据库都会被重置,避免数据污染。
模拟依赖提升测试效率
单元测试应尽量隔离外部依赖,比如邮件发送、第三方 API 调用等。Laravel 支持使用 Fake 机制来模拟这些服务。
例如,测试一个发送欢迎邮件的控制器方法:
use Illuminate\Support\Facades\Mail;
public function test_welcome_email_is_sent()
{
Mail::fake();
$response = $this->post(‘/register’, [
‘name’ => ‘John’,
’email’ => ‘john@example.com’
]);
Mail::assertSent(WelcomeEmail::class, function ($mail) {
return $mail->hasTo(‘john@example.com’);
});
}
这里没有真正发邮件,而是通过断言确认邮件“应该”被发送,既安全又高效。
组织和维护测试用例
保持测试可读性和可维护性很重要。建议:
- 给测试方法起清晰的名字,如 it_returns_error_when_email_is_invalid
- 每个测试只验证一个行为
- 使用 setUp() 方法初始化共用对象
- 定期运行全部测试:php artisan test
基本上就这些。Laravel 的测试工具链让 PHP 框架的单元测试变得直观且强大,合理使用能显著提升项目稳定性。
大家都在看:
windows11截图快捷键是什么_windows11快速截图操作技巧
win11系统声音突然变得很小怎么办_win11系统音量突然变小修复方法
神马搜索App翻译历史管理介绍_神马搜索App常用语保存方法
c++中头文件和源文件的区别_c++头文件与源文件作用解析
































暂无评论内容