Refresh PHP 8.0 docs and CI

Author: SbWereWolf

.github/workflows/coverage.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [ main ]
+    branches: [ php8.0 ]
   pull_request:
-    branches: [ main ]
+    branches: [ php8.0 ]
 
 jobs:
   tests:
@@ -15,10 +15,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Setup PHP 8.3 with Xdebug
+      - name: Setup PHP 8.0 with Xdebug
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.3'
+          php-version: '8.0'
           tools: composer:v2
           coverage: xdebug
 
@@ -45,6 +45,8 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage.xml
+          flags: php8.0
+          name: php8.0
           fail_ci_if_error: true
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/static-analysis.yml

@@ -0,0 +1,32 @@
+name: Static Analysis
+
+on:
+  push:
+    branches: [ php8.0 ]
+  pull_request:
+    branches: [ php8.0 ]
+
+jobs:
+  phpstan:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP 8.0
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.0'
+          tools: composer:v2
+          coverage: none
+
+      - name: Validate composer.json
+        run: composer validate --strict
+
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-interaction --no-progress
+
+      - name: Run PHPStan
+        run: composer phpstan-check

README.md

@@ -1,9 +1,8 @@
 # XmlExtractKit
 
-[![Packagist Version](https://img.shields.io/packagist/v/sbwerewolf/xml-navigator?label=packagist)](https://packagist.org/packages/sbwerewolf/xml-navigator)
-[![Packagist Downloads](https://img.shields.io/packagist/dt/sbwerewolf/xml-navigator)](https://packagist.org/packages/sbwerewolf/xml-navigator)
-[![PHP 8.3+](https://img.shields.io/badge/PHP-8.3%2B-777BB4)](https://www.php.net/)
-[![Test Coverage](https://codecov.io/github/SbWereWolf/xml-navigator/graph/badge.svg?token=Q0BQ2COFTC)](https://codecov.io/github/SbWereWolf/xml-navigator)
+[![PHP 8.0-8.2](https://img.shields.io/badge/PHP-8.0--8.2-777BB4)](https://www.php.net/)
+[![Static Analysis](https://github.com/SbWereWolf/xml-navigator/actions/workflows/static-analysis.yml/badge.svg?branch=php8.0)](https://github.com/SbWereWolf/xml-navigator/actions/workflows/static-analysis.yml?query=branch%3Aphp8.0)
+[![Test Coverage](https://codecov.io/github/SbWereWolf/xml-navigator/graph/badge.svg?token=Q0BQ2COFTC&branch=php8.0)](https://codecov.io/github/SbWereWolf/xml-navigator/tree/php8.0)
 
 
 **XmlExtractKit for PHP: Stream large XML, extract only what matters,
@@ -19,7 +18,7 @@ large XML → selected nodes → plain PHP arrays
 composer require sbwerewolf/xml-navigator
 ```
 
-For local test and coverage dependencies on a standard PHP 8.3 setup,
+For local test, coverage, and static-analysis dependencies for this branch,
 see [`tests/ENVIRONMENT.md`](tests/ENVIRONMENT.md).
 
 ## Why this package?
@@ -151,7 +150,7 @@ array (
 
 ## Code test coverage
 
-![Codecov graph](https://codecov.io/github/SbWereWolf/xml-navigator/graphs/tree.svg?token=Q0BQ2COFTC)
+![Codecov graph](https://codecov.io/github/SbWereWolf/xml-navigator/graphs/tree.svg?token=Q0BQ2COFTC&branch=php8.0)
 
 
 ## Working examples

composer.json

@@ -43,11 +43,13 @@
   "scripts": {
     "test": "php ./vendor/phpunit/phpunit/phpunit --configuration ./continuous-integration/phpunit/phpunit.xml --testdox --colors=always",
     "test-coverage": "php -d xdebug.mode=coverage ./vendor/phpunit/phpunit/phpunit --configuration ./continuous-integration/phpunit/phpunit.xml --testdox --colors=always --coverage-html ./continuous-integration/autotests-coverage-report --coverage-filter ./src",
+    "phpstan-check": "php ./vendor/bin/phpstan analyse -vvv --configuration continuous-integration/phpstan/phpstan.neon",
     "check-style": "php ./vendor/bin/phpcs --standard=continuous-integration/phpcs/phpcs.xml -v",
     "fix-style": "php ./vendor/bin/phpcbf --standard=continuous-integration/phpcs/phpcs.xml -v"
   },
   "require-dev": {
     "phpunit/phpunit": "^9.6",
+    "phpstan/phpstan": "^2.1",
     "squizlabs/php_codesniffer": "^3.13",
     "sbwerewolf/json-serialize-trait": "^1"
   },

composer.lock

@@ -1,32 +1,31 @@
-# Test Environment for Standard PHP 8.3
+# Test Environment for Standard PHP 8.0
 
-This repository expects a standard PHP 8.3 CLI environment with the
-dependencies required for XML processing, PHPUnit, style fixing, and
-coverage.
+This branch expects a standard PHP 8.0 CLI environment with the
+dependencies required for XML processing, PHPUnit, PHPStan, style
+fixing, and coverage.
 
 ## Required dependencies
 
 At minimum, make sure the system provides:
 
-- PHP 8.3 CLI
+- PHP 8.0 CLI
 - XML / XMLReader support
 - Composer
 - Xdebug
 
 Typical package names on Linux distributions look like:
 
-- `php8.3-cli`
-- `php8.3-xml`
-- `php8.3-xdebug`
+- `php8.0-cli`
+- `php8.0-xml`
+- `php8.0-xdebug`
 - `composer`
 
 Exact package names can differ by platform or package manager, but the
-runtime expectation stays the same: `php` must be a PHP 8.3 CLI binary
+runtime expectation stays the same: `php` must be a PHP 8.0 CLI binary
 with `xmlreader` and `xdebug` available.
 
-## How coverage works in this repository
+## How coverage works in this branch
 
-The repository does not require a global coverage mode in `ini` files.
 Coverage is enabled only for the dedicated command:
 
 ```bash
@@ -45,36 +44,6 @@ So the environment must satisfy two conditions:
 2. Coverage is enabled only at launch time through
    `-d xdebug.mode=coverage`.
 
-
-## Platform-specific preparation
-
-Any platform-specific work to make CLI PHP load Xdebug should be done
-outside the repository commands.
-
-### Linux
-
-- install the PHP 8.3 CLI, XML, and Xdebug packages provided by your
-  distribution or PPA;
-- enable the Xdebug extension for CLI PHP using the standard mechanism
-  of that distribution;
-- verify that `php --ri xdebug` works before running coverage.
-
-### macOS
-
-- install PHP 8.3 and Xdebug using your package manager or the standard
-  PHP distribution you use locally;
-- make sure the CLI `php` command loads Xdebug in its default config;
-- verify with `php --ri xdebug`.
-
-### Windows
-
-- use a PHP 8.3 build that includes or supports Xdebug;
-- enable Xdebug in the normal CLI PHP configuration;
-- verify with `php --ri xdebug`.
-
-The repository assumes that by the time you run tests, these steps are
-already complete.
-
 ## Quick verification
 
 Check the loaded extensions:
@@ -89,8 +58,6 @@ Then run:
 ```bash
 composer test
 composer test-coverage
+composer phpstan-check
 composer fix-style
 ```
-
-If `composer test-coverage` fails because Xdebug is missing, fix the
-platform configuration first instead of changing the test command.