使用PHPUnit进行PHP单元测试需先通过Composer安装并配置phpunit.xml，再创建继承TestCase的测试类，编写以test开头的方法，利用assertEquals、assertTrue等断言验证结果，结合框架集成特性运行测试，并通过vendor/bin/phpunit命令执行与调试。

如果您在开发PHP应用时需要验证代码的正确性与稳定性，使用单元测试可以帮助您自动检测函数或类的行为是否符合预期。以下是PHPUnit在PHP框架中编写单元测试的基本方法：

一、安装与配置PHPUnit

在使用PHPUnit之前，需要确保其已正确安装并可被项目调用。可以通过Composer进行依赖管理来引入PHPUnit。

1、打开终端并进入您的PHP项目根目录。

2、执行命令：composer require --dev phpunit/phpunit，该命令将安装PHPUnit作为开发环境依赖。

3、安装完成后，可在vendor/bin/目录下使用phpunit命令运行测试。

4、创建phpunit.xml配置文件以定义测试目录、引导脚本和代码覆盖率设置等。

二、创建基本测试用例

每个测试类通常对应一个被测类，且需继承自PHPUnit\Framework\TestCase。测试方法必须以test开头或使用@test注解标识。

1、在项目中新建tests目录，并创建一个测试类文件，例如UserTest.php。

2、编写类结构如下：

use PHPUnit\Framework\TestCase;

class UserTest extends TestCase {

    public function testCanCreateUser() {

        $user = new User('John');

        $this->assertEquals('John', $user->getName());

    }

}

3、确保被测类User已正确引入，必要时使用自动加载机制（如Composer的autoload）。

三、使用断言验证结果

断言是单元测试的核心，用于判断实际输出是否等于预期结果。PHPUnit提供了多种断言方法来满足不同场景的需求。

1、使用$this->assertEquals($expected, $actual)检查两个值是否相等。

2、使用$this->assertTrue($condition)确认条件为真。

3、使用$this->assertNull($value)验证变量是否为空。

4、使用$this->assertCount($count, $array)检查数组元素数量。

5、对于异常测试，可使用$this->expectException(Exception::class)声明预期抛出的异常类型。

四、在框架中集成测试

主流PHP框架（如Laravel、Symfony、CodeIgniter）均对PHPUnit进行了深度集成，提供专用命令和辅助函数简化测试流程。

1、在Laravel中，测试文件位于tests/Feature和tests/Unit目录下，可直接使用$this->get()、$this->post()模拟HTTP请求。

2、运行框架自带的测试命令，例如Laravel使用php artisan test启动所有测试用例。

3、利用框架提供的测试数据库配置，确保每次测试都在干净的数据环境中执行。

4、通过RefreshDatabase trait重置数据库状态，避免测试间相互影响。

五、运行与调试测试

执行测试后，根据输出结果定位失败原因并进行修复，是保障代码质量的关键步骤。

1、在终端运行vendor/bin/phpunit执行全部测试用例。

2、指定特定测试文件或目录：执行vendor/bin/phpunit tests/UserTest.php仅运行用户测试。

3、添加--filter参数按名称匹配测试方法，例如--filter testCanCreateUser。

4、查看失败信息中的堆栈跟踪，快速定位断言失败的具体位置。