PHP单元测试入门：PHPUnit编写测试教程

学习文章要努力，但是不要急！今天的这篇文章《PHP单元测试入门：使用PHPUnit编写测试用例》将会介绍到等等知识点，如果你想深入学习文章，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

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
<?php class Calculator
{
    public function add(int $a, int $b): int
    {
        return $a + $b;
    }
}

对应测试文件应放在 tests/ 目录下（如 tests/CalculatorTest.php）：

<?php use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
    public function testAddReturnsCorrectSum(): void
    {
        $calc = new Calculator();
        $this->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 实际值。例如：

说明 add(2, 3) 返回了 4 而非 5 —— 这就是测试帮你揪出的 bug。

基本上就这些。不复杂但容易忽略：测试不是写完再补，而是和功能代码一起写（TDD 或至少 ATDD），越早开始，收益越大。

到这里，我们也就讲完了《PHP单元测试入门：PHPUnit编写测试教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！