Overview
Psalm is a static analysis tool for PHP. It inspects code paths and type information to report possible defects without running the application.
Configure the project
Install Psalm as a development dependency, initialize configuration and define source directories. Review the generated configuration rather than accepting broad exclusions without understanding them.
Improve type information
Add accurate parameter and return types, document array shapes where useful and narrow nullable values before use. More precise types help both maintainers and analysis tools.
Manage suppressions
When dynamic behavior or a third-party API requires an exception, keep it narrow and explain why it is safe. Avoid globally suppressing a class of findings.
Compare tools thoughtfully
PHPStan and Psalm overlap but have different analysis models and ecosystems. A team should evaluate signal quality, framework support, runtime and developer workflow before deciding whether to use one or both.