43 enable php 81 features with backward compatibility

.github/workflows/downgraded_release.yaml

@@ -0,0 +1,43 @@
+name: Downgraded Release
+
+on:
+  push:
+    tags:
+      - '*'
+
+permissions:
+  contents: write
+
+jobs:
+  downgrade_release:
+    # Skip if this is already a downgraded tag
+    if: ${{ !endsWith(github.ref_name, '.74') }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.3
+          coverage: none
+
+      - uses: ramsey/composer-install@v3
+
+      # Downgrade /src to PHP 7.4
+      - run: vendor/bin/rector process src --config build/rector-downgrade-php-74.php --ansi
+
+      # Copy PHP 7.4 composer.json
+      - run: cp build/composer-php-74.json composer.json
+
+      # Remove dev files
+      - run: rm -rf build .github tests stubs ecs.php phpstan.neon phpunit.xml rector.php .php-cs-fixer.php
+
+      # Tag and push downgraded code
+      - name: Tag Downgraded Code
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add --all
+          git commit -m "release PHP 7.4 downgraded version" || echo "No changes to commit"
+          git tag "${GITHUB_REF#refs/tags/}.74"
+          git push origin "${GITHUB_REF#refs/tags/}.74"

.github/workflows/validate.yml

@@ -27,16 +27,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-version:
-          - "7.4"
-          - "8.0"
-          - "8.1"
-          - "8.2"
-          - "8.3"
-          - "8.4"
-        dependencies:
-          - lowest
-          - highest
+        php-version: ["8.1", "8.2", "8.3", "8.4"]
+        dependencies: [lowest, highest]
 
     steps:
       - uses: actions/checkout@v4
@@ -47,19 +39,6 @@ jobs:
           extensions: mbstring
           php-version: "${{ matrix.php-version }}"
 
-      - if: matrix.php-version == '7.4'
-        run: >
-          composer remove --dev --no-update
-          rector/rector
-          mll-lab/graphql-php-scalars
-          spaze/phpstan-disallowed-calls
-
-      - if: matrix.php-version == '8.0'
-        run: composer remove --dev --no-update rector/rector
-
-      - if: matrix.php-version == '7.4' || matrix.php-version == '8.0'
-        run: rm -rf src/Enum tests/Enum src/FluidXPlate/Scalars src/Microplate/Scalars tests/FluidXPlate/Scalars tests/Microplate/Scalars
-
       - uses: ramsey/composer-install@v3
         with:
           dependency-versions: "${{ matrix.dependencies }}"
@@ -74,16 +53,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-version:
-          - "7.4"
-          - "8.0"
-          - "8.1"
-          - "8.2"
-          - "8.3"
-          - "8.4"
-        dependencies:
-          - lowest
-          - highest
+        php-version: ["8.1", "8.2", "8.3", "8.4"]
+        dependencies: [lowest, highest]
 
     steps:
       - uses: actions/checkout@v4
@@ -94,19 +65,6 @@ jobs:
           extensions: mbstring
           php-version: "${{ matrix.php-version }}"
 
-      - if: matrix.php-version == '7.4'
-        run: >
-          composer remove --dev --no-update
-          rector/rector
-          mll-lab/graphql-php-scalars
-          spaze/phpstan-disallowed-calls
-
-      - if: matrix.php-version == '8.0'
-        run: composer remove --dev --no-update rector/rector
-
-      - if: matrix.php-version == '7.4' || matrix.php-version == '8.0'
-        run: rm -rf src/Enum tests/Enum src/FluidXPlate/Scalars src/Microplate/Scalars tests/FluidXPlate/Scalars tests/Microplate/Scalars
-
       - uses: ramsey/composer-install@v3
         with:
           dependency-versions: "${{ matrix.dependencies }}"
@@ -131,3 +89,56 @@ jobs:
 
       # Not using v4 due to the breaking changes described in https://github.com/codecov/codecov-action/releases/tag/v4.0.0
       - uses: codecov/codecov-action@v3
+
+  downgraded-build-validate:
+    name: "Downgraded Build Validate (PHP 7.4, ${{ matrix.dependencies }})"
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        dependencies: [lowest, highest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: "Setup PHP 8.3 (Rector)"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.3
+          coverage: none
+
+      - uses: ramsey/composer-install@v3
+
+      - name: "Downgrade src and tests"
+        run: |
+          vendor/bin/rector process src tests --config build/rector-downgrade-php-74.php --ansi
+
+      - name: "Prepare downgraded composer.json"
+        run: |
+          cp build/composer-php-74.json composer.json
+          rm -f composer.lock
+
+      - name: "Remove tests incompatible with PHP 7.4"
+        run: |
+          rm -rf tests/PHPStan              # Requires PHPStan testing framework
+          rm -rf tests/Enum                 # PHP 8.1+ enums cannot be downgraded
+          rm -rf tests/FluidXPlate          # Requires graphql-php-scalars (optional)
+          rm -rf tests/Qiaxcel              # Requires phpspreadsheet (optional)
+          rm -rf tests/LightcyclerExportSheet  # Uses Collection::firstOrFail (Laravel 9+)
+
+      - name: "Setup PHP 7.4"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 7.4
+          coverage: none
+
+      - name: "Install downgraded dependencies"
+        run: |
+          composer update --no-interaction --prefer-dist ${{ matrix.dependencies == 'lowest' && '--prefer-lowest --prefer-stable' || '' }}
+
+      - name: "Validate downgraded composer.json"
+        run: composer validate --no-check-publish
+
+      - name: "Run PHPUnit on downgraded src"
+        run: vendor/bin/phpunit

CHANGELOG.md

@@ -1,3 +1,22 @@
+## v6.0.0
+
+### Changed
+
+- Require PHP ^8.1 for the main package
+- Use PHP 8.1 features: `readonly` properties, union type syntax
+
+### Added
+
+- Automatic PHP 7.4 downgraded releases via `.74` tag suffix (e.g., `v6.0.0.74`)
+- GitHub Actions workflow for automated downgrade releases
+
+### Migration
+
+Users on PHP 7.4 or 8.0 should use the `.74` tagged releases:
+```sh
+composer require mll-lab/php-utils:v6.0.0.74
+```
+
 # [5.23.0](https://github.com/mll-lab/php-utils/compare/v5.22.0...v5.23.0) (2025-12-08)
 
 

README.md

@@ -18,6 +18,16 @@ Install through composer
 composer require mll-lab/php-utils
 ```
 
+### PHP 7.4 / 8.0 Support
+
+The main package requires PHP ^8.1. For PHP 7.4 or 8.0, use the automatically generated `.74` releases:
+
+```sh
+composer require mll-lab/php-utils:v6.0.0.74
+```
+
+These releases are automatically downgraded using [Rector](https://getrector.org) and published alongside each main release.
+
 ## Usage
 
 See [tests](tests).

build/composer-php-74.json

@@ -0,0 +1,63 @@
+{
+  "name": "mll-lab/php-utils",
+  "description": "Shared PHP utility functions of MLL",
+  "license": "MIT",
+  "type": "library",
+  "authors": [
+    {
+      "name": "Benedikt Franke",
+      "email": "benedikt@franke.tech"
+    }
+  ],
+  "homepage": "https://github.com/mll-lab/php-utils",
+  "support": {
+    "issues": "https://github.com/mll-lab/php-utils/issues",
+    "source": "https://github.com/mll-lab/php-utils"
+  },
+  "require": {
+    "php": "^7.4 || ^8.0",
+    "ext-calendar": "*",
+    "ext-simplexml": "*",
+    "illuminate/support": "^8.77 || ^9 || ^10",
+    "mll-lab/str_putcsv": "^1",
+    "nesbot/carbon": "^2.62.1",
+    "ramsey/uuid": "^3 || ^4",
+    "thecodingmachine/safe": "^1 || ^2"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^9.6"
+  },
+  "suggest": {
+    "mll-lab/graphql-php-scalars": "To use the provided scalar types for GraphQL servers, requires version ^6.3",
+    "phpoffice/phpspreadsheet": "Required if using QiaxcelImport",
+    "spaze/phpstan-disallowed-calls": "Required when using the PHPStan configuration from rules.neon directly or through the extension installer"
+  },
+  "autoload": {
+    "psr-4": {
+      "MLL\\Utils\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "MLL\\Utils\\Tests\\": "tests/"
+    }
+  },
+  "config": {
+    "audit": {
+      "ignore": [
+        "PKSA-8qx3-n5y5-vvnd"
+      ],
+      "abandoned": "ignore"
+    },
+    "block-insecure": false,
+    "sort-packages": true
+  },
+  "extra": {
+    "phpstan": {
+      "includes": [
+        "extension.neon",
+        "rules.neon"
+      ]
+    }
+  }
+}

build/rector-downgrade-php-74.php

@@ -0,0 +1,14 @@
+<?php declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+use Rector\DowngradePhp80\Rector\Class_\DowngradeAttributeToAnnotationRector;
+use Rector\DowngradePhp80\ValueObject\DowngradeAttributeToAnnotation;
+
+return RectorConfig::configure()
+    ->withDowngradeSets(php74: true)
+    ->withConfiguredRule(DowngradeAttributeToAnnotationRector::class, [
+        new DowngradeAttributeToAnnotation(
+            'PHPUnit\Framework\Attributes\DataProvider',
+            'dataProvider'
+        ),
+    ]);

composer.json

@@ -15,10 +15,10 @@
     "source": "https://github.com/mll-lab/php-utils"
   },
   "require": {
-    "php": "^7.4 || ^8",
+    "php": "^8.1",
     "ext-calendar": "*",
     "ext-simplexml": "*",
-    "illuminate/support": "^8.73 || ^9 || ^10 || ^11 || ^12",
+    "illuminate/support": "^8.77 || ^9 || ^10 || ^11 || ^12",
     "mll-lab/str_putcsv": "^1",
     "nesbot/carbon": "^2.62.1 || ^3",
     "ramsey/uuid": "^3 || ^4",

rector.php

@@ -9,6 +9,8 @@
         SetList::CODE_QUALITY,
         SetList::TYPE_DECLARATION,
         SetList::RECTOR_PRESET,
+        SetList::PHP_80,
+        SetList::PHP_81,
         PHPUnitSetList::PHPUNIT_40,
         PHPUnitSetList::PHPUNIT_50,
         PHPUnitSetList::PHPUNIT_60,
@@ -19,7 +21,6 @@
         PHPUnitSetList::PHPUNIT_110,
         PHPUnitSetList::PHPUNIT_CODE_QUALITY,
     ])
-    ->withPhpSets()
     ->withRules([
         Rector\PHPUnit\CodeQuality\Rector\Class_\PreferPHPUnitSelfCallRector::class,
     ])
@@ -28,6 +29,9 @@
         Rector\CodeQuality\Rector\Concat\JoinStringConcatRector::class => [
             __DIR__ . '/tests/CSVArrayTest.php', // keep `\r\n` for readability
         ],
+        Rector\Php80\Rector\Class_\ClassPropertyAssignToConstructorPromotionRector::class => [
+            __DIR__ . '/src/IlluminaSampleSheet/V2/BclConvert/BclSample.php', // currently relies on `get_object_vars()` and breaks behaviour.
+        ],
     ])
     ->withPaths([__DIR__ . '/src', __DIR__ . '/tests'])
     ->withBootstrapFiles([

src/DnaSequence.php

@@ -19,7 +19,7 @@ public function reverse(): string
         $parts = mb_str_split($this->sequence); // @phpstan-ignore-line theCodingMachineSafe.function (safe from PHP 8.0)
         $reversedParts = array_reverse($parts);
 
-        return implode($reversedParts);
+        return implode('', $reversedParts);
     }
 
     public function complement(): string

src/FluidXPlate/FluidXPlate.php

@@ -16,7 +16,7 @@ class FluidXPlate
     public string $rackID;
 
     /** @var Microplate<string, CoordinateSystem12x8> */
-    private Microplate $microplate;
+    private readonly Microplate $microplate;
 
     public function __construct(string $rackID)
     {
@@ -51,7 +51,7 @@ public function addToNextFreeWell(string $content, FlowDirection $flowDirection)
     /** @return Collection<string, string|null> */
     public function wells(): Collection
     {
-        return $this->microplate->wells();
+        return $this->microplate->wells(); // @phpstan-ignore return.type (generic not inferred)
     }
 
     /** @return Collection<string, null> */
@@ -63,6 +63,6 @@ public function freeWells(): Collection
     /** @return Collection<string, string> */
     public function filledWells(): Collection
     {
-        return $this->microplate->filledWells();
+        return $this->microplate->filledWells(); // @phpstan-ignore return.type (generic not inferred)
     }
 }