PHPUnit是PHP主流单元测试框架，需通过Composer安装并配置phpunit.xml；为业务类编写Test类及test方法，用assertEquals断言结果；用@dataProvider注入多组参数提升覆盖率；用createMock隔离外部依赖；用@expectException等验证异常逻辑。
如果您正在开发PHP网站并希望确保核心业务逻辑的正确性，则需要为关键函数和类编写可重复执行的自动化测试用例。PHPUnit是PHP生态中最主流的单元测试框架，以下为构建有效测试用例的具体步骤：
一、安装PHPUnit并配置基础测试环境
PHPUnit需作为开发依赖安装在项目中，确保其与当前PHP版本兼容，并能被自动加载器识别。测试文件应独立于生产代码存放，避免部署时被意外包含。
1、在项目根目录执行命令：composer require --dev phpunit/phpunit。
2、创建phpunit.xml配置文件，指定tests/为测试源目录，src/为待测源码目录。
立即学习“PHP免费学习笔记（深入）”；
3、验证安装是否成功：运行vendor/bin/phpunit --version，输出版本号即表示就绪。
二、为业务类编写首个测试用例类
每个被测类应对应一个同名Test类，位于tests/下对应子路径中，类名以Test结尾，方法名以test开头，确保PHPUnit可自动发现并执行。
1、假设存在src/Calculator.php，其中含add(int $a, int $b): int方法。
2、在tests/CalculatorTest.php中定义类：class CalculatorTest extends \PHPUnit\Framework\TestCase。
3、在该类中添加方法：public function testAddReturnsCorrectSum(): void。
4、在方法体内调用$this->assertEquals(5, (new Calculator())->add(2, 3));完成断言。
三、使用数据提供器覆盖多种输入组合
单一测试方法难以覆盖边界值与异常输入，@dataProvider注解可将多组参数注入同一测试方法，提升覆盖率并减少重复代码。
1、在测试类中定义私有静态方法，如public static function additionProvider(): array。
2、该方法返回二维数组，每项为[输入a, 输入b, 期望结果]，例如[0, 0, 0], [-1, 1, 0], [100, 200, 300]。
3、在测试方法上方添加注解：/** @dataProvider additionProvider */。
4、修改测试方法签名，接收三个参数：public function testAddReturnsCorrectSum(int $a, int $b, int $expected): void。
四、模拟外部依赖以隔离测试范围
当被测方法依赖数据库、HTTP客户端或第三方服务时，直接调用会导致测试不稳定或变慢。PHPUnit内置Mock功能可创建可控的替代对象，仅验证交互逻辑而非实际行为。
1、在测试方法中调用$mock = $this->createMock(DatabaseConnection::class)生成模拟实例。
2、设置期望行为：$mock->expects($this->once())->method('query')->with('SELECT * FROM users')->willReturn([])。
3、将该模拟对象注入待测服务构造函数或setter中。
4、执行被测方法后，PHPUnit自动校验是否按预期调用了指定方法及参数。
五、断言异常与错误处理逻辑
核心业务常需对非法输入抛出特定异常，此类逻辑必须显式验证，否则可能掩盖运行时崩溃风险。
1、在测试方法上方添加注解：/** @expectException InvalidArgumentException */。
2、在方法体内调用会触发异常的代码，例如(new UserService())->createUser('')（空用户名应抛出异常）。
3、若需进一步检查异常消息，改用$this->expectExceptionMessage('Username cannot be empty')。
4、也可使用$this->expectExceptionCode(400)验证自定义异常码。
