PHPUnit：Mock类中指定方法并保留其他方法原实现

没问题！要在PHPUnit里Mock MyClass的foo()方法但保留bar()的原有逻辑，你需要用到部分模拟（Partial Mocks）——这正是用来处理这种只需要替换类中特定方法，其余方法保持原实现的场景。

核心实现思路 #

PHPUnit提供了灵活的方式创建部分Mock，推荐用getMockBuilder的写法，直观且易维护：

use PHPUnit\Framework\TestCase;

class MyClassTest extends TestCase
{
    public function testBarWithMockedFoo()
    {
        // 1. 准备构造函数所需的依赖（用Mock对象替代真实依赖即可）
        $mockDep1 = $this->createMock(Dep1::class);
        $mockDep2 = $this->createMock(Dep2::class);
        $mockDep3 = $this->createMock(Dep3::class);
        $mockDep4 = $this->createMock(Dep4::class);

        // 2. 创建MyClass的部分Mock：只Mock foo方法，其余方法保留原实现
        $myClassPartialMock = $this->getMockBuilder(MyClass::class)
            ->setConstructorArgs([$mockDep1, $mockDep2, $mockDep3, $mockDep4]) // 传入构造参数
            ->onlyMethods(['foo']) // 指定仅Mock foo方法
            ->getMock();

        // 3. 定义被Mock的foo方法的行为
        $myClassPartialMock->method('foo')
            ->willReturn('mocked_foo_result'); // 设置你需要的Mock返回值

        // 4. 测试bar方法：此时bar会执行原有的逻辑，而foo会使用Mock后的行为
        $barResult = $myClassPartialMock->bar();
        
        // 编写断言逻辑，验证bar的返回值符合预期
        $this->assertEquals('expected_bar_result', $barResult);

        // （可选）验证foo方法是否被调用（如果你的bar逻辑里会触发foo的话）
        $myClassPartialMock->expects($this->once())
            ->method('foo');
    }
}

关键细节说明 #

• onlyMethods的作用：这个方法明确告诉PHPUnit，除了数组里指定的foo方法，其他所有方法都保留原类的实现逻辑。如果你使用的是PHPUnit 7或更早版本，需要替换成setMethods(['foo'])，不过新版本更推荐语义清晰的onlyMethods。
• 构造参数处理：因为我们没有Mock构造函数，所以必须传入符合MyClass构造函数要求的依赖实例——哪怕是用createMock生成的空Mock对象，只要类型匹配就能正常运行。
• 方法权限兼容：哪怕foo是protected方法，只要在onlyMethods里指定方法名，同样可以Mock它，不影响测试逻辑。

注意事项 #

• 如果bar方法被标记为final，完全不用担心——Partial Mock不会改动它，它依然会执行原有的逻辑（毕竟PHPUnit无法Mock final方法，而我们本来就不想修改它的行为）。
• 尽量避免过度使用Partial Mock：如果你的类需要频繁Mock部分方法，可能意味着类的职责过于复杂，建议拆分单一职责类，让测试更简洁易维护。

内容的提问来源于stack exchange，提问作者koseduhemak