- A+

写PHP框架的单元测试核心在于隔离功能、验证逻辑正确性。重点是使用合适的工具,结合框架特性编写可维护的测试用例。下面从工具选择和用例编写两方面说明。
常用PHP单元测试工具
PHPUnit 是PHP最主流的单元测试框架,支持断言、模拟、数据提供者等功能,与Laravel、Symfony等主流框架集成良好。
安装方式(通过Composer):
composer require --dev phpunit/phpunit
配置phpunit.xml可定义测试目录、自动加载规则等。
立即学习“PHP免费学习笔记(深入)”;
其他辅助工具:
- Mockery:用于生成模拟对象,解耦依赖
- Prophecy: PHPUnit内置的模拟库,语义清晰
- Codeception:更高级的测试框架,支持单元、功能、API测试
测试用例编写方法
以Laravel为例,测试一个UserService类中的用户创建逻辑。
示例代码结构:

一个AI文本生成检测工具

108
查看详情

// app/Services/UserService.php
class UserService {
public function createUser(array $data) {
if (empty($data['name'])) {
throw new InvalidArgumentException('Name is required');
}
return User::create($data);
}
}
对应的测试文件:
// tests/Unit/UserServiceTest.php
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
class UserServiceTest extends TestCase {
use RefreshDatabase;
public function test_create_user_with_valid_data() {
$service = new UserService();
$user = $service->createUser(['name' => 'John']);
$this->assertEquals('John', $user->name);
$this->assertDatabaseHas('users', ['name' => 'John']);
}
public function test_throw_exception_when_name_is_missing() {
$service = new UserService();
$this->expectException(InvalidArgumentException::class);
$service->createUser([]);
}
}
关键点:
- 每个测试方法聚焦单一功能
- 使用断言(如assertEquals、assertDatabaseHas)验证结果
- 异常测试用 expectException 捕获预期错误
- 数据库操作配合 RefreshDatabase 避免污染
模拟外部依赖
当服务依赖邮件发送、API调用等外部组件时,应使用模拟对象。
例如,UserService中调用了MailService:
public function createUser(array $data) {
$user = User::create($data);
$this->mailService->sendWelcomeEmail($user);
return $user;
}
测试时模拟MailService:
public function test_create_user_sends_welcome_email() {
$mockMailService = Mockery::mock(MailService::class);
$mockMailService->shouldReceive('sendWelcomeEmail')->once();
$service = new UserService($mockMailService);
$service->createUser(['name' => 'John']);
}
这样避免真实发送邮件,提升测试速度和稳定性。
基本上就这些。掌握工具使用、合理设计测试边界、保持测试独立性和可重复性,是写出高质量PHP单元测试的关键。




