Exclude internal PHPStan stubs from distribution archives

[Copilot]

WP-CLI ships utils/phpstan/scan-files.php, which declares a partial global wpdb stub. When downstream PHPStan runs scan installed vendor trees, that stub can shadow fuller WordPress definitions and trigger false positives such as Call to an undefined method wpdb::get_col().

• What changed

  • Marked the internal utils/phpstan/ directory as export-ignore in .gitattributes.
  • This keeps WP-CLI’s internal PHPStan helper files out of distribution archives without changing runtime code or the internal analysis setup used in this repository.

• Why this addresses the issue

  • Installed package contents no longer include the partial wpdb stub.
  • Downstream projects can rely on WordPress core or dedicated WordPress stubs instead of inheriting WP-CLI’s internal analysis-only definitions.

• Archive rule

  /utils/phpstan export-ignore
  /utils/phpstan/** export-ignore

• Effect on consumers

  global $wpdb;
  
  $ids = $wpdb->get_col( 'SELECT ID FROM wp_posts' );

  This no longer picks up WP-CLI’s incomplete wpdb stub from utils/phpstan/scan-files.php in distributed installs.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

This PR prevents WP-CLI’s internal PHPStan helper stubs (notably the partial wpdb stub) from being included in distribution archives, reducing the risk of downstream PHPStan false-positives when scanning installed vendor trees.

Changes:

• Added export-ignore rules for utils/phpstan/ so it’s excluded from generated distribution archives.
• Leaves runtime behavior unchanged while keeping internal analysis-only files out of consumer installs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.