PHPUnit PHAR 在 PHP 8.4 下的测试替身生成问题解析

在 PHP 单元测试领域，PHPUnit 作为最流行的测试框架之一，其 PHAR 打包版本在 PHP 8.4 环境下遇到了一个值得关注的技术问题。本文将深入分析这一问题的成因、影响范围以及解决方案。

问题现象

当开发者使用 PHPUnit 的 PHAR 版本在 PHP 8.4 环境下运行时，所有使用 createMock() 方法创建测试替身的测试用例都会失败。错误信息显示为"assert(class_exists(PropertyHookType::class))"，这实际上是一个断言错误。

值得注意的是，当 PHPUnit 通过 Composer 安装时，相同的测试用例却能正常运行。这种差异表明问题与 PHPUnit 的打包方式有关，而非框架本身的逻辑问题。

技术背景

PHP 8.4 引入了一个名为 PropertyHookType 的新内置类，这是 PHP 属性钩子系统的一部分。在 PHPUnit 的测试替身生成机制中，会检查这个类的存在性以确定是否支持属性钩子功能。

当 PHPUnit 被打包为 PHAR 文件时，构建工具 PHP-Scoper 会对代码进行转换和隔离处理。在 PHP 8.3 环境下构建时，PHP-Scoper 并不知道 PHP 8.4 新增的 PropertyHookType 类，错误地将其前缀化为 PHPUnitPHAR\PropertyHookType。

影响范围

该问题影响所有满足以下条件的场景：

1. 使用 PHPUnit 11.x 版本的 PHAR 文件
2. 运行环境为 PHP 8.4
3. 测试用例中使用了 createMock() 方法
4. 即使被模拟的类不涉及属性钩子也会触发此问题

解决方案

PHPUnit 团队已经通过以下方式解决了这个问题：

1. 更新了 PHP-Scoper 依赖版本至 0.18.16，该版本包含了对 PHP 8.4 内置类的正确处理
2. 重新构建了 PHAR 文件，确保在 PHP 8.4 环境下能正确识别 PropertyHookType 类

开发者可以通过以下方式获取修复后的版本：

• 等待 PHPUnit 11.5.2 正式发布
• 使用团队提供的快照版本进行测试

最佳实践建议

对于需要在 PHP 8.4 环境下进行单元测试的团队，建议：

1. 优先使用 Composer 安装的 PHPUnit 版本
2. 如需使用 PHAR 版本，确保升级到包含修复的版本
3. 在持续集成环境中，明确指定 PHPUnit 的运行方式以避免环境差异

这个问题展示了 PHP 新版本特性与现有工具链之间可能存在的兼容性挑战，也体现了开源社区快速响应和解决问题的能力。