如何在 PHP 中使用 PHPUnit 编写单元测试

简介

单元测试是一种用于测试单个软件函数或方法是否按预期运行的技术。PHPUnit 是一个用于 PHP 的流行单元测试框架，在编写健壮且可维护的代码时非常有用。

安装 PHPUnit

立即学习“PHP免费学习笔记（深入）”；

要在 PHP 中使用 PHPUnit，首先需要将其安装到你的项目中。可以使用 Composer 来执行此操作：

composer require --dev phpunit/phpunit

编写测试用例

要编写 PHPUnit 测试用例，需要创建一个新的 PHP 文件并将其命名以 ".test.php" 为后缀。例如，对于 Person 类，你可以创建 PersonTest.php 文件。

在测试用例文件中，使用 PHPUnitFrameworkTestCase 类作为基类。每个测试方法应该以 "test" 开头，后跟要测试的功能的名称：

use PHPUnitFrameworkTestCase;

class PersonTest extends TestCase
{
    // ...
}

测试断言

PHPUnit 提供了各种断言方法来验证测试结果是否符合预期。一些常用的断言包括：

• assertEquals()：验证两个值是否相等。
• assertContains()：验证一个数组或字符串是否包含特定的值。
• assertGreaterThan()：验证一个值是否大于另一个值。
• assertInstanceOf()：验证一个对象是否属于特定的类。

实战示例

考虑以下 Person 类，它具有一个 getName() 方法来获取人的姓名：

class Person
{
    private $name;

    public function __construct($name)
    {
        $this->name = $name;
    }

    public function getName()
    {
        return $this->name;
    }
}

我们可以在 PersonTest.php 中为 Person 类编写一个测试用例：

use PHPUnitFrameworkTestCase;

class PersonTest extends TestCase
{
    public function testCanGetPersonName()
    {
        $name = 'John';
        $person = new Person($name);

        $this->assertEquals($name, $person->getName());
    }
}

在此测试用例中，我们创建了一个 Person 对象并验证了 getName() 方法返回的名称是否与预期名称相匹配。

运行测试

要运行 PHPUnit 测试，可以使用 phpunit 命令，后跟测试目录或文件：

phpunit PersonTest.php

成功运行后，PHPUnit 将显示测试结果，包括通过和失败的测试：

PHPUnit 9.5.20 by Sebastian Bergmann and contributors.

Time: 91 ms, Memory: 7.00 MB

OK (1 test, 1 assertion)