quantum-php · armanist · Jun 28, 2026 · Jun 24, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/.github/workflows/php.yml b/.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 }}
-
diff --git a/.gitignore b/.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/
diff --git a/CHANGELOG.md b/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

diff --git a/CONTRIBUTING.md b/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.  

diff --git a/composer.json b/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": "*",

diff --git a/phpstan.neon.dist b/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
diff --git a/rector.php b/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',
         ],

diff --git a/src/App/Adapters/AppAdapter.php b/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;

diff --git a/src/App/Adapters/ConsoleAppAdapter.php b/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;

diff --git a/src/App/Adapters/WebAppAdapter.php b/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;

diff --git a/src/App/App.php b/src/App/App.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;
@@ -70,7 +64,7 @@ public function getAdapter(): AppInterface
     public function __call(string $method, ?array $arguments)
     {
         if (!method_exists($this->adapter, $method)) {
-            throw AppException::methodNotSupported($method, get_class($this->adapter));
+            throw AppException::methodNotSupported($method, $this->adapter::class);
         }
 
         return $this->adapter->$method(...$arguments);

diff --git a/src/App/AppContext.php b/src/App/AppContext.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;

diff --git a/src/App/BootPipeline.php b/src/App/BootPipeline.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;

diff --git a/src/App/Contracts/AppInterface.php b/src/App/Contracts/AppInterface.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\Contracts;

diff --git a/src/App/Contracts/BootStageInterface.php b/src/App/Contracts/BootStageInterface.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\Contracts;

diff --git a/src/App/Enums/AppType.php b/src/App/Enums/AppType.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\Enums;

diff --git a/src/App/Enums/ExceptionMessages.php b/src/App/Enums/ExceptionMessages.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\Enums;

diff --git a/src/App/Enums/ExitCode.php b/src/App/Enums/ExitCode.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\Enums;

diff --git a/src/App/Enums/ReservedKeys.php b/src/App/Enums/ReservedKeys.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\Enums;

diff --git a/src/App/Exceptions/AppException.php b/src/App/Exceptions/AppException.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\Exceptions;

diff --git a/src/App/Exceptions/BaseException.php b/src/App/Exceptions/BaseException.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\Exceptions;

diff --git a/src/App/Factories/AppFactory.php b/src/App/Factories/AppFactory.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\Factories;