PHPUnit 12.0.9版本中Mock对象构建器的变更解析

在PHPUnit 12.0.9版本中，框架对Mock对象的内部实现进行了重要调整，移除了PHPUnit\Framework\MockObject\Builder\InvocationMocker这个类。这一变更虽然属于内部实现细节的调整，但由于历史原因，这个类在早期版本中被部分开发者直接引用，导致升级后可能遇到静态分析工具报错的情况。

变更背景

PHPUnit作为PHP生态中最流行的单元测试框架，其Mock功能一直是核心特性之一。在12.0.9版本之前，框架内部使用InvocationMocker类来处理Mock对象的方法调用预期设置。这个类本应作为内部实现细节，不应该被外部代码直接依赖，但在实际使用中，部分开发者可能会通过IDE自动补全或查看源码的方式直接引用到这个类。

技术影响

虽然移除了InvocationMocker类，但PHPUnit团队确保了这一变更不会破坏现有的测试代码。开发者仍然可以继续使用原有的链式调用方式来设置Mock预期：

$mockedService
    ->expects($this->exactly(1))
    ->method('get')
    ->with(24)
    ->willReturn('24');

这段代码在运行时完全正常，只是在使用静态分析工具（如PHPStan）并启用了phpstan-phpunit扩展时，可能会报告"Call to method method() on an unknown class"的错误。

解决方案

对于遇到此问题的开发者，有以下几种处理方式：

1. 等待扩展更新：phpstan-phpunit扩展需要更新以适应PHPUnit的这一变更。开发者可以关注相关扩展的更新情况。

2. 临时解决方案：在等待扩展更新的同时，可以通过在phpstan.neon配置文件中排除相关错误来临时解决问题：

parameters:
    ignoreErrors:
        - '#Call to method method\(\) on an unknown class#'

3. 代码重构：虽然不必要，但开发者也可以考虑重构测试代码，使用更现代的Mock创建方式，如：

$mockedService = $this->createMock(MyService::class);
$mockedService->method('get')
    ->with(24)
    ->willReturn('24');

最佳实践建议

这一变更提醒我们几个重要的开发实践：

1. 避免依赖内部实现：测试代码应该只依赖框架公开的API，而不是内部实现类。

2. 关注框架更新日志：在升级框架版本时，仔细阅读变更日志，了解可能的破坏性变更。

3. 合理使用静态分析：静态分析是强大的工具，但要理解其局限性，特别是当分析规则尚未适配最新框架版本时。

PHPUnit团队表示这一变更本应在12.0.0大版本中就实施，但由于疏忽而延迟到了12.0.9版本。这也说明了即使是成熟的开源项目，在版本管理和变更控制上也存在挑战。对于开发者而言，理解框架的内部实现变化有助于编写更健壮的测试代码。