Commit 5b69840ec7d for woocommerce
commit 5b69840ec7d46aabe159182cd00a33abf8c9bc2a
Author: Luigi Teschio <gigitux@gmail.com>
Date: Thu Sep 17 14:37:24 2026 +0200
Add PHP 8.3 to PHP unit-test CI coverage (#68474)
* Add PHP 8.3 to PHP unit-test CI coverage
* Add changelog entry for PHP unit-test coverage
* Update documentation
* Retry failed nightly jobs up to three attempts
* Make nightly Slack attempt condition explicit
* Explain shared Slack reporting behavior
* Align E2E PHP coverage across routine and nightly checks
* Preserve Core PHP 8.5 jobs on PR and release checks
* Retry failed nightly jobs up to three attempts
* Align E2E PHP coverage across routine and nightly checks
* Preserve Core PHP 8.5 jobs on PR and release checks
* remove files
diff --git a/docs/contribution/testing/README.md b/docs/contribution/testing/README.md
index a66d6a22c3e..a561e0cc384 100644
--- a/docs/contribution/testing/README.md
+++ b/docs/contribution/testing/README.md
@@ -22,6 +22,10 @@ If you have questions about testing, reach out to the developer community in our
[API tests](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce/tests/e2e/tests/api-tests) are part of the Playwright suite and use the same `wp-env` test environment as end-to-end tests.
+## PHP version coverage
+
+Use the [PHP version guidelines](/docs/contribution/testing/php-version-coverage/) to understand how to choose representative, minimum, and latest PHP versions, and where each belongs in E2E and PHP unit testing.
+
## Testing instructions
When opening a pull request, use the [testing instructions guide](/docs/contribution/testing/writing-high-quality-testing-instructions/) to write clear steps that cover the behavior changed in the PR.
diff --git a/docs/contribution/testing/php-version-coverage.md b/docs/contribution/testing/php-version-coverage.md
new file mode 100644
index 00000000000..24041b29d54
--- /dev/null
+++ b/docs/contribution/testing/php-version-coverage.md
@@ -0,0 +1,15 @@
+---
+post_title: Guidelines for choosing PHP versions in tests
+sidebar_label: PHP version guidelines
+category_slug: testing
+---
+
+# Guidelines for choosing PHP versions in tests
+
+Use [WordPress.org PHP usage statistics](https://wordpress.org/about/stats/) to choose the most widely used version within WooCommerce's supported range for representative coverage. Also test the minimum and latest supported versions. PHP unit tests cover all three roles in routine CI; broader E2E coverage runs nightly to limit CI cost.
+
+| Version choice | Configured PHP | E2E coverage | PHP unit coverage | Why |
+| --- | --- | --- | --- | --- |
+| Representative version | 8.3 | PR, push, release, pre-release, and nightly | PR and push, with latest WordPress | Focus frequent checks on a widely used PHP runtime, using WordPress.org adoption data to guide the choice. |
+| Minimum supported by WooCommerce | 7.4 | Standard Core and Blocks nightly suites | PR and push, with WordPress L-1; optional WordPress pre-release | Preserve minimum-version compatibility through PHP behavior checks and complete user flows. |
+| Latest supported by WooCommerce | 8.5 | Standard Core and Blocks nightly suites; existing Core jobs also run on PR, release, and pre-release | PR and push, with latest WordPress, including HPOS disabled | Catch compatibility problems as merchants adopt newer PHP releases. |
diff --git a/plugins/woocommerce/changelog/dev-add-php-8.3-unit-test-coverage b/plugins/woocommerce/changelog/dev-add-php-8.3-unit-test-coverage
new file mode 100644
index 00000000000..2a42ec9bbc3
--- /dev/null
+++ b/plugins/woocommerce/changelog/dev-add-php-8.3-unit-test-coverage
@@ -0,0 +1,5 @@
+Significance: patch
+Type: dev
+Comment: Add PHP 8.3 coverage to the PHP unit-test CI configuration.
+
+
diff --git a/plugins/woocommerce/package.json b/plugins/woocommerce/package.json
index 3c9ac2572d6..c4310edd034 100644
--- a/plugins/woocommerce/package.json
+++ b/plugins/woocommerce/package.json
@@ -176,6 +176,35 @@
"php-unit-php-8.5-wp-latest"
]
},
+ {
+ "name": "PHP: 8.3 WP: latest",
+ "testType": "unit:php",
+ "command": "test:php:env",
+ "shardingArguments": [],
+ "onlyForDependencies": [],
+ "changes": [
+ "client/admin/config/*.json",
+ "client/blocks/packages/public-api/blocks-checkout/utils/validation/test/postcode-validation-fixtures.json",
+ "i18n/postcode-validation-rules.json",
+ "composer.json",
+ "composer.lock",
+ "**/*.php",
+ ".wp-env.test.json",
+ "phpunit.xml"
+ ],
+ "testEnv": {
+ "start": "env:test --debug",
+ "config": {
+ "phpVersion": "8.3",
+ "wpVersion": "latest"
+ }
+ },
+ "events": [
+ "pull_request",
+ "push",
+ "php-unit-php-8.3-wp-latest"
+ ]
+ },
{
"name": "PHP: 7.4 WP: latest - 1",
"testType": "unit:php",