php 8.5 不提供内置 mock 功能,mock 依赖 phpunit 10+ 等测试框架;需用 createmock() 或 mockery 实现,注意只读类、union 类型和 enum 的适配限制。

确认 PHPUnit 版本与 PHP 兼容性
PHPUnit 10.x 要求 PHP ≥ 8.1,完全支持 PHP 8.3/8.4,并已为 PHP 8.5 做好向后兼容准备(如对 union type 改进、只读类增强、enum 扩展 的适配)。安装命令:
composer require --dev phpunit/phpunit ^10.5
验证是否生效:
vendor/bin/phpunit --version → 应输出类似 PHPUnit 10.5.10 by Sebastian Bergmann
用 PHPUnit 内置 MockBuilder 创建 Mock 对象
PHPUnit 10+ 推荐使用 $this->createMock() 或更灵活的 $this->getMockBuilder(),而非已废弃的 getMock()。关键点:
-
基础 Mock(仅替换方法返回值):
$mailer = $this->createMock(MailerInterface::class);$mailer->method('send')->willReturn(true); -
带行为验证的 Mock(检查调用次数与参数):
$logger = $this->createMock(LoggerInterface::class);$logger->expects($this->once())
->method('error')
->with($this->stringContains('timeout')); -
Partial Mock(只 mock 某些方法,其余保留原逻辑):
$service = $this->getMockBuilder(UserService::class)
->onlyMethods(['callExternalApi'])
->getMock();$service->method('callExternalApi')->willReturn(['id' => 123]);
处理 PHP 8.3+ 新特性带来的 Mock 注意事项
PHP 8.3 引入了 #[\Override] 属性、只读类(readonly class)、以及更严格的类型推导。这些会影响 Mock 行为:
-
只读类不能被 Mock:若被测类声明为
readonly class PaymentClient,PHPUnit 无法生成其 Mock(因无法继承或重写属性)。解决方案是:改用接口依赖(如PaymentClientInterface),Mock 接口而非具体类。 -
Union 类型方法参数需显式匹配:例如方法签名
public function log(string|int $msg): void,Mock 验证时需用with($this->logicalOr($this->isType('string'), $this->isType('int'))),或更推荐用with($this->anything())放宽校验。 -
Enum 成员不可被 mock 方法覆盖:枚举类的静态方法(如
Status::active())无法被插桩。应避免在业务逻辑中直接调用 enum 工厂方法,改为通过服务封装,再 Mock 该服务。
替代方案:用 Mockery 实现更语义化的 Mock
若需要链式预期、动态参数匹配或更清晰的 DSL,可搭配 Mockery(v1.6+ 完全支持 PHP 8.3/8.4):
composer require --dev mockery/mockery
示例:
$payment = \Mockery::mock(PaymentGateway::class);$payment->shouldReceive('charge')
->with(199.99, 'USD')
->andReturn(['status' => 'success', 'tx_id' => 'tx_abc']);$this->addToAssertionCount(1); // 告知 PHPUnit 此处有断言
注意:使用 Mockery 时需在 tearDown() 中调用 \Mockery::close() 清理。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











