PHPUnit单元测试怎么写？新手入门教程

本文是一份简洁实用的PHPUnit单元测试入门指南，手把手教你从零开始为PHP项目编写可靠、可维护的单元测试：涵盖Composer安装配置、phpunit.xml设置、测试类结构设计、以test前缀或@test注解定义测试方法、核心断言（如assertEquals、assertTrue）的正确使用、setUp/tearDown生命周期管理，以及通过@dataProvider实现数据驱动测试等关键实践；强调测试的独立性、可重复性和逻辑覆盖，让开发者快速掌握PHPUnit精髓，为代码重构和质量保障打下坚实基础。

写PHPUnit测试并不复杂，关键在于理解它的基本结构和运行逻辑。只要掌握几个核心概念，就能快速上手为PHP代码编写可靠的单元测试。

安装与配置PHPUnit

在开始写测试前，先确保环境已准备好。推荐使用Composer来安装PHPUnit，避免全局依赖冲突。

• 在项目根目录执行：composer require --dev phpunit/phpunit
• 创建phpunit.xml配置文件，定义测试目录、引导文件等
• 例如，指定测试用例放在tests/目录下，自动加载使用autoload-dev

编写第一个测试用例

假设你有一个简单的计算器类，包含加法方法。测试的目标是验证这个方法的行为是否符合预期。

• 创建Calculator.php在src/目录
• 在tests/目录下新建CalculatorTest.php
• 测试类需继承\PHPUnit\Framework\TestCase
• 每个测试方法必须以test开头，或使用@test注解

示例代码：

class CalculatorTest extends \PHPUnit\Framework\TestCase
{
    public function testAddReturnsCorrectResult()
    {
        $calc = new Calculator();
        $result = $calc->add(2, 3);
        $this->assertEquals(5, $result);
    }
}

常用断言方法

断言是测试的核心，用于验证实际结果是否符合预期。

• $this->assertEquals($expected, $actual)：判断两个值是否相等
• $this->assertTrue($condition)：判断条件是否为真
• $this->assertNull($value)：判断值是否为null
• $this->assertIsString($value)：判断类型是否为字符串
• $this->expectException(Exception::class)：验证是否抛出异常

合理使用这些断言能让测试更精确，也更容易定位问题。

测试生命周期与数据提供者

PHPUnit会在每个测试方法前后自动调用特定方法，可用于初始化或清理资源。

• setUp()：在每个测试方法前执行，适合创建对象实例
• tearDown()：在每个测试后执行，用于释放资源
• 使用@dataProvider可以为一个测试方法提供多组数据

例如：

public static function additionProvider()
{
    return [
        [2, 3, 5],
        [0, 0, 0],
        [-1, 1, 0]
    ];
}
<p>/**</p>

• @dataProvider additionProvider */ public function testAddWithMultipleData($a, $b, $expected) { $calc = new Calculator(); $this->assertEquals($expected, $calc->add($a, $b)); }

基本上就这些。写好PHPUnit测试的关键是保持测试独立、可重复，并覆盖主要逻辑路径。随着项目变大，测试会成为你重构代码时最可靠的保障。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~