<?php

use PHPUnit\Framework\TestCase;

class ExactlyTest extends TestCase
{
    public function testCounterCall() : void
    {
        $counter = $this->getMockBuilder(Counter::CLASS)
            ->enableProxyingToOriginalMethods()
            ->getMock();
        $counter->expects($this->exactly(3))
            ->method('increment');
        
        $this->assertEquals(1, $counter->increment());
        $this->assertEquals(2, $counter->increment());
        $this->assertEquals(3, $counter->increment());
        // a 4th call of increment() is not allowed by this test
        $this->assertEquals(4, $counter->increment());
    }
}

class Counter
{
    private $count = 0;
    
    public function increment()
    {
        return ++$this->count;
    }
}


Time: 00:00.007, Memory: 4.00 MB

There was 1 failure:

1) ExactlyTest::testCounterCall
Counter::increment() was not expected to be called more than 3 times.

ExactlyTest.php:19

FAILURES!
Tests: 1, Assertions: 0, Failures: 1.

• PHPUnit - Using a value map for mocked functions with more than 1 return value
• Should a PHPUnit mock act like original object? How PHPUnit says "Your code suck"
• How to throw an Exception with a Mock object on method call in PHPUnit

PHP 8.2, Laminas MVC 3.2, Symfony 5.2, Laravel 8.28, PHPUnit 9.5, Doctrine ORM 2.8