PHPUnit 12.0.0 新特性与升级指南

PHPUnit 是 PHP 生态中最流行的单元测试框架之一，它为开发者提供了强大的测试工具和丰富的断言方法。PHPUnit 12.0.0 作为主要版本更新，带来了多项重要改进和变化，同时也移除了一些过时功能。本文将详细介绍这些变化，帮助开发者顺利升级并充分利用新版本特性。

新特性介绍

PHPUnit 12.0.0 引入了几个强大的新注解，增强了测试覆盖范围的定义能力：

1. 类继承关系覆盖注解：新增了 #[CoversClassesThatExtendClass] 和 #[UsesClassesThatExtendClass] 注解，允许开发者声明测试覆盖或使用继承自特定类的所有类。

2. 接口实现覆盖注解：新增了 #[CoversClassesThatImplementInterface] 和 #[UsesClassesThatImplementInterface] 注解，可以方便地声明测试覆盖或实现了特定接口的所有类。

3. 命名空间覆盖注解：新增了 #[CoversNamespace] 和 #[UsesNamespace] 注解，简化了对整个命名空间下所有类的覆盖声明。

4. 环境变量要求注解：新增了 #[RequiresEnvironmentVariable] 注解，可以指定测试运行所需的环境变量，增强了测试的环境依赖性管理。

配置变更

PHPUnit 12.0.0 调整了一个重要的默认配置：

• 数组导出限制：shortenArraysForExportThreshold 的默认值从 0（不限制数组导出层级）改为 10（限制数组导出最多10层）。这一变化可以防止在测试失败时输出过于庞大的数组结构，提高测试输出的可读性。

废弃功能

PHPUnit 12.0.0 正式废弃了几个方法，这些方法在之前的版本中已经被软废弃：

1. 类型断言方法：Assert::isType() 方法被废弃，建议使用更具体的类型断言方法。

2. 包含类型检查：assertContainsOnly() 和 assertNotContainsOnly() 方法被废弃，这些方法的功能可以通过组合其他断言方法实现。

3. 匹配器方法：containsOnly() 方法被废弃，这是 PHPUnit 向更现代化 API 演进的一部分。

移除功能

PHPUnit 12.0.0 移除了多个不再推荐使用的功能，主要包括：

1. 环境设置方法：移除了 TestCase::iniSet() 和 TestCase::setLocale() 方法，这些环境设置应该通过其他方式处理。

2. 测试代理和模拟对象创建：移除了 TestCase::createTestProxy()、TestCase::getMockForAbstractClass()、TestCase::getMockFromWsdl()、TestCase::getMockForTrait() 和 TestCase::getObjectForTrait() 方法，这些功能应该通过专门的测试双精度库实现。

3. MockBuilder 配置选项：移除了多个 MockBuilder 的配置方法，包括 enableAutoload()、disableAutoload()、allowMockingUnknownTypes() 等，简化了模拟对象的创建过程。

4. 其他移除：移除了对 PHP 8.2 的支持、文档注释中的元数据支持、逗号分隔的 CLI 选项值支持等。

升级建议

对于计划升级到 PHPUnit 12.0.0 的项目，建议：

1. 全面检查测试代码：查找并替换所有被废弃和移除的方法调用。

2. 利用新注解：评估新引入的覆盖注解是否能简化现有测试代码。

3. 调整测试环境：确保测试环境满足 PHPUnit 12.0.0 的要求，特别是 PHP 版本支持。

4. 逐步升级：在开发环境中先进行升级测试，确保所有测试用例仍能正常运行。

PHPUnit 12.0.0 的这些变化反映了测试框架向更现代化、更专注的方向发展，移除过时功能的同时提供了更强大的测试覆盖管理能力。合理利用这些新特性，可以编写出更清晰、更易维护的测试代码。