PHP单元测试入门教学_PHP使用PHPUnit编写测试

发布时间：2025-12-19 | 点击率：

PHP单元测试是保障代码质量、支持持续重构的基础能力，PHPUnit是最成熟测试框架；需用Composer安装为开发依赖，配置composer.json的scripts后可直接运行composer test。

PHP单元测试不是“可有可无的加分项”，而是保障代码质量、支持持续重构的基础能力。PHPUnit 是 PHP 生态最成熟、文档最完善的测试框架，掌握它等于拿到了 PHP 工程化开发的入门钥匙。

现代 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

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

assertEquals(5, $calc->add(2, 3));
        $this->assertEquals(0, $calc->add(-1, 1));
    }
}

注意：测试方法必须是 public，且不能带参数；断言方法（如 assertEquals）来自父类 TestCase。

除了 assertEquals，这些断言高频实用：

小技巧：

在项目根目录执行：vendor/bin/phpunit tests/CalculatorTest.php

成功时显示绿色 OK，失败时会标红并指出哪行断言失败、期望值 vs 实际值。例如：

Failed asserting that 4 matches expected 5.

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

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