Laravel内置PHPUnit支持,提供单元测试和功能测试两类,通过TestCase基类和辅助方法如assertDatabaseHas、RefreshDatabase等简化测试流程,可使用php artisan test命令运行测试,建议从简单类测试入手逐步覆盖业务逻辑。

在 Laravel 项目中写单元测试非常方便,因为框架本身就集成了 PHPUnit,并提供了丰富的辅助方法来简化测试流程。如果你刚接触 Laravel 测试,可以从基础的单元测试和功能测试开始。
什么是 PHPUnit 和 Laravel 中的测试
PHPUnit 是 PHP 的标准单元测试框架。Laravel 默认使用 PHPUnit 来运行测试,测试文件放在 tests 目录下。Laravel 提供了两种主要类型的测试:
- 单元测试(Unit Tests):测试单个函数、类或方法的逻辑,不涉及数据库、路由或外部服务。
- 功能测试(Feature Tests):测试整个请求响应流程,比如访问某个路由是否返回正确页面或 JSON 数据。
Laravel 为这两类测试都提供了基类:Tests\TestCase,所有测试类都会继承它。
创建第一个单元测试
假设你有一个简单的数学工具类,用来做加法运算:
立即学习“PHP免费学习笔记(深入)”;
// app/Services/MathService.php
namespace App\Services;
class MathService
{
public function add($a, $b)
{
return $a + $b;
}
}
你可以为这个类写一个单元测试:
// tests/Unit/MathServiceTest.php
namespace Tests\Unit;
use Tests\TestCase;
use App\Services\MathService;
class MathServiceTest extends TestCase
{
public function test_it_can_add_two_numbers()
{
$math = new MathService();
$result = $math->add(3, 5);
$this->assertEquals(8, $result);
}
}
运行这个测试:
php artisan test --filter=MathServiceTest
如果看到绿色的“OK”,说明测试通过了。
测试 Laravel 功能:例如用户注册
功能测试更贴近实际使用场景。比如测试用户注册接口是否正常工作:
// tests/Feature/UserRegistrationTest.php
namespace Tests\Feature;
use Tests\TestCase;
use Illuminate\Foundation\Testing\RefreshDatabase;
class UserRegistrationTest extends TestCase
{
use RefreshDatabase; // 每次测试后清空测试数据库
public function test_user_can_register()
{
$response = $this->post('/register', [
'name' => 'John Doe',
'email' => 'john@example.com',
'password' => 'password',
'password_confirmation' => 'password',
]);
$response->assertRedirect('/dashboard');
$this->assertDatabaseHas('users', [
'name' => 'John Doe',
'email' => 'john@example.com',
]);
}
}
几点说明:
- RefreshDatabase:确保测试不会污染真实数据,推荐用于涉及数据库的操作。
- $this->post():模拟 POST 请求。
- assertRedirect:断言跳转到指定路径。
- assertDatabaseHas:断言数据库中存在某条记录。
常用断言方法
在测试中,断言是验证结果的核心。常见的有:
- $this->assertEquals($expected, $actual):判断两个值是否相等。
- $this->assertTrue($condition):判断是否为 true。
- $response->assertStatus(200):检查 HTTP 状态码。
- $response->assertSee('text'):检查响应内容是否包含某文本。
- $response->assertJson(['key' => 'value']):检查 JSON 响应结构。
- $this->assertNull($value):判断是否为 null。
运行测试
Laravel 提供了 Artisan 命令来运行测试:
- php artisan test:运行所有测试。
- php artisan test --filter=MathServiceTest:运行指定测试类或方法。
- php artisan test --parallel:并行运行测试(Laravel 9+),加快速度。
你也可以只运行单元测试或功能测试:
php artisan test --parallel --group=Unit
小建议
- 测试类命名规范:以测试类型开头,如 UserTest 或 MathServiceTest。
- 测试方法名尽量描述行为,如 test_user_cannot_view_unpublished_post。
- 使用 RefreshDatabase 避免数据残留。
- 不要测试第三方包逻辑,只测试自己的代码。











