Skip to content

Exclude the wp-compat false positive from the PHPStan config - #162

Merged
swissspidy merged 1 commit into
mainfrom
fix/phpstan-wp-compat
Aug 26, 2026
Merged

Exclude the wp-compat false positive from the PHPStan config#162
swissspidy merged 1 commit into
mainfrom
fix/phpstan-wp-compat

Conversation

@swissspidy

@swissspidy swissspidy commented Aug 26, 2026

Copy link
Copy Markdown
Member

The johnbillion/wp-compat PHPStan extension that now ships with wp-cli-tests checks every WordPress symbol against the WordPress 4.9 baseline that wp-cli-tests configures. It reported exactly one error here, and it is a false positive.

Where Reported Why it is a false positive
inc/Runner.php:115 Parameter $arg of do_action() is only available since WordPress version 5.3.0 WordPress 5.3 only "formalized the existing and already documented ...$arg parameter by adding it to the function signature". Before that, do_action() collected additional arguments through func_get_args(), so passing the WP_REST_Server instance to rest_api_init has always worked

Ignored by error identifier and path. No message scoping was needed: WPCompat.parameterNotAvailable.doaction.arg already names one specific parameter of one specific function, so the entry cannot swallow an unrelated diagnostic.

This adds the ignoreErrors key to phpstan.neon.dist, which did not have one.

No source changes: nothing here is an actual compatibility problem.

Verification

Run locally against the same dependency versions CI resolves (johnbillion/wp-compat 2.0.0, php-stubs/wordpress-stubs v6.9.4, wp-cli/wp-cli-tests v5.2.3):

  • composer phpstan[OK] No errors, with no unmatched ignore entries
  • As a control, adding a deliberately dead ignore entry does produce an ignore.unmatched error, confirming the entry above matches a real error rather than sitting there unused

GitHub Actions was failing to allocate runners across the org while this was written, so CI may need a re-run once that clears.


Generated by Claude Code

Summary by CodeRabbit

  • Chores
    • Updated static analysis configuration to account for a known WordPress compatibility warning.
    • Added documentation explaining the compatibility exception.

The johnbillion/wp-compat extension that comes with wp-cli-tests checks every
WordPress symbol against the WordPress 4.9 baseline that wp-cli-tests
configures. It reported a single error, and it is a false positive: WordPress
5.3 merely formalized the already documented `...$arg` parameter of
`do_action()` by adding it to the function signature, so passing the server
instance to `rest_api_init` has always worked.

Co-authored-by: Pascal Birchler <pascal.birchler@gmail.com>
@swissspidy
swissspidy requested a review from a team as a code owner August 26, 2026 07:56
Copilot AI lite review requested due to automatic review settings August 26, 2026 07:56

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Aug 26, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: ff8b4a02-bce4-4d86-8da9-b6bccb9e72ee

📥 Commits

Reviewing files that changed from the base of the PR and between e3c9e80 and 7174689.

📒 Files selected for processing (1)
  • phpstan.neon.dist

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.


📝 Walkthrough

Walkthrough

PHPStan configuration now suppresses the targeted WordPress compatibility warning for the do_action variadic argument in inc/Runner.php. Comments document the historical argument behavior.

Changes

PHPStan compatibility configuration

Layer / File(s) Summary
Targeted do_action warning suppression
phpstan.neon.dist
Adds a targeted WPCompat.parameterNotAvailable.doaction.arg suppression and documents the historical do_action() argument behavior.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to 71746

This localized PHPStan configuration change suppresses one documented false positive without changing runtime or product behavior; no actionable merge-blocking risk remains after normal checks and review.

Suggested reviewers: brianhenryie

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: excluding a WordPress compatibility false positive from the PHPStan configuration.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/phpstan-wp-compat

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added automated-pr scope:testing Related to testing labels Aug 26, 2026
@swissspidy swissspidy added this to the 0.4.3 milestone Aug 26, 2026
@swissspidy
swissspidy merged commit 7b6b762 into main Aug 26, 2026
64 checks passed
@swissspidy
swissspidy deleted the fix/phpstan-wp-compat branch August 26, 2026 08:07
@codecov

codecov Bot commented Aug 26, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants