写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 教程/ 工程化/ PHPUnit 入门:先测最该测的部分
工程化 PHPUnit单元测试质量

PHPUnit 入门:先测最该测的部分

安装与目录结构、一个测试用例的写法、断言、数据提供器、如何测试依赖数据库的代码。

单元测试的价值不在覆盖率数字,而在「改代码时敢不敢动」。有测试兜底,重构才有底气。

安装与结构

BASH
composer require --dev phpunit/phpunit

测试放在 tests/ 目录,命名空间映射为 App\Tests\。文件名以 Test.php 结尾,类要继承 TestCase,方法名以 test 开头或者用 @test 注解。

PHP
<?php
namespace App\Tests;

use PHPUnit\Framework\TestCase;
use App\Service\PriceCalculator;

class PriceCalculatorTest extends TestCase
{
    public function testDiscountApplied(): void
    {
        $calc = new PriceCalculator();
        $this->assertSame(90.0, $calc->final(100.0, 0.1));
    }

    public function testNegativePriceRejected(): void
    {
        $this->expectException(\InvalidArgumentException::class);
        (new PriceCalculator())->final(-1, 0.1);
    }
}

assertSame 比较类型和值,assertEquals 只比较值。金额、ID 这类必须用 assertSame,否则 '100' 和 100 会被认为相等。

数据提供器

一个逻辑要测多组数据时,用 dataProvider,避免复制粘贴十个测试方法。

PHP
/**
 * @dataProvider priceCases
 */
public function testFinal(float $in, float $rate, float $expect): void
{
    $this->assertSame($expect, (new PriceCalculator())->final($in, $rate));
}

public static function priceCases(): array
{
    return [
        [100.0, 0.0, 100.0],
        [100.0, 0.1, 90.0],
        [0.0, 0.5, 0.0],
    ];
}

依赖数据库的代码

不要让单元测试连真实数据库。把数据访问抽成接口,测试时传一个内存实现(fake)。如果确实要测 SQL,单独用集成测试,连一个测试库,每个用例前清表。

从哪开始测

优先测三类:金额计算、权限判断、状态流转。这三类出错代价最高,且逻辑相对独立,容易测。模板渲染、简单 CRUD 可以不测。

覆盖率 30% 的核心逻辑,比覆盖率 90% 的 getter/setter 有价值得多。别为了数字写测试。

接着读