PHPUnit是PHP最流行的单元测试框架，通过Composer安装并编写测试用例可有效保障代码质量。首先在项目中使用composer require --dev phpunit/phpunit安装，然后为类如Calculator编写对应测试文件CalculatorTest，继承TestCase并使用assertEquals等断言方法验证逻辑。可通过./vendor/bin/phpunit tests/CalculatorTest.php运行测试，支持异常、边界情况检测，如expectException用于验证是否抛出预期异常。持续编写测试能构建安全的开发防护网，降低维护成本。
PHP单元测试是确保代码质量的重要手段，PHPUnit 是 PHP 社区中最流行的单元测试框架。通过编写测试用例，开发者可以在修改代码后快速验证功能是否正常，避免引入新问题。下面介绍 PHPUnit 的安装、基本使用方法以及如何编写测试用例。
安装 PHPUnit
推荐使用 Composer 来安装 PHPUnit，这是 PHP 的依赖管理工具。
- 在项目根目录运行命令安装 PHPUnit（以最新兼容版本为例）：
composer require --dev phpunit/phpunit
- 安装完成后，可以通过以下命令运行测试：
./vendor/bin/phpunit
立即学习“PHP免费学习笔记（深入）”；
这样安装的是项目本地依赖，不会影响全局环境，适合团队协作。
编写第一个测试用例
假设我们有一个简单的计算器类 Calculator.php：
class Calculator
{
public function add($a, $b)
{
return $a + $b;
}
}
?>
我们在 tests 目录下创建对应的测试文件 CalculatorTest.php：
use PHPUnit\Framework\TestCase;
class CalculatorTest extends TestCase
{
public function testAddReturnsSumOfTwoNumbers()
{
$calc = new Calculator();
$result = $calc->add(2, 3);
$this->assertEquals(5, $result);
}
}
?>
这个测试用例验证了 add 方法是否正确返回两个数的和。
运行测试并查看结果
执行以下命令运行测试：
./vendor/bin/phpunit tests/CalculatorTest.php
如果测试通过，你会看到类似输出：
OK (1 test, 1 assertion)
如果断言失败，PHPUnit 会提示哪一行出错、期望值和实际值分别是什么。
常用断言方法
PHPUnit 提供了丰富的断言方法来验证各种情况：
- $this->assertEquals($expected, $actual)：检查两个值是否相等
- $this->assertTrue($condition)：检查条件是否为 true
- $this->assertFalse($condition)：检查条件是否为 false
- $this->assertNull($value)：检查值是否为 null
- $this->assertContains('needle', $haystack)：检查数组或字符串是否包含某内容
- $this->assertGreaterThan($expected, $actual)：检查实际值是否大于期望值
这些方法帮助你精确控制测试逻辑。
测试异常和边界情况
有时需要测试代码是否会抛出预期异常。例如：
public function testDivideByZeroThrowsException()
{
$calc = new Calculator();
$this->expectException(InvalidArgumentException::class);
$calc->divide(10, 0);
}
这段代码确保当除数为 0 时，系统抛出指定异常。
基本上就这些。掌握 PHPUnit 的基本用法后，你可以为项目中的关键逻辑编写测试，提升代码健壮性。测试不是负担，而是开发过程中的安全网。坚持写测试，长期来看能显著减少 bug 和维护成本。
