feat: upgrade PHPUnit to v12, min. PHP to v8.3+

.github/workflows/docs.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          php-version: 8.3
           tools: composer:v2, phpdoc
       - name: Install dependencies
         run: composer install --prefer-dist --no-progress

.github/workflows/php.yml

@@ -16,7 +16,6 @@ jobs:
     strategy:
       matrix:
         php:
-          - '8.2'
           - '8.3'
           - '8.4'
 
@@ -28,6 +27,7 @@ jobs:
       with:
         php-version: ${{ matrix.php }}
         tools: composer:v2
+        coverage: xdebug
     - name: Validate composer.json and composer.lock
       run: composer validate --strict
     - name: Cache Composer packages
@@ -47,4 +47,4 @@ jobs:
       with:
         token: ${{ secrets.CODECOV_TOKEN }}
         verbose: true
-        files: coverage.xml
+        files: .phpunit/coverage.xml

.gitignore

@@ -5,22 +5,31 @@ vendor/
 # NPM
 node_modules/
 
-# user-configured files
 # PHPUnit
+.phpunit/
 phpunit.xml
 .phpunit.xml
 .phpunit.cache
 .phpunit.result.cache
 
+## PHPUnit code coverage
+coverage
+coverage.*
+clover.xml
+crap4j.xml
+html-coverage/
+coverage.php
+coverage.txt
+xml-coverage/
+
 # phpDocumentor
 .phpdoc
 phpdoc.xml
 docs/build/
 docs/cache/
 
-# code coverage
-coverage
-coverage.*
+# PHPStorm
+.idea
 
 # PHPActor LSP
 .phpactor.json

README.md

@@ -10,7 +10,7 @@ This repository makes it easier to develop a PHP application or library by provi
 
 ## Features
 
-- [x] [PHP 8.2+](https://www.php.net/releases/8.2/en.php) support
+- [x] [PHP 8.3+](https://www.php.net/releases/8.3/en.php) support
 - [x] *Unit testing* with [PHPUnit](https://github.com/sebastianbergmann/phpunit/) ([official website](https://phpunit.de/))
 - [x] Validates PHP syntax with [php-parallel-lint](https://github.com/php-parallel-lint/PHP-Parallel-Lint)
 - [x] Lint and auto-format PHP code with [PHP CodeSniffer](https://github.com/squizlabs/PHP_CodeSniffer) (PHPCS)
@@ -48,7 +48,7 @@ Delete this `README.md`, and rename [`LIBRARY.md`](./LIBRARY.md) to `README.md`.
 | ---- | ---- | ------------- |
 | Composer package | [`composer.json`](./composer.json) | [docs](https://getcomposer.org/doc/04-schema.md), [website](https://getcomposer.org/), [repo](https://github.com/composer/composer) |
 | PHPCS (formatter + linter) | [`.phpcs.xml`](./.phpcs.xml) | [docs](https://github.com/squizlabs/PHP_CodeSniffer/wiki/Advanced-Usage#using-a-default-configuration-file), [repo](https://github.com/squizlabs/PHP_CodeSniffer) |
-| PHPUnit (unit testing) | [`.phpunit.xml.dist`](./.phpunit.xml.dist) | [docs](https://phpunit.readthedocs.io/en/11.5/configuration.html), [website](https://phpunit.de/), [repo](https://github.com/sebastianbergmann/phpunit) |
+| PHPUnit (unit testing) | [`phpunit.xml.dist`](./phpunit.xml.dist) | [docs](https://phpunit.readthedocs.io/en/12.0/configuration.html), [website](https://phpunit.de/), [repo](https://github.com/sebastianbergmann/phpunit) |
 | phpdoc (documentation generator) | [`phpdoc.dist.xml`](./phpdoc.dist.xml) | [docs](https://docs.phpdoc.org/3.0/guide/references/configuration.html), [website](https://www.phpdoc.org/), [repo](https://github.com/phpdocumentor/phpdocumentor) |
 | Dependabot | [`.github/dependabot.yml`](./.github/dependabot.yml) | [docs](https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file), [website](https://github.com/dependabot) |
 

composer.json

@@ -15,22 +15,25 @@
 		}
 	},
 	"require": {
-		"php": ">=8.2"
+		"php": ">=8.3"
 	},
 	"require-dev": {
 		"mediawiki/mediawiki-codesniffer": "46.0.0",
 		"mediawiki/minus-x": "1.1.3",
 		"php-parallel-lint/php-parallel-lint": "1.4.0",
 		"php-parallel-lint/php-console-highlighter": "1.0.0",
-		"phpunit/phpunit": "11.5.6"
+		"phpunit/phpunit": "12.0.3"
 	},
 	"scripts": {
 		"test": [
 			"parallel-lint . --exclude vendor --exclude node_modules",
-			"./vendor/bin/phpunit tests",
+			"@phpunit:xml",
 			"minus-x check .",
 			"phpcs -p -s"
 		],
+		"phpunit": "phpunit tests",
+		"phpunit:xml": "@phpunit --coverage-clover .phpunit/coverage.xml",
+		"phpunit:html": "@phpunit --coverage-html .phpunit/html/",
 		"fix": [
 			"minus-x fix .",
 			"phpcbf"