在现代PHP开发中，编写可维护、稳定的代码离不开自动化测试。而PHPUnit作为PHP社区最主流的单元测试框架，已经成为许多项目的标配工具。它不仅可以帮助我们验证代码逻辑是否正确，还能在重构时提供安全保障。本文将一步步带你通过Composer安装PHPUnit，并实际编写一个简单的单元测试示例，让你真正理解如何在项目中落地使用。

首先，确保你的开发环境中已经安装了PHP和Composer。如果你还没有安装Composer，可以访问其官网（getcomposer.org）下载并安装。这是整个过程的基础。一旦确认环境准备就绪，就可以开始安装PHPUnit了。

打开终端，进入你的项目根目录。如果还没有composer.json文件，可以通过运行 composer init 初始化项目配置。接下来，推荐使用本地依赖的方式安装PHPUnit，这样不会影响全局环境，也更利于团队协作。执行以下命令：

bash composer require --dev phpunit/phpunit

这里的 --dev 参数表示该依赖仅用于开发环境，不会被包含在生产部署中。Composer会自动解析依赖关系，下载PHPUnit及其所需组件。安装完成后，你可以在 vendor/bin/ 目录下找到 phpunit 可执行文件。

为了方便运行测试，建议在 composer.json 中添加一个脚本别名。修改文件中的 scripts 部分如下：

json "scripts": { "test": "phpunit" }

这样，之后只需运行 composer test 就能启动测试套件，无需记忆复杂的路径。

接下来是配置PHPUnit。在项目根目录创建 phpunit.xml 配置文件，内容如下：

xml <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="vendor/autoload.php" colors="true"> <testsuites> <testsuite name="Application Test Suite"> <directory>tests</directory> </testsuite> </testsuites> </phpunit>

这个配置指定了自动加载入口文件为 Composer 生成的 autoload.php，开启彩色输出，并告诉PHPUnit去 tests 目录下查找测试用例。

现在，创建 tests 目录，并在里面新建一个测试类。假设我们要测试一个简单的计算器类。先在 src/Math/Calculator.php 中定义类：

php
<?php

namespace App\Math;

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

然后在 tests/Math/CalculatorTest.php 中编写对应的测试：

php
<?php

use App\Math\Calculator;
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
private $calculator;

protected function setUp(): void
{
    $this->calculator = new Calculator();
}

public function testAddReturnsSumOfTwoNumbers()
{
    $result = $this->calculator->add(2, 3);
    $this->assertEquals(5, $result);
}

public function testAddHandlesNegativeNumbers()
{
    $result = $this->calculator->add(-1, 1);
    $this->assertEquals(0, $result);
}

}

这个测试类继承自 TestCase，使用 setUp() 方法初始化被测对象。两个测试方法分别验证加法功能在正数和负数场景下的正确性。assertEquals 是PHPUnit提供的断言方法，用于判断预期值与实际结果是否一致。

一切就绪后，在终端运行：

bash composer test

如果一切正常，你会看到绿色的输出提示“OK (2 tests, 2 assertions)”，表示两个测试都通过了。如果有错误或失败，PHPUnit会详细列出哪条断言未通过，便于快速定位问题。

随着项目复杂度上升，你可以逐步增加更多测试类型，如数据提供者（@dataProvider）、异常测试、模拟对象（Mock）等高级功能。更重要的是，养成“先写测试，再写实现”的习惯，即测试驱动开发（TDD），这将极大提升代码质量和开发效率。

通过Composer安装和使用PHPUnit的过程并不复杂，关键在于坚持实践。每一次提交代码前运行测试，都能为你构建更健壮的应用打下坚实基础。