revert: commit 442a6a9 - "build: completely drop phpcs version 3.x."

This reverts commit 442a6a9.

Author: yCodeTech

.github/workflows/unit-tests.yml

@@ -64,7 +64,26 @@ jobs:
         #
         # The matrix is set up so as not to duplicate the builds which are run for code coverage.
         php: ["7.2", "7.3", "7.4", "8.0", "8.1", "8.2", "8.3", "8.4"]
-        phpcs_version: ["4.x-dev"]
+        phpcs_version: ["lowest", "stable", "4.x-dev"]
+
+        exclude:
+          - php: "8.3"
+            phpcs_version: "lowest"
+
+        include:
+          # Add some builds with variations of the dependency versions.
+          - php: "8.4"
+            phpcs_version: "stable"
+
+          # Test against dev versions of all dependencies with select PHP versions for early detection of issues.
+          - php: "7.2"
+            phpcs_version: "dev-master"
+          - php: "7.2"
+            phpcs_version: "4.x-dev"
+          - php: "7.4"
+            phpcs_version: "4.x-dev"
+          - php: "8.2"
+            phpcs_version: "4.x-dev"
 
     name: "Test: PHP ${{ matrix.php }}"
 
@@ -90,6 +109,14 @@ jobs:
           ini-values: ${{ steps.set_ini.outputs.PHP_INI }}
           coverage: none
 
+      - name: "Composer: set PHPCS version for tests (dev)"
+        if: ${{ contains( matrix.phpcs_version, 'dev') }}
+        run: composer require squizlabs/php_codesniffer:"${{ matrix.phpcs_version }}" --no-update --no-scripts --no-interaction
+
+      - name: "Composer: use lock file when necessary"
+        if: ${{ matrix.phpcs_version == 'lowest' }}
+        run: composer config --unset lock
+
       # Install dependencies and handle caching in one go.
       # @link https://github.com/marketplace/actions/install-php-dependencies-with-composer
       - name: Install Composer dependencies
@@ -98,6 +125,10 @@ jobs:
           # Bust the cache at least once a month - output format: YYYY-MM.
           custom-cache-suffix: $(date -u "+%Y-%m")
 
+      - name: "Composer: set PHPCS version for tests (lowest)"
+        if: ${{ matrix.phpcs_version == 'lowest' }}
+        run: composer update squizlabs/php_codesniffer --prefer-lowest --no-scripts --no-interaction
+
       - name: Composer info
         run: composer info
 

composer.json

@@ -18,7 +18,7 @@
     ],
     "require": {
         "php": ">=7.2",
-        "squizlabs/php_codesniffer": "^4.0@dev",
+        "squizlabs/php_codesniffer": "^3.13||^4.0@dev",
         "dealerdirect/phpcodesniffer-composer-installer": "^1.1"
     },
     "require-dev": {

phpunit-bootstrap.php

@@ -37,3 +37,13 @@
 
     exit(1);
 }
+
+// Alias the PHPCS 3.x test case to the PHPCS 4.x name.
+if (class_exists('PHP_CodeSniffer\Tests\Standards\AbstractSniffUnitTest') === true
+    && class_exists('PHP_CodeSniffer\Tests\Standards\AbstractSniffTestCase') === false
+) {
+    class_alias(
+        'PHP_CodeSniffer\Tests\Standards\AbstractSniffUnitTest',
+        'PHP_CodeSniffer\Tests\Standards\AbstractSniffTestCase'
+    );
+}