PHP单元测试是保障代码质量、支持持续重构的基础能力,PHPUnit是最成熟测试框架;需用Composer安装为开发依赖,配置composer.json的scripts后可直接运行composer test。

PHP单元测试不是“可有可无的加分项”,而是保障代码质量、支持持续重构的基础能力。PHPUnit 是 PHP 生态最成熟、文档最完善的测试框架,掌握它等于拿到了 PHP 工程化开发的入门钥匙。
安装 PHPUnit(推荐 Composer 方式)
现代 PHP 项目几乎都用 Composer 管理依赖,PHPUnit 也应作为开发依赖安装:
- 在项目根目录运行:composer require --dev phpunit/phpunit
- 安装完成后,可通过 vendor/bin/phpunit --version 验证是否成功
- 建议将 PHPUnit 命令写入 composer.json 的 scripts 区块,例如:
"test": "phpunit",之后直接运行 composer test 即可
写第一个测试类和测试方法
PHPUnit 要求测试类名以 Test 结尾,测试方法名以 test 开头(或用 @test 注解)。假设你有一个简单函数:
// src/Calculator.php对应测试文件应放在 tests/ 目录下(如 tests/CalculatorTest.php):
立即学习“PHP免费学习笔记(深入)”;
assertEquals(5, $calc->add(2, 3)); $this->assertEquals(0, $calc->add(-1, 1)); } }注意:测试方法必须是 public,且不能带参数;断言方法(如 assertEquals)来自父类 TestCase。
常用断言与测试组织技巧
除了 assertEquals,这些断言高频实用:
- $this->assertTrue($condition):检查布尔表达式为真
- $this->assertNull($value):验证值为 null
- $this->assertContains('needle', $haystack):检查数组或字符串是否包含目标内容
- $this->expectException(\InvalidArgumentException::class):预期某段代码抛出指定异常
小技巧:
- 每个测试方法只测一个关注点(单一职责),便于定位失败原因
- 使用 setUp() 方法准备公共对象(如 new Calculator()),避免重复代码
- 用 dataProvider 实现参数化测试,一组数据跑多个输入输出组合
运行测试与解读结果
在项目根目录执行:vendor/bin/phpunit tests/CalculatorTest.php
成功时显示绿色 OK,失败时会标红并指出哪行断言失败、期望值 vs 实际值。例如:
Failed asserting that 4 matches expected 5.说明 add(2, 3) 返回了 4 而非 5 —— 这就是测试帮你揪出的 bug。
基本上就这些。不复杂但容易忽略:测试不是写完再补,而是和功能代码一起写(TDD 或至少 ATDD),越早开始,收益越大。











