PHP单元测试入门教学_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免费学习笔记（深入）”；

<?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，这些断言高频实用：

标签： php js json composer