psalm / plugin-phpunit

0.21.1 2026-10-20 11:28 UTC

Requires

• php: >=8.1
• ext-simplexml: *
• psalm/psalm-plugin-api: ^0.4

Requires (Dev)

• php: ^7.3 || ^8.0
• phpunit/phpunit: ^10.0 || ^11.0 || ^12.0
• squizlabs/php_codesniffer: ^3.3.1
• vimeo/psalm: ^7|dev-master
• weirdan/prophecy-shim: ^1.0 || ^2.0

Conflicts

• phpspec/prophecy: <1.20.0
• phpspec/prophecy-phpunit: <2.3.0
• phpunit/phpunit: <8.5.1

MIT

• Matt Brown

Published on Packagist.org on 2026-10-20 12:29 UTC

README

A Psalm plugin for PHPUnit (requires Psalm v4+).

What it does

Psalm does not understand PHPUnit conventions on its own. This plugin makes Psalm aware of them, so static analysis of your test suite stops flooding you with false positives.

Features

• Silences false MissingConstructor on stateful test cases. Properties initialized in setUp() or a @before / #[Before] method are recognized as initialized.
• Validates data providers. It checks that a referenced provider exists, returns an iterable (array, generator, or object), and that each dataset shape matches the parameters of the test method it feeds (types, count, optional offsets, variadic params, defaults).
• Reports broken providers. Missing providers, wrong return types, mismatched dataset types, and providers returning null are flagged before the suite ever runs.
• Fixes unused-code detection for tests. Test methods, providers referenced from docblocks or attributes, and TestCase descendants are no longer reported as unused, while genuinely dead test helpers still are.
• Types prophesize(). $this->prophesize(Foo::class) is inferred as ObjectProphecy<Foo>, so calls on the prophecy are type-checked.

Installation

composer require --dev psalm/plugin-phpunit
vendor/bin/psalm-plugin enable psalm/plugin-phpunit