Description

Fixes #7119
Nothing impacts users.

Type of change

• Enhancement (non-breaking change which improves an existing functionality).

Detailed scenario

n/a

Technical description

Documentation

This pull request introduces several changes to enhance PHPStan integration and adds a new custom rule for validating @param tags in docblocks. The most important changes include adding a new script to reset the PHPStan baseline, updating the PHPStan configuration files, and implementing a custom PHPStan rule.

Enhancements to PHPStan integration:

• composer.json: Added a new script run-stan-reset-baseline to reset the PHPStan baseline.
• phpstan-baseline.neon: Added baseline configurations to ignore specific errors in certain files.
• phpstan.neon.dist: Updated the parameters section to include a new directory and added the custom rule WP_Rocket\Tests\phpstan\Rules\ApplyFiltersTypedDynamicFunctionReturnTypeExtension. [1] [2]

Implementation of a custom PHPStan rule:

• tests/phpstan/Rules/ApplyFiltersTypedDynamicFunctionReturnTypeExtension.php: Added a new custom rule to validate @param tags in docblocks for the wpm_apply_filters_typed function.

Mandatory Checklist

Code validation

• I validated all the Acceptance Criteria. If possible, provide screenshots or videos.
• I triggered all changed lines of code at least once without new errors/warnings/notices.
• I implemented built-in tests to cover the new/changed code.

Code style

• I wrote a self-explanatory code about what it does.
• I protected entry points against unexpected inputs.
• I did not introduce unnecessary complexity.