You need to enable JavaScript to run this app. 编写PHPUnit单元测试提示setMethods方法已废弃如何解决
优惠活动
大模型
产品
解决方案
定价
更多

编写PHPUnit单元测试提示setMethods方法已废弃如何解决

问题场景

PHPUnit测试中创建PaymentGateway模拟对象的原有代码触发了setMethods方法废弃告警,原代码为:

$gateway = $this->getMockBuilder('PaymentGateway')
            ->setMethods(['transfer'])
            ->getMock();
废弃原因

PHPUnit 9.5 版本起正式标记setMethods为废弃,核心问题是该方法语义边界模糊:它同时覆盖三类完全不同的mock场景,很容易引发使用误用。官方将其拆分为语义明确的独立方法,从设计上减少认知偏差。

对应迁移方案

根据实际的mock需求,选择对应替代方法即可实现完全一致的效果,不会出现行为变化:

  • 仅mock指定的类内置方法,其余方法保留真实实现
    这是绝大多数场景下使用setMethods的核心需求,直接替换为onlyMethods即可:

    $gateway = $this->getMockBuilder(PaymentGateway::class)
                ->onlyMethods(['transfer'])
                ->getMock();
    

    该方法的语义就是仅对传入数组中的方法打桩mock,数组外的原类方法全部保留真实实现,和旧版setMethods的常规使用效果完全对齐。
    建议同步将字符串形式的类名替换为::class写法,既可以避免类名拼写错误,也能获得IDE自动补全支持。

  • mock原类所有方法,仅保留指定方法的真实实现
    替换为setMethodsExcept,传入需要保留真实实现的方法列表即可:

    // 示例:所有方法默认mock,仅保留getSupportedCurrency方法的真实逻辑
    $gateway = $this->getMockBuilder(PaymentGateway::class)
                ->setMethodsExcept(['getSupportedCurrency'])
                ->getMock();
    
  • 为模拟类添加原类本身不存在的动态方法mock
    替换为addMethods,该方法专门用于处理非原类定义的动态方法场景:

    // 示例:给模拟类添加原类不存在的calcFee方法
    $gateway = $this->getMockBuilder(PaymentGateway::class)
                ->addMethods(['calcFee'])
                ->getMock();
    
组合使用说明

复杂场景下可以在链式调用中组合多个上述方法,比如同时需要mock部分内置方法、新增动态方法、排除部分方法走真实逻辑,不需要像旧版setMethods把所有目标方法整合到同一个数组中。

内容的提问来源于stack exchange,提问作者Khaled Boussoffara

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 22:15:05