模拟类：方法提示

Question

我有以下设置：我正在使用 PHPUnit 模拟非抽象类，但不是所有方法。因此，非模拟方法仍然作为对模拟中真实方法的调用存在。

问题是：如何暗示这些方法是可用的（当然，有正确的签名）？

我会详细说明一下。班级样本：

class RealClass
{
    public function callApi(Api $api) {}

    public function doStuff(Foo $foo, Bar $bar) {}
}

现在我在做测试：

/** @var  \PHPUnit_Framework_MockObject_MockObject $mock */
$mock = $this->getMock('\RealClass', ['callApi']);

这将仅为callApi() 创建模拟，但如果在测试中我这样做：

$mock->doStuff($foo, $bar);

我的 PHPStorm 显然找不到该方法，并认为这是一个错误。我如何指出 doStuff() 方法存在并且需要正确的参数？

@method 似乎只在类定义中工作。我试着和@see 玩了一下，但无法解决这个问题。此外，理想的解决方案是允许在 return 语句中指定提示的解决方案，因为我可能希望从测试助手方法返回模拟。

“便宜的作弊”是暗示与原来的类，但我不想这样做，从那以后我就会失去意义——这是模拟的，哪个不是。这一点尤其重要，因为我使用助手来构建注入模拟的复杂实体。

Answer 1

您应该将模拟提示为 MockObject 或 RealClass 的实例，因此您会得到类似的内容：

/** @var \RealClass|\PHPUnit_Framework_MockObject_MockObject $mock */
$mock = $this->getMock('\RealClass', ['callApi']);

现在您告诉 PhpStorm $mock 可以是 PHPUnit MockObject 或 RealClass 实例，它将接受/自动完成任一类的方法。

此外（这只是一个友好的建议，完全没有必要），您可以使用 use 关键字将类导入到您的测试类中，这样您的提示就会变得更具可读性：

<?php

use \RealClass;
use \PHPUnit_Framework_MockObject_MockObject as MockObject;

class YourTestClass
{
    public function yourTest()
    {
        // Because of the use statements (and the "as" alias rule) you can now:
        /** @var RealClass|MockObject $mock */
        $mock = $this->getMock('RealClass', ['callApi']);
    }
}