PHP PHPUnit 框架

什么是 PHPUnit？

PHPUnit 是 PHP 中最流行的单元测试框架之一。它允许开发者编写测试用例来验证代码的正确性，确保代码在修改或重构后仍然按预期工作。单元测试是一种测试方法，专注于测试代码的最小单元（通常是函数或方法），以确保其行为符合预期。

PHPUnit 提供了丰富的断言方法（assertions），用于验证代码的输出是否符合预期。通过编写测试用例，开发者可以更自信地修改代码，同时减少引入错误的风险。

安装 PHPUnit

在开始使用 PHPUnit 之前，你需要先安装它。可以通过 Composer 来安装 PHPUnit：

bash
composer require --dev phpunit/phpunit

安装完成后，你可以通过以下命令验证 PHPUnit 是否正确安装：

bash
./vendor/bin/phpunit --version

编写第一个测试用例

让我们从一个简单的例子开始。假设我们有一个名为 Calculator 的类，其中包含一个 add 方法，用于将两个数字相加。

php
class Calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }
}

接下来，我们为 Calculator 类编写一个测试用例。创建一个名为 CalculatorTest.php 的文件，并编写以下代码：

php
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
    public function testAdd()
    {
        $calculator = new Calculator();
        $result = $calculator->add(2, 3);
        $this->assertEquals(5, $result);
    }
}

在这个测试用例中，我们使用了 assertEquals 断言方法来验证 add 方法的输出是否等于 5。

运行测试

要运行测试，可以使用以下命令：

bash
./vendor/bin/phpunit CalculatorTest.php

如果一切正常，你应该会看到类似以下的输出：

PHPUnit 9.5.10 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 00:00.001, Memory: 4.00 MB

OK (1 test, 1 assertion)

这表示测试通过了，add 方法的行为符合预期。

常用的断言方法

PHPUnit 提供了多种断言方法，用于验证代码的不同方面。以下是一些常用的断言方法：

assertEquals($expected, $actual)：验证 $actual 是否等于 $expected。
assertTrue($condition)：验证 $condition 是否为 true。
assertFalse($condition)：验证 $condition 是否为 false。
assertNull($value)：验证 $value 是否为 null。
assertContains($needle, $haystack)：验证 $haystack 是否包含 $needle。

提示

你可以通过查阅 PHPUnit 官方文档来了解更多断言方法。

实际应用场景

假设你正在开发一个电子商务网站，其中有一个 Order 类，用于处理订单。你希望确保 Order 类中的 calculateTotal 方法能够正确计算订单的总金额。

php
class Order
{
    private $items = [];

    public function addItem($price, $quantity)
    {
        $this->items[] = ['price' => $price, 'quantity' => $quantity];
    }

    public function calculateTotal()
    {
        $total = 0;
        foreach ($this->items as $item) {
            $total += $item['price'] * $item['quantity'];
        }
        return $total;
    }
}

我们可以为 Order 类编写一个测试用例，验证 calculateTotal 方法的正确性：

php
use PHPUnit\Framework\TestCase;

class OrderTest extends TestCase
{
    public function testCalculateTotal()
    {
        $order = new Order();
        $order->addItem(10, 2); // 10 * 2 = 20
        $order->addItem(5, 3);  // 5 * 3 = 15
        $total = $order->calculateTotal();
        $this->assertEquals(35, $total);
    }
}

通过这个测试用例，我们可以确保 calculateTotal 方法能够正确计算订单的总金额。

总结

PHPUnit 是一个强大的工具，可以帮助你编写可靠的 PHP 代码。通过编写测试用例，你可以确保代码在修改或重构后仍然按预期工作。本文介绍了 PHPUnit 的基本概念、安装方法、如何编写和运行测试用例，以及一些常用的断言方法。

备注

测试驱动开发（TDD）是一种开发方法，强调在编写实际代码之前先编写测试用例。通过 TDD，你可以更好地理解需求，并确保代码的质量。

附加资源

练习

为 Calculator 类添加一个 subtract 方法，并编写相应的测试用例。
修改 Order 类，使其支持折扣功能，并编写测试用例验证折扣是否正确应用。
尝试使用 PHPUnit 的其他断言方法，如 assertTrue 和 assertFalse，编写更多的测试用例。

通过完成这些练习，你将更深入地理解 PHPUnit 的使用方法，并掌握测试驱动的开发技巧。

什么是 PHPUnit？​

安装 PHPUnit​

编写第一个测试用例​

运行测试​

常用的断言方法​

实际应用场景​

总结​

附加资源​

练习​