Tests: Add a separate PHPUnit configuration file for PHPUnit 10.1 and later

- Add phpunit10.xml.dist and tests/phpunit/multisite10.xml compliant with PHPUnit 10.1+ schema.
- Update reusable-phpunit-tests-v3.yml with automated detection to select the PHPUnit 10+ configuration when running on PHPUnit 10+.
- Fix hardcoded -c phpunit.xml.dist in reusable-phpunit-tests-v1.yml and v2.yml external-http step to use PHPUNIT_CONFIG.
- Update workflow path triggers in phpunit-tests.yml, full matrix, test-coverage, and exclude from asset workflows.
- Add test10 script in composer.json and test:php10 in package.json.
- Add /phpunit10.xml to .gitignore and update configuration documentation in tests/phpunit/README.md.

See #66210, #62004.

Author: robelsust

.github/workflows/end-to-end-tests.yml

@@ -32,6 +32,7 @@ on:
       - '!phpcs.xml.dist'
       - '!phpstan.neon.dist'
       - '!phpunit.xml.dist'
+      - '!phpunit10.xml.dist'
       - '!tsconfig.json'
       # Other test suites, tools, and workflows do not affect these tests.
       - '!tests/**'

.github/workflows/performance.yml

@@ -32,6 +32,7 @@ on:
       - '!phpcs.xml.dist'
       - '!phpstan.neon.dist'
       - '!phpunit.xml.dist'
+      - '!phpunit10.xml.dist'
       - '!tsconfig.json'
       # Other test suites, tools, and workflows do not affect these tests.
       - '!tests/**'

.github/workflows/phpunit-tests-full-matrix.yml

@@ -42,6 +42,7 @@ on:
       - 'tools/vendors/**'
       - 'tools/webpack/**'
       - 'phpunit.xml.dist'
+      - 'phpunit10.xml.dist'
       - '.github/actions/setup-npm/**'
       - '.github/workflows/phpunit-tests.yml'
       - '.github/workflows/phpunit-tests-full-matrix.yml'

.github/workflows/phpunit-tests.yml

@@ -46,6 +46,7 @@ on:
       - 'tools/vendors/**'
       - 'tools/webpack/**'
       - 'phpunit.xml.dist'
+      - 'phpunit10.xml.dist'
       - '.github/actions/setup-npm/**'
       - '.github/workflows/phpunit-tests.yml'
       - '.github/workflows/phpunit-tests-full-matrix.yml'

.github/workflows/reusable-phpunit-tests-v1.yml

@@ -247,4 +247,4 @@ jobs:
 
       - name: Run external HTTP tests
         if: ${{ ! inputs.multisite && ! inputs.split_slow && ! inputs.phpunit-test-groups }}
-        run: npm run "test:${PHPUNIT_SCRIPT}" -- --verbose -c phpunit.xml.dist --group external-http
+        run: npm run "test:${PHPUNIT_SCRIPT}" -- --verbose -c "${PHPUNIT_CONFIG}" --group external-http

.github/workflows/reusable-phpunit-tests-v2.yml

@@ -254,7 +254,7 @@ jobs:
 
       - name: Run external HTTP tests
         if: ${{ ! inputs.multisite && ! inputs.split_slow && ! inputs.phpunit-test-groups }}
-        run: npm run "test:${PHPUNIT_SCRIPT}" -- --verbose -c phpunit.xml.dist --group external-http
+        run: npm run "test:${PHPUNIT_SCRIPT}" -- --verbose -c "${PHPUNIT_CONFIG}" --group external-http
 
       # __fakegroup__ is excluded to force PHPUnit to ignore the <exclude> settings in phpunit.xml.dist.
       - name: Run (xDebug) tests

.github/workflows/reusable-phpunit-tests-v3.yml

@@ -317,6 +317,21 @@ jobs:
             php -m | grep -i pcov
           '
 
+      - name: Select PHPUnit configuration
+        run: |
+          PHPUNIT_VERSION=$(node ./tools/local-env/scripts/docker.js run php ./vendor/bin/phpunit --version | grep -oE '\b[0-9]+\.[0-9]+' | head -n 1)
+          echo "Detected PHPUnit version: ${PHPUNIT_VERSION}"
+          MAJOR_VERSION=$(echo "${PHPUNIT_VERSION}" | cut -d. -f1)
+          if [ "${MAJOR_VERSION}" -ge 10 ]; then
+            if [ "${PHPUNIT_CONFIG}" = "tests/phpunit/multisite.xml" ]; then
+              NEW_CONFIG="tests/phpunit/multisite10.xml"
+            else
+              NEW_CONFIG="phpunit10.xml.dist"
+            fi
+            echo "Using PHPUnit 10+ configuration: ${NEW_CONFIG}"
+            echo "PHPUNIT_CONFIG=${NEW_CONFIG}" >> "$GITHUB_ENV"
+          fi
+
       - name: Run external HTTP tests
         if: ${{ ! inputs.multisite && ! inputs.phpunit-test-groups && ! inputs.coverage-report }}
         continue-on-error: ${{ inputs.allow-errors }}

.github/workflows/test-build-processes.yml

@@ -34,6 +34,7 @@ on:
       - '!phpcs.xml.dist'
       - '!phpstan.neon.dist'
       - '!phpunit.xml.dist'
+      - '!phpunit10.xml.dist'
       - '!tsconfig.json'
       # Tests, unrelated tools, and other workflows do not affect the build.
       - '!tests/**'

.github/workflows/test-coverage.yml

@@ -15,7 +15,9 @@ on:
       - '.nvmrc'
       - 'docker-compose.yml'
       - 'phpunit.xml.dist'
+      - 'phpunit10.xml.dist'
       - 'tests/phpunit/multisite.xml'
+      - 'tests/phpunit/multisite10.xml'
   pull_request:
     branches:
       - trunk
@@ -29,7 +31,9 @@ on:
       - '.nvmrc'
       - 'docker-compose.yml'
       - 'phpunit.xml.dist'
+      - 'phpunit10.xml.dist'
       - 'tests/phpunit/multisite.xml'
+      - 'tests/phpunit/multisite10.xml'
   # Once daily at 00:00 UTC.
   schedule:
     - cron: '0 0 * * *'

.gitignore

@@ -9,6 +9,8 @@ wp-tests-config.php
 # Files and folders related to build/test tools
 .phpunit.result.cache
 /phpunit.xml
+/phpunit10.xml
+/phpunit-10.xml
 /.phpcs.xml
 /phpcs.xml
 .cache/*