qratorlabs/smocky-phpunit

Extension to wire up Smocky and PHPUnit

2.0.3 2025-03-21 09:07 UTC

Requires

• php: ^8.0
• phpunit/phpunit: ^12.0.9
• qratorlabs/smocky: ^1.2

Requires (Dev)

• phpstan/phpstan: ^2.1
• squizlabs/php_codesniffer: ^3.12

MIT

• Ilia Urvachev

README

This is a helper library-helper for QratorLabs\Smocky that allows you to use Smocky and PHPUnit together with less boilerplate code.

Installation

composer require --dev "qratorlabs/smocky-phpunit:^1.0||^2.0"

Versioning

This library follows SemVer. But major versions are used to indicate compatibility with PHPUnit versions:

• 1.x is compatible with PHPUnit 9.6...12.0.8
• 2.x is compatible with PHPUnit 12.0.9...

Usage

To use with PHPUnit:

• MockedMethod to mock method "globally" and use PHPUnit's *Mockers - expects/willReturn/willReturnCallback/...
• MockedFunction

MockedMethod

The main target is to make mocking static methods easy and feels-n-looks like using PHPUnit.

public function testSomeTest(): void {
    $methodMock = new MockedMethod($this, SomeClass::class, 'someMethod', once());
    $methodMock->getMocker()->willReturn(10);

    SomeClass::someMethod(); // will return `10`
    
    SomeClass::someMethod(); // will cause error (expectation - one call)
}