Merge pull request #555 from armanist/issue/532-php-8-baseline

Issue/532 php 8 baseline

Author: armanist

.github/workflows/php.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       matrix:
         operating-system: [ ubuntu-latest ]
-        php-versions: [ '7.4', '8.0', '8.1' ]
+        php-versions: [ '8.0', '8.1', '8.2' ]
         redis-version: [ 6 ]
 
     runs-on: ${{ matrix.operating-system }}
@@ -67,4 +67,3 @@ jobs:
         uses: codecov/codecov-action@v4
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-

.gitignore

@@ -17,6 +17,8 @@ Thumbs.db
 # =========================
 /tests/_root/shared/store/*
 /tests/_root/cron-tests/
+/tests/_root/cache/data/*
+!/tests/_root/cache/data/.gitkeep
 /coverage/
 *.log
 
@@ -26,4 +28,4 @@ Thumbs.db
 /.php-cs-fixer.cache
 /.phpunit.result.cache
 /.phpunit.cache
-/.cache/
+/.cache/

CHANGELOG.md

@@ -1,3 +1,15 @@
+## [3.0.3] - 2026-06-28
+
+### Changed
+- **BREAKING:** Raised the minimum supported PHP version from `7.4` to `8.0` (#532)
+- Updated CI coverage to test PHP `8.0`, `8.1`, and `8.2` (#532)
+- Raised the static analysis baseline to PHPStan level `8` with PHP `8.0` target settings (#532)
+- Kept Rector aligned to the PHP 8 baseline and applied bounded PHP 8-safe modernization updates (#532)
+- Simplified the standard framework file banner across core sources, templates, and affected tests (#532)
+
+### Notes
+- OpenAPI metadata remains on Doctrine-style annotations for now because the currently used `swagger-php` attribute scanning path requires PHP `8.1+`; `doctrine/annotations` is intentionally retained on the PHP `8.0` baseline (#532)
+
 ## [3.0.0] - 2026-05-28
 
 Upgrade guide: https://github.com/softberg/quantum-php-docs/blob/master/v3.0/upgrade-guide.md

CONTRIBUTING.md

@@ -73,7 +73,13 @@ composer phpstan
 composer cs:check
 ```
 
-6. Commit and push your branch:
+6. Run Rector dry-run
+
+```bash
+composer rector:check
+```
+
+7. Commit and push your branch:
 
 ```bash
 git commit -m "[#123] Add SoftDeletes trait for models"
@@ -105,13 +111,13 @@ Notes:
 ## Testing
 
 Quantum uses **PHPUnit** for tests. If you add new features, make sure they include unit tests — especially for database or HTTP-related components. For in-memory testing, use SQLite in-memory databases (for example, in tests using IdiormDbal).
-All contributions must also pass **PHPStan** (static analysis) and **PHP-CS-Fixer** (code style) checks.
+All contributions must also pass **PHPStan** (static analysis), **PHP-CS-Fixer** (code style), and **Rector** dry-run checks.
 
 ---
 
 ## Code Guidelines
 
-- PHP 7.4+ compatibility is required.  
+- PHP 8.0+ compatibility is required.  
 - Keep class responsibilities clear — avoid bloated classes.  
 - Follow the existing directory structure
 - Always document public methods.  

composer.json

@@ -16,10 +16,14 @@
         {
             "name": "Arman Ag",
             "email": "arman@quantumphp.io"
+        },
+        {
+            "name": "Contributors",
+            "homepage": "https://github.com/quantum-php/framework/contributors"
         }
     ],
     "require": {
-        "php": "^7.4 || ^8.0",
+        "php": "^8.0",
         "ext-pdo": "*",
         "ext-curl": "*",
         "ext-json": "*",

phpstan.neon.dist

@@ -1,6 +1,6 @@
 parameters:
-    phpVersion: 70400
-    level: 7
+    phpVersion: 80000
+    level: 8
 
     paths:
         - src
@@ -13,4 +13,4 @@ parameters:
     checkUninitializedProperties: true
 
     checkDynamicProperties: false
-    treatPhpDocTypesAsCertain: false
+    treatPhpDocTypesAsCertain: false

rector.php

@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use Rector\TypeDeclaration\Rector\StmtsAwareInterface\DeclareStrictTypesRector;
+use Rector\Php80\Rector\Class_\ClassPropertyAssignToConstructorPromotionRector;
 use Rector\TypeDeclaration\Rector\ClassMethod\StrictStringParamConcatRector;
 use Rector\Set\ValueObject\LevelSetList;
 use Rector\Set\ValueObject\SetList;
@@ -20,6 +21,7 @@
         DeclareStrictTypesRector::class,
     ])
     ->withSkip([
+        ClassPropertyAssignToConstructorPromotionRector::class,
         StrictStringParamConcatRector::class => [
             __DIR__ . '/src/Database/Adapters/Idiorm/Statements/Criteria.php',
         ],

src/App/Adapters/AppAdapter.php

@@ -4,14 +4,8 @@
 
 /**
  * Quantum PHP Framework
- *
- * An open source software development framework for PHP
- *
- * @package Quantum
- * @author Arman Ag. <arman@quantumphp.io>
- * @copyright Copyright (c) 2018 Softberg LLC (https://softberg.org)
- * @link https://quantumphp.io/
- * @since 3.0.0
+ * An open-source software development framework for PHP
+ * @link https://quantumphp.io
  */
 
 namespace Quantum\App\Adapters;

src/App/Adapters/ConsoleAppAdapter.php

@@ -4,14 +4,8 @@
 
 /**
  * Quantum PHP Framework
- *
- * An open source software development framework for PHP
- *
- * @package Quantum
- * @author Arman Ag. <arman@quantumphp.io>
- * @copyright Copyright (c) 2018 Softberg LLC (https://softberg.org)
- * @link https://quantumphp.io/
- * @since 3.0.0
+ * An open-source software development framework for PHP
+ * @link https://quantumphp.io
  */
 
 namespace Quantum\App\Adapters;

src/App/Adapters/WebAppAdapter.php

@@ -4,14 +4,8 @@
 
 /**
  * Quantum PHP Framework
- *
- * An open source software development framework for PHP
- *
- * @package Quantum
- * @author Arman Ag. <arman@quantumphp.io>
- * @copyright Copyright (c) 2018 Softberg LLC (https://softberg.org)
- * @link https://quantumphp.io/
- * @since 3.0.0
+ * An open-source software development framework for PHP
+ * @link https://quantumphp.io
  */
 
 namespace Quantum\App\Adapters;