PHPUnit是官方推荐的PHP单元测试框架,需通过Composer安装并验证版本;被测函数应为纯函数,测试类须继承TestCase且以Test结尾;测试方法以test开头并使用assertEquals等断言;通过命令行运行测试并可加--verbose参数查看详情。

如果您需要验证PHP函数的正确性与稳定性,PHPUnit是官方推荐的单元测试框架。以下是使用PHPUnit对PHP函数进行单元测试的具体步骤:
一、安装PHPUnit
PHPUnit需通过Composer全局或项目级安装,确保PHP环境已启用JSON和XML扩展。安装后可直接调用命令行工具执行测试用例。
1、在项目根目录执行composer require --dev phpunit/phpunit命令安装PHPUnit开发依赖。
2、确认vendor/bin/phpunit文件存在且具备可执行权限。
立即学习“PHP免费学习笔记(深入)”;
3、运行vendor/bin/phpunit --version验证安装成功,输出版本号必须高于9.0以支持PHP 8+语法特性。
二、编写被测函数
单元测试需基于明确的输入与预期输出,因此被测函数应为独立、无副作用的纯函数。避免依赖全局状态、数据库或外部API。
1、在src/Calculator.php中定义一个加法函数:function add($a, $b) { return $a + $b; }。
2、确保该函数所在文件已通过require_once或自动加载机制引入测试文件。
3、函数参数类型与返回值类型声明必须与测试断言严格一致,例如int型输入不可传入null或字符串。
三、创建测试类文件
PHPUnit要求测试类继承PHPUnit\Framework\TestCase,类名须以Test结尾,文件名与类名匹配,并置于tests目录下。
1、新建tests/CalculatorTest.php文件。
2、在文件顶部添加命名空间声明namespace Tests;及use语句use PHPUnit\Framework\TestCase;。
3、定义类class CalculatorTest extends TestCase,确保类名与文件名完全一致(区分大小写)。
四、编写测试方法
每个测试方法必须以test开头或添加@covers注解,用于描述单个函数行为的验证逻辑,方法内仅包含断言操作。
1、在CalculatorTest类中定义方法public function testAddReturnsCorrectSum()。
2、方法体内调用被测函数$result = add(2, 3);。
3、使用断言验证结果:$this->assertEquals(5, $result);,失败时抛出异常并中断当前测试。
五、运行测试命令
PHPUnit通过命令行扫描tests目录下的测试文件并执行,输出结果包含成功数、失败数及详细错误堆栈。
1、在项目根目录执行vendor/bin/phpunit tests/CalculatorTest.php运行指定测试文件。
2、若需测试整个tests目录,运行vendor/bin/phpunit tests/。
3、添加--verbose参数可显示每个测试方法的执行过程,便于定位未覆盖的边界条件。











