PHPUnit：期望方法含义

Question

当我创建一个新的模拟时，我需要调用 expects 方法。它到底是做什么的？它的论点呢？

$todoListMock = $this->getMock('\Model\Todo_List');
        $todoListMock->expects($this->any())
            ->method('getItems')
            ->will($this->returnValue(array($itemMock)));

我在任何地方都找不到原因（我已经尝试过文档）。我已经阅读了来源，但我无法理解。

Answer 1

expects() - 设置你期望一个方法被调用的次数：

$mock = $this->getMock('nameOfTheClass', array('firstMethod','secondMethod','thirdMethod'));
$mock->expects($this->once())
     ->method('firstMethod')
     ->will($this->returnValue('value'));
$mock->expects($this->once())
     ->method('secondMethod')
     ->will($this->returnValue('value'));
$mock->expects($this->once())
     ->method('thirdMethod')
     ->will($this->returnValue('value'));

如果你知道，该方法在 expects() 中使用 $this->once() 调用一次，否则使用 $this->any()

见：
PHPUnit mock with multiple expects() calls

https://phpunit.de/manual/current/en/test-doubles.html#test-doubles.stubs

http://www.slideshare.net/mjlivelyjr/advanced-phpunit-testing

Answer 2

查看源代码会告诉你：

/**
 * Registers a new expectation in the mock object and returns the match
 * object which can be infused with further details.
 *
 * @param  PHPUnit_Framework_MockObject_Matcher_Invocation $matcher
 * @return PHPUnit_Framework_MockObject_Builder_InvocationMocker
 */
public function expects(PHPUnit_Framework_MockObject_Matcher_Invocation $matcher);

PHPUnit 手册在

列出了可用的匹配器

• https://phpunit.de/manual/current/en/test-doubles.html#test-doubles.mock-objects.tables.matchers

• any() 返回一个匹配器，当它被评估的方法被执行零次或多次时匹配。
• never() 返回一个匹配器，当它被评估的方法从未被执行时匹配。
• atLeastOnce() 返回一个匹配器，当它被评估的方法至少执行一次时匹配。
• once() 返回一个匹配器，当它被评估的方法只执行一次时匹配。
• exactly(int $count) 返回一个匹配器，当它被评估的方法被执行 $count 次时匹配。
• at(int $index) 返回一个匹配器，当它被评估的方法在给定的 $index 处调用时匹配。