Skip to content

Upgrading vimeo/psalm 4 to 5

Breaking4.30.0 → 5.26.1Breaking23Platform1Deprecated4New137Changed77Fixed531Other205

Full comparisonBack to vimeo/psalm
Fetching 45 releases from GitHub…44 / 45
BreakingUpgrade verdict

23 breaking changes and a platform requirement change.

In plain terms
  • Psalm no longer enforces consistency of PHP version settings.
  • The TEmpty type is no longer available.
  • The allowPhpstormGenerics setting is no longer supported.
  • The exitFunctions setting is no longer available.
Must act Top 5 of 28 that need code or config changes

PHP requirement changed in 5.14.0: ^7.1|^8 → ^7.4 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0.

What you must change

Breaking23
Removes Php version consistency handling.
5.0.0GitHub ReleaseSummarizedView source
Removes the TEmpty type.
TEmpty
5.0.0GitHub ReleaseSummarizedView source
Removes support for the allowPhpstormGenerics option.
allowPhpstormGenerics
5.0.0GitHub ReleaseSummarizedView source
Removes exitFunctions configuration for Psalm 5.
exitFunctions
5.0.0GitHub ReleaseSummarizedView source
Drops legacy procedural files.
5.0.0GitHub ReleaseSummarizedView source
Drops removed config entries.
5.0.0GitHub ReleaseSummarizedView source
Drops the legacy plugin API.
5.0.0GitHub ReleaseSummarizedView source
Drops deprecated CodeIssue methods.
CodeIssue
5.0.0GitHub ReleaseSummarizedView source
Drops deprecated DocComment methods.
DocComment
5.0.0GitHub ReleaseSummarizedView source
Drops the THtmlEscapedString type.
THtmlEscapedString
5.0.0GitHub ReleaseSummarizedView source
Drops an orphaned token.
5.0.0GitHub ReleaseSummarizedView source
Removes the forbidEcho option.
forbidEcho
5.0.0GitHub ReleaseSummarizedView source
Removes the TPositiveInt type.
TPositiveInt
5.0.0GitHub ReleaseSummarizedView source
Removes the totallyTyped configuration option.
totallyTyped
5.0.0GitHub ReleaseSummarizedView source
Removes the @psalm-generator-return annotation.
@psalm-generator-return
5.0.0GitHub ReleaseSummarizedView source
Drops deprecated TypeAnalyzer methods.
TypeAnalyzer
5.0.0GitHub ReleaseSummarizedView source
Locks event classes.
5.0.0GitHub ReleaseSummarizedView source
Finalizes and internalizes more classes.
5.0.0GitHub ReleaseSummarizedView source
Finalizes issue classes.
5.0.0GitHub ReleaseSummarizedView source
Finalizes storage classes.
5.0.0GitHub ReleaseSummarizedView source
Finalizes virtual node classes.
5.0.0GitHub ReleaseSummarizedView source
Finalizes type node classes.
5.0.0GitHub ReleaseSummarizedView source
Moves getPsalmHelpText() to Cli\Psalm.
getPsalmHelpText()Cli\Psalm
5.0.0GitHub ReleaseSummarizedView source
Platform1
Raises the minimum required version of nikic/php-parser to 4.17.
nikic/php-parser
5.26.0GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated4
Deprecates FunctionLikeStorage::$unused_docblock_params.
FunctionLikeStorage::$unused_docblock_params
5.7.0GitHub ReleaseSummarizedView source
Shows a deprecation message when loading php-ext stubs without declaring them as a dependency or in a config.
5.3.0GitHub ReleaseSummarizedView source
Defers cache directory creation until it is actually needed.
5.1.0GitHub ReleaseSummarizedView source
Deprecates the totallyTyped configuration option.
totallyTyped
5.0.0-beta1GitHub ReleaseSummarizedView source