使用 PHPUnit 测试 PHP 代码的初学者指南

php中文网 2024-10-15 12:18:21

如何使用 phpunit 在 php 中开始测试 以及分步指南。

第 1 步：安装 phpunit

开始编写测试之前，您需要在项目中安装 phpunit。

您可以使用 composer 全局安装它：

composer global require phpunit/phpunit

或者为特定项目在本地安装：

composer require --dev phpunit/phpunit

安装后，您可以通过运行确认安装：

./vendor/bin/phpunit --version

第 2 步：创建一个示例类进行测试

让我们创建一个简单的计算器类来添加两个数字。这门课将是我们测试的科目。

// src/calculator.php
class calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }
}

第 3 步：创建 phpunit 测试用例

接下来，创建一个测试类来为 calculator 类编写测试。按照惯例，phpunit 测试文件应以 test.php 结尾，并放置在测试目录中。

// tests/calculatortest.php

use phpunitframeworktestcase;

class calculatortest extends testcase
{
    public function testaddition()
    {
        // arrange: create a new calculator instance
        $calculator = new calculator();

        // act: perform the add operation
        $result = $calculator-&gt;add(2, 3);

        // assert: verify the result is 5
        $this-&gt;assertequals(5, $result);
    }
}

逐个部分细分

测试班:

测试类calculatortest 扩展了testcase，它是phpunit 提供的基类。每个测试类都应该继承于此。
安排：

在 testaddition 方法中，我们实例化 calculator 类。此步骤设置测试所需的一切（通常称为“安排”阶段）。
行动：

我们使用值 2 和 3 调用 calculator 类中的 add() 方法。这是我们正在测试的操作或行为。
断言:

最后，我们使用assertequals()方法来验证add(2, 3)的输出确实是5。如果断言为真，则测试通过；如果断言为真，则测试通过；如果断言为真，则测试通过。否则会失败。

第 4 步：运行测试

要运行测试，请在终端中执行以下命令：

./vendor/bin/phpunit tests

如果一切设置正确，您应该看到类似以下的输出：

phpunit 9.5.4 by sebastian bergmann and contributors.

.                                                                   1 / 1 (100%)

time: 00:00.010, memory: 4.00 mb

ok (1 test, 1 assertion)

第 5 步：扩展测试用例

让我们添加另一个方法来测试减法，并编写相应的测试用例。

更新计算器类：

// src/calculator.php
class calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }

    public function subtract($a, $b)
    {
        return $a - $b;
    }
}

更新测试用例：

// tests/calculatortest.php
use phpunitframeworktestcase;

class calculatortest extends testcase
{
    public function testaddition()
    {
        $calculator = new calculator();
        $result = $calculator-&gt;add(2, 3);
        $this-&gt;assertequals(5, $result);
    }

    public function testsubtraction()
    {
        $calculator = new calculator();
        $result = $calculator-&gt;subtract(5, 3);
        $this-&gt;assertequals(2, $result);
    }
}

第 6 步：运行所有测试

再次运行测试以确保加法和减法方法都有效：

./vendor/bin/phpunit tests

如果两项测试都通过，您应该看到：

PHPUnit 9.5.4 by Sebastian Bergmann and contributors.

..                                                                  2 / 2 (100%)

Time: 00:00.010, Memory: 4.00 MB

OK (2 tests, 2 assertions)