Upgrade PHPUnit to 11.x and reconcile with host unit-test tier (XWPENG-43)

[shadyvb]

Fixes XWPENG-43.

This PR upgrades the test toolchain to PHPUnit 11 and aligns it with the host unit suite introduced in XWPENG-42. Production refactors from XWPENG-42 are not part of the XWPENG-43 commit—they are already on this branch as prior commits (see below). Together, XWPENG-42 + XWPENG-43 form the combined stack on ticket/XWPENG-43-phpunit-11.

Summary

• PHPUnit 9.6 → 11.5 with Solution Add special support for Settings Revisions #3 shim for expectDeprecated() on WP_StreamTestCase (PHPUnit 11 removed it; trait restores deprecated-expectation behavior where needed).
• Reconciled with XWPENG-42: phpunit-unit.xml on PHPUnit 11 schema; Connectors_Unit_Test / Query_Unit_Test updated with #[DataProvider] attributes.
• Test discovery: phpunit.xml / integration configs use suffix="Test.php"; ~58 integration test files renamed; removed WP_Stream_ prefix from class names (ability tests live in namespace WP_Stream, e.g. Ability_Create_Alert_Test).
• Connector integration tests: removed Mock_Call_Recorder; expectations use split once()->with() (and named static record_log_call callbacks where multiple log entries must be matched in order).
• Parity fixes (post-review): ACF save_post expectations; Mercator make_primary(); Users get_password_reset_key() multi-log scenarios via per-class static record_log_call helpers.
• Multisite fix: ensure_mercator_mapping_table() in testcase—Admin ajax tests left stale mercator.db.version without creating the mapping table, polluting Mercator connector tests.
• Cleanup: removed dead wp_stream_preload_coverage_sources() and tests/phpunit/class-mock-call-recorder.php.
• Tooling: Composer config.platform 8.2, Docker PHP 8.2 default, switch-to:php7.4 build args, contributing.md corrections.
• Filter_Input_Test: expectException() + #[WithoutErrorHandler] on the regex validation test.

Commits on this PR (develop..HEAD)

Commit	Description
a5dbc77d	XWPENG-42 — Host PHPUnit unit suite; Connectors load/register pipeline (production + unit tests).
c3c62d49	XWPENG-42 — Query SQL fragment refactor for unit testing (production + unit tests).
aeaf5d98	XWPENG-43 — PHPUnit 11 migration, test renames, connector expectation refactor, tooling, parity fixes.

NOT in the XWPENG-43 commit: Query/Connectors production refactors above—they ship on the same branch because the branch was built on top of XWPENG-42 work.

Breaking / acceptance criteria notes

• Jira AC amended: PHP 8.2+ required for the test toolchain (not 8.0/8.1).
• config.platform 8.2; plugin Requires PHP remains 7.2 (tracked separately as XWPENG-46).
• Integration suites: relaxed failOnWarning / failOnNotice; scoped WithoutErrorHandler where WordPress emits expected noise.
• No CI “423 guard” (declined for this effort).

Gotchas

• Polyfills alias PHPUnit 4.0.0 as 1.1.5 for wp-test-utils compatibility.
• @group annotations remain on integration tests.
• EDD connector anonymous closure is pre-existing and unchanged.

Test plan

• composer test-unit — 53 tests, exit 0
• npm run test — 53 unit + 423 single-site + 423 multisite integration, all exit 0
• composer lint and lint-tests pass
• Spot-check connector tests (ACF, Mercator, Users) for ordered multi-log expectations after Mock_Call_Recorder removal

Checklist

• Project documentation has been updated to reflect the changes in this pull request, if applicable.
• I have tested the changes in the local development environment (see contributing.md).
• I have added phpunit tests.

Release Changelog

• Fix: N/A (developer tooling / test infrastructure).
• New: N/A.

Release Checklist

• This pull request is to the master branch.
• Release version follows semantic versioning. Does it include breaking changes?
• Update changelog in readme.txt.
• Bump version in stream.php.
• Bump Stable tag in readme.txt.
• Bump version in classes/class-plugin.php.
• Draft a release on GitHub.

[Copilot]

Pull request overview

Upgrades the test stack to PHPUnit 11/PHP 8.2 and modernizes integration-test discovery, mocks, and fixtures.

Changes:

• Migrates PHPUnit configuration, data providers, and deprecated API shims.
• Renames and restructures integration tests for suffix-based discovery.
• Updates Docker, Composer, CI, and contributor tooling for PHP 8.2.

Review assessment:

• High: the split editor tests can leak hooks because their teardown omits the parent teardown.
• Medium: three settings tests no longer reject duplicate audit logs.

Reviewed changes

Copilot reviewed 79 out of 81 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
.github/workflows/lint-and-test.yml	Uses PHP 8.2 in CI.
.gitignore	Ignores PHPUnit 11 cache.
composer.json	Upgrades PHPUnit and platform requirements.
contributing.md	Documents PHP 8.2 testing requirements.
docker-compose.build.yml	Updates PHP 8.2 image arguments.
local/docker/wordpress/Dockerfile	Makes PHP 8.2/Xdebug 3.3 defaults.
package.json	Adds explicit PHP 7.4 build arguments.
phpunit-multisite.xml	Migrates multisite configuration to PHPUnit 11.
phpunit-unit.xml	Migrates unit-suite configuration and discovery.
phpunit.xml	Migrates integration configuration and discovery.
tests/bootstrap.php	Loads renamed test base classes.
tests/phpcs.xml.dist	Permits new test filenames.
tests/testcase.php	Adds Mercator recovery and deprecation shim.
tests/phpunit/Abilities_Test.php	Renames the test class.
tests/phpunit/Ability_Test.php	Renames the test class.
tests/phpunit/Admin_Cron_Purge_Test.php	Renames the test class and references.
tests/phpunit/Admin_Test.php	Renames the test class.
tests/phpunit/Alert_Test.php	Renames the test class.
tests/phpunit/Alert_Trigger_TestCase.php	Renames the abstract alert base.
tests/phpunit/Alerts_List_Test.php	Renames the test class.
tests/phpunit/Alerts_Test.php	Renames the test class.
tests/phpunit/Author_Test.php	Renames the test class.
tests/phpunit/CLI_Test.php	Replaces an anonymous filter callback.
tests/phpunit/Connector_Test.php	Renames the test class.
tests/phpunit/Connectors_Test.php	Renames the test class.
tests/phpunit/Cron_Scheduler_Test.php	Renames the test class.
tests/phpunit/DB_Driver_WPDB_Test.php	Renames the test class.
tests/phpunit/DB_Test.php	Renames the test class.
tests/phpunit/Date_Interval_Test.php	Renames the test class.
tests/phpunit/Export_Test.php	Renames the test class.
tests/phpunit/Exporter_CSV_Test.php	Renames the test class.
tests/phpunit/Exporter_JSON_Test.php	Renames the test class.
tests/phpunit/Filter_Input_Test.php	Uses current exception and error-handler APIs.
tests/phpunit/Functions_Test.php	Renames the test class.
tests/phpunit/Live_Update_Test.php	Renames the test class.
tests/phpunit/Log_Test.php	Renames the test class.
tests/phpunit/Network_Test.php	Renames the test class and documentation.
tests/phpunit/Plugin_Test.php	Renames the test class.
tests/phpunit/Scheduler_Handoff_Test.php	Renames the test class.
tests/phpunit/Scheduler_Selection_Test.php	Renames the test class.
tests/phpunit/fake-ability.php	Updates the referenced test name.
tests/phpunit/abilities/Abilities_REST_Integration_Test.php	Renames the class and updates expected-usage handling.
tests/phpunit/abilities/Ability_Create_Alert_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Create_Exclusion_Rule_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Delete_Alert_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Get_Alerts_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Get_Connectors_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Get_Exclusion_Rules_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Get_Record_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Get_Records_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Get_Settings_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Purge_Records_Test.php	Renames the test class.
tests/phpunit/abilities/Ability_Update_Settings_Test.php	Renames the class and reference.
tests/phpunit/alerts/Alert_Trigger_Action_Test.php	Uses the renamed alert base class.
tests/phpunit/alerts/Alert_Trigger_Author_Test.php	Uses the renamed alert base class.
tests/phpunit/alerts/Alert_Trigger_Context_Test.php	Uses the renamed alert base class.
tests/phpunit/connectors/Connector_ACF_Test.php	Modernizes ordered ACF log assertions.
tests/phpunit/connectors/Connector_Blogs_Test.php	Splits multisite connector scenarios.
tests/phpunit/connectors/Connector_Comments_Test.php	Splits comment and reply scenarios.
tests/phpunit/connectors/Connector_EDD_Test.php	Splits EDD logging scenarios.
tests/phpunit/connectors/Connector_Editor_Test.php	Splits theme and plugin editor tests.
tests/phpunit/connectors/Connector_GravityForms_Test.php	Recreates tests with PHPUnit 11 callbacks.
tests/phpunit/connectors/Connector_Installer_Test.php	Replaces consecutive-call expectations.
tests/phpunit/connectors/Connector_Jetpack_Test.php	Recreates and splits Jetpack tests.
tests/phpunit/connectors/Connector_Media_Test.php	Splits attachment-parent scenarios.
tests/phpunit/connectors/Connector_Menus_Test.php	Splits menu assignment scenarios.
tests/phpunit/connectors/Connector_Mercator_Test.php	Modernizes ordered Mercator assertions.
tests/phpunit/connectors/Connector_Posts_Test.php	Recreates and splits post-transition tests.
tests/phpunit/connectors/Connector_Settings_Test.php	Splits settings and redaction scenarios.
tests/phpunit/connectors/Connector_Taxonomies_Test.php	Modernizes taxonomy context assertions.
tests/phpunit/connectors/Connector_Two_Factor_Test.php	Renames the test class.
tests/phpunit/connectors/Connector_User_Switching_Test.php	Updates class and mock APIs.
tests/phpunit/connectors/Connector_Users_Test.php	Splits and modernizes user log assertions.
tests/phpunit/connectors/Connector_WordPress_SEO_Test.php	Renames the test class.
tests/phpunit/connectors/test-class-connector-blogs.php	Removes the legacy Blogs test file.
tests/phpunit/connectors/test-class-connector-gravityforms.php	Removes the legacy Gravity Forms test file.
tests/phpunit/connectors/test-class-connector-jetpack.php	Removes the legacy Jetpack test file.
tests/phpunit/connectors/test-class-connector-posts.php	Removes the legacy Posts test file.
tests/phpunit/unit/Connectors_Unit_Test.php	Adds PHPUnit 11 data-provider attributes.
tests/phpunit/unit/Query_Unit_Test.php	Adds PHPUnit 11 data-provider attributes.

Suppressed comments (4)

tests/phpunit/connectors/Connector_Editor_Test.php:89

• Splitting this into a second test leaves the first test's mocked connector registered: this class's tearDown() restores the fixture file but never calls parent::tearDown(), so WordPress's hook snapshot is not restored. The second AJAX action can therefore invoke the previous mock's already-satisfied once() expectation and fail depending on execution order. Update the existing teardown to call parent::tearDown() after restoring the file.
  tests/phpunit/connectors/Connector_Settings_Test.php:107
• The original combined test required exactly one log per option update; atLeastOnce() now allows duplicate audit records to pass unnoticed. Preserve that contract with once() for this single update.

This issue also appears in the following locations of the same file:

• line 141
• line 175
  tests/phpunit/connectors/Connector_Settings_Test.php:141

• The original combined test required exactly one log per option update; atLeastOnce() now allows duplicate audit records to pass unnoticed. Preserve that contract with once() for this single update.
  tests/phpunit/connectors/Connector_Settings_Test.php:175
• The original combined test required exactly one log per option update; atLeastOnce() now allows duplicate audit records to pass unnoticed. Preserve that contract with once() for this single update.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.