PHPStan is a static code analysis tool for php, you can find out more about it here.
This repository provides an extension so that it also understands code that uses the Prophecy library to fake objects in unit tests. So far it covers two use cases:
$prophecy = $prophet->prophesize(SomeModel::class);
$instance = $prophecy->reveal();
It will help PHPStan to understand that the $instance
variable is indeed an instance of SomeClass
.
$prophecy = $prophet->prophesize(Calculator::class);
$prophecy->doubleTheNumber(Argument::is(2))->willReturn(5);
$instance = $prophecy->reveal();
$instance->doubleTheNumber(2); // Will return 5
It will also help PHPStan to understand that $prophecy
accepts method calls to all methods that are implemented by its prophesized class.
HINT: Currently there are no checks in place to validate the arguments of methods that are being called on prophecies.
Install via composer (no release available yet):
composer require --dev jangregor/phpstan-prophecy
And then make sure to add the extension to your phpstan.neon
file:
includes:
- vendor/jangregor/phpstan-prophecy/src/extension.neon
And you should be good to go. Happy testing!