Date: 2025-05-28 17:35:46 author: lijianzhan
在 Laravel 框架中，单元测试是一种常用的测试方法，它是允许你测试应用程序中的最小可测试单元，通常是方法或函数。Laravel 提供了内置的测试工具PHPUnit，实践中进行单元测试是保障代码质量的核心。以下是关键要点和最佳实践指南：
运行环境
操作系统：Windows X64
PHP版本：8.2.9nts
Laravel Framework：10.48.28
IDE：phpstorm2024.1.5
Laravel 测试体系结构
| 测试类型 | 存放路径 | 特点 |
|---|---|---|
| 单元测试(Unit) | tests/Unit | 测试独立类/方法，不依赖框架 |
| – | – | – |
| 功能测试 (Feature) | tests/Feature | 测试完整业务流（含路由、数据库） |
- 通过 Composer 来安装或更新 PHPUnit测试库依赖，以下命令：
composer require --dev phpunit/phpunit
- 通过Artisan 命令创建测试类
// 创建模型测试
php artisan make:test ExampleTest
// 创建控制器测试
php artisan make:test ExampleControllerTest
// 创建模型测试
php artisan make:test ExampleServiceTest
- 编写测试用例
<?php
namespace Tests\Feature;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* A basic test example.
*
* @return void
*/
public function test_example()
{
$result = "start unit success!";
dd($result);
}
}
- 运行测试
（1）使用Artisan 命令运行test测试用例
php artisan test
（2）运行命令后返回信息
（3）或者使用Artisan 命令运行test指定目录测试用例
php artisan test tests/Feature/ExampleTest.php
（4）使用代码编辑器自带Debug方法
运行测试用例返回结果
常用断言方法示例
$this->assertTrue($condition);
$this->assertEquals($expected, $actual);
$this->assertCount(3, $array);
$this->assertInstanceOf(User::class, $object);
$this->assertDatabaseHas('users', ['email' => 'test@example.com']);
// 数据库事务回滚
$this->assertDatabaseCount('users', 1);
- 测试覆盖率分析
# 1. 安装 Xdebug 或 PCOV
sudo apt install php8.1-xdebug
# 2. 运行测试并生成报告
php artisan test --coverage-html=coverage-report
# 3. 查看报告
open coverage-report/index.html
- 测试金字塔原则
总结：Laravel的构建考虑到了测试。事实上，对PHPUnit测试的支持是现成的，并且已经为您的应用程序设置了PHPUnit.xml文件。该框架还附带了方便的辅助方法，允许您对应用程序进行富有表现力的测试。