欢迎来到PHPUnit单元测试讲座：从基础到进阶，轻松搞定PHP代码质量

大家好！今天我们要聊的是PHP中的单元测试神器——PHPUnit。如果你还在用echo调试代码，或者靠手动测试来验证功能，那么恭喜你，你已经来到正确的地方！让我们一起探索如何用PHPUnit让你的代码更加健壮、优雅和自信。

---

第一章：PHPUnit是什么？为什么需要它？

1. PHPUnit的基础概念

PHPUnit是一个用于PHP的单元测试框架，它的目标是帮助开发者编写可维护、高质量的代码。简单来说，它就是一个“代码检查员”，帮你确认代码是否按预期工作。

举个例子，假设你写了一个函数addNumbers，它的任务是把两个数字相加：

function addNumbers($a, $b) {
    return $a + $b;
}

你觉得这个函数没问题，但万一有人传入了字符串怎么办？或者传入了浮点数呢？手动测试可能漏掉这些情况，而单元测试可以帮你自动验证所有可能的边界条件。

2. 单元测试的重要性

• 提高代码质量：通过测试，你可以发现隐藏的bug。
• 减少回归问题：当你修改代码时，测试可以确保旧的功能没有被破坏。
• 促进代码设计：写测试的过程会迫使你思考代码的结构和逻辑。

---

第二章：PHPUnit的基础用法

1. 安装PHPUnit

首先，你需要安装PHPUnit。推荐使用Composer（PHP的依赖管理工具）来安装：

composer require --dev phpunit/phpunit ^9

安装完成后，你可以在项目中运行以下命令来执行测试：

vendor/bin/phpunit

2. 编写第一个测试

假设我们有一个简单的类Calculator，它包含一个add方法：

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

接下来，我们为这个类编写一个测试文件：

// tests/CalculatorTest.php
use PHPUnitFrameworkTestCase;

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

运行测试：

vendor/bin/phpunit

如果一切正常，你会看到绿色的输出，表示测试通过。

3. 常用断言方法

PHPUnit提供了丰富的断言方法，用于验证代码的行为是否符合预期。以下是一些常用的断言：

方法	描述
$this->assertEquals()	验证两个值是否相等
$this->assertNotEquals()	验证两个值是否不相等
$this->assertTrue()	验证表达式是否为真
$this->assertFalse()	验证表达式是否为假
$this->assertNull()	验证值是否为null
$this->assertNotNull()	验证值是否不为null

---

第三章：PHPUnit的进阶用法

1. 数据提供者（Data Providers）

有时候，我们需要对同一个测试用例运行多次，每次传入不同的参数。这时可以使用数据提供者。

例如，我们想测试add方法在不同输入下的表现：

public function additionProvider() {
    return [
        [0, 0, 0],
        [1, 1, 2],
        [-1, -1, -2],
        [1.5, 2.5, 4]
    ];
}

/**
 * @dataProvider additionProvider
 */
public function testAddWithDataProvider($a, $b, $expected) {
    $calculator = new Calculator();
    $this->assertEquals($expected, $calculator->add($a, $b));
}

这样，testAddWithDataProvider会被执行4次，每次传入不同的参数。

2. 模拟对象（Mock Objects）

在复杂的系统中，你的代码可能会依赖外部服务或数据库。为了隔离测试环境，我们可以使用模拟对象。

假设我们的Calculator类依赖一个Logger接口：

interface Logger {
    public function log($message);
}

class Calculator {
    private $logger;

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

    public function add($a, $b) {
        $result = $a + $b;
        $this->logger->log("Adding $a and $b gives $result");
        return $result;
    }
}

我们可以使用PHPUnit的$this->createMock()方法来创建一个模拟的Logger对象：

public function testAddWithMockLogger() {
    $mockLogger = $this->createMock(Logger::class);
    $mockLogger->expects($this->once())
               ->method('log')
               ->with($this->stringContains('Adding'));

    $calculator = new Calculator($mockLogger);
    $calculator->add(2, 3);
}

在这个测试中，我们验证了Logger的log方法是否被调用了一次，并且传递了正确的消息。

3. 测试覆盖率（Code Coverage）

测试覆盖率是指测试覆盖了多少代码行。PHPUnit可以帮助我们生成覆盖率报告。

首先，在phpunit.xml中启用覆盖率配置：

<phpunit>
    <coverage processUncoveredFiles="true">
        <include>
            <directory suffix=".php">src</directory>
        </include>
    </coverage>
</phpunit>

然后运行以下命令生成HTML报告：

vendor/bin/phpunit --coverage-html coverage

打开coverage/index.html，你就可以看到哪些代码被测试覆盖了。

---

第四章：实战演练与总结

1. 实战演练

假设你正在开发一个购物车系统，其中有一个Cart类，负责计算总价。请尝试为以下功能编写测试：

• 添加商品到购物车。
• 计算购物车的总价格。
• 清空购物车。

提示：可以使用数据提供者来测试不同的商品组合。

2. 总结

通过今天的讲座，我们学习了PHPUnit的基础和进阶用法。从简单的断言到复杂的模拟对象，再到测试覆盖率分析，PHPUnit为我们提供了一个强大的工具链，帮助我们构建高质量的PHP应用。

记住，单元测试不仅仅是代码的一部分，它更是你对自己代码的信心来源。正如国外技术文档所说：“Write tests, not excuses.”（写测试，而不是找借口）。

希望今天的讲座对你有所帮助！如果有任何问题，请随时提问。