环境与工具准备
安装PHPUnit与配置环境
在开始编写PHP单元测试之前，确认开发环境中已安装PHP版本与Composer，通常推荐使用PHP 7.4及以上版本以获得更好的语法与断言支持。通过Composer本地安装PHPUnit可以确保项目依赖的一致性，避免全局冲突并便于CI集成。
第一步是通过Composer将PHPUnit作为开发依赖添加到项目中，并在项目根目录生成可重复使用的测试执行命令。以下命令适用于大多数项目：
composer require --dev phpunit/phpunit ^9
vendor/bin/phpunit --version
接着，可以在项目根目录创建或更新phpunit.xml.dist配置文件，使测试用例自动定位测试目录并启用彩色输出等特性。配置示例如下，自动加载依赖并定位tests目录：
./tests 创建一个基本的测试目录结构
为实现清晰的测试管理，建议遵循统一的目录结构，将生产代码与测试代码分离，测试用例放在tests目录下。这样不仅有利于重复执行，还能提升代码可维护性。
下面给出一个常见的目录示例：src/存放待测试的类，tests/存放对应的测试用例，vendor/由Composer生成，包含PHPUnit与自动加载器。
快速验证环境的最简测试
在测试结构就绪后，先用一个最简单的测试来确认框架能正确工作。创建tests/SampleTest.php并添加一个基本断言，确保PHPUnit能够执行并回传测试结果。
assertTrue(true);}
}
此时运行测试，如果输出显示测试通过，表示环境配置正确，后续可以扩展更复杂的用例。
单元测试理念与基本概念
测试类、测试方法与命名约定
PHPUnit 通过测试类来组织测试用例，测试方法应以 test 前缀命名，或使用 @test 注解，以便框架自动识别。命名应简洁且描述性，便于快速定位失败原因。
在测试类中，setUp 与 tearDown 方法用于准备与清理测试用例的公共资源，这避免了重复代码，提升测试速度与稳定性。
下面是一个简短的示例，演示如何初始化被测试对象并编写一个简单断言：
calc = new Calculator();}public function testAdd() {\$this->assertEquals(4, \$this->calc->add(2, 2));}
}
测试用例与断言的组合
断言是单元测试的核心，常用的断言包括 assertEquals、assertSame、assertTrue、assertFalse、assertNull 等，结合不同场景选择合适的断言类型能更准确地验证边界条件。
在实际场景中，测试通常包含对输入有效性、边界条件、异常处理等多维度的覆盖，合理组合断言能提升测试的鲁棒性并减少误报。
编写第一个实际的测试用例
从零开始的示例：一个简单的计算器
请先实现一个简易的计算器类，用于演示如何编写测试用例来验证基础功能。下面给出一个最小实现，帮助你完成第一轮测试。
生产代码：实现一个简单的加法和减法功能，保持 API 直观易用，确保测试用例与实现逻辑高度对齐。
测试代码：覆盖加法和减法两种基本运算，利用 setUp 复用 Calculator 实例，确保命名清晰，便于扩展更多运算。
calculator = new Calculator();}public function testAdd() {\$this->assertEquals(5, \$this->calculator->add(2, 3));\$this->assertEquals(0, \$this->calculator->add(-2, 2));}public function testSubtract() {\$this->assertEquals(1, \$this->calculator->subtract(3, 2));}
}
运行测试的方式简单直接：vendor/bin/phpunit 可以执行tests目录下的所有测试用例，若要限定执行某个测试文件可指定路径。
vendor/bin/phpunit tests/CalculatorTest.php --colors=1
测试输出中若出现绿色通过信息，表示实现符合预期；若失败，仔细阅读断言失败信息与栈样表，定位到代码与测试不一致的地方进行修正。
常用断言与测试技巧
断言族与边界条件
在实际开发中，断言的覆盖范围要尽量覆盖正常、边界以及异常情况，常用组合包括对等、类型和值的一致性验证，以及对集合、对象状态的断言。
示例：对一个返回布尔值的接口在边界条件进行断言，及对空值、空集合等场景进行断言。
assertSame($expected, is_even($input));
}
public function providerIsEven() {return [[2, true],[3, false],[0, true],[-4, true]];
}
数据提供者（Data Providers）使测试具备多组输入，提升覆盖率且避免重复代码，用于参数化测试的场景尤为常见。
另一个常见场景是测试异常，例如传入非法参数时应触发特定异常：使用 expectException 指定期望的异常类型。
expectException(\\InvalidArgumentException::class);divide(10, 0);
}
覆盖率、报告与持续集成
获取代码覆盖率与生成报告
为了评估测试集对代码的覆盖程度，可以开启代码覆盖率统计。需要在 PHP 运行时开启Xdebug、或使用PCOV等覆盖工具，再通过PHPUnit输出覆盖率报告，便于分析未覆盖的代码区域。
在 phpunit.xml 中开启覆盖率收集并指定要分析的目录，随后通过命令生成 HTML 报告、CSV/Clover 等格式的报告，覆盖率越高，测试质量越有保障。
./src vendor/bin/phpunit --coverage-html=coverage
持续集成阶段，将覆盖率报告与测试执行集成到CI工作流中，可以在每次提交时自动生成报告并阻断低覆盖率的合并。
name: PHP Unit Tests
on: [push, pull_request]
jobs:phpunit:runs-on: ubuntu-lateststeps:- uses: actions/checkout@v4- name: Setup PHPuses: shivammathur/setup-php@v2with:php-version: '8.0'- name: Install dependenciesrun: composer install- name: Run testsrun: vendor/bin/phpunit --colors=1 --coverage-html=coverage
通过这些步骤，可以形成稳定的持续测试、持续集成的工作流，确保代码在不同提交后保持行为一致。
模拟对象与数据驱动测试
Mock对象与数据驱动
在测试中经常需要替换复杂依赖，使用 PHPUnit 的 Mock 对象可以独立测试目标逻辑，避免对外部系统的实际调用影响测试结果。
下面是一个简单的 Mock 示例，演示如何验证一个组件是否正确调用了邮件发送接口：
createMock(MailerInterface::class);$mailer->expects($this->once())->method('send')->with($this->equalTo('order@example.com'));$processor = new OrderProcessor($mailer);$processor->process($order);
}
此外，数据提供者（Data Providers）也可用于 Mock 场景，结合多组输入测试不同逻辑分支，提高测试的覆盖度与鲁棒性。
从零到实战的落地步骤
一个实战工作流
在实际项目中，测试通常遵循以下工作流：识别核心业务路径 → 编写测试用例 → 运行测试 → 发现失败 → 修正实现或测试 → 重新运行直到通过，确保每次修改都不会破坏既有行为。
为了确保工作流顺畅，建议把测试编写纳入日常开发流程，并结合版本控制与CI工具进行自动化执行。以下简要步骤帮助你快速落地：
# 1) 添加测试用例
# 2) 运行全部测试
vendor/bin/phpunit# 3) 查看覆盖率，调整测试用例
vendor/bin/phpunit --coverage-html=coverage# 4) 集成到CI
# 通过 CI 配置在每次提交时执行上述命令
通过持续的练习与迭代，你将从零基础逐步掌握从单元测试到持续集成的完整实战技能，在实际项目中实现高质量的测试覆盖。
