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()

参见：
具有多个 Expects() 调用的 PHPUnit 模拟

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 处调用它所评估的方法时，该匹配器会匹配。