🚀 Quantum PHP 3.1.0 Released

[armanist]

Quantum PHP 3.1.0 is out. This release raises the minimum PHP version to 8.1 and reworks how the framework starts up and runs, so it is easier to follow and to extend.

Website: https://quantumphp.io/
Docs on GitBook: https://quantumphp.gitbook.io/docs
Docs on Read the Docs: https://quantum-php-framework.readthedocs.io/en/latest/

Release notes: https://github.com/quantum-php/framework/releases/tag/3.1.0
Full changelog: https://github.com/quantum-php/framework/blob/master/CHANGELOG.md
Upgrade guide: https://quantumphp.io/v3.0/upgrade-guide

---

⚠️ Before you update

• PHP 8.1 or newer is required. Applications on PHP 8.0 stay on 3.0.x. CI now runs on PHP 8.1, 8.2 and 8.3.
• There are breaking changes for code that builds on the framework's internals. The upgrade guide lists each one, with before and after examples.

---

✨ Highlights

✅ A clearer app lifecycle

The web and console apps now boot and run as pipelines of small stages. The runtime stages announce events (web.preflight, web.route, web.dispatch, web.send, console.command and more, each with .before and .after) that you can listen to.

✅ Event replaces Hook

hook()->on() and fire() are now event()->listen() and dispatch(). Event names no longer need to be registered, and listeners stay registered after they run.

✅ A simpler debug toolbar

The toolbar reads its data when it renders, instead of every package writing into it. Memory use is bounded: the logger and the mailer keep the last 1000 entries by default. In debug mode, the console now writes its log lines to files.

✅ Translate with DeepL or Google Translate

The Lang package now works through adapters, including DeepL and Google Translate, next to the existing file translations.

✅ Native HTTP client

HttpClient runs on Quantum's own cURL adapters. The php-curl-class dependency is gone.

✅ OpenAPI with attributes

The API module templates describe the API with PHP attributes, and doctrine/annotations is no longer required.

✅ Smaller improvements

• Request::expectsJson(), and "page not found" answers JSON to clients that ask for it
• Symfony 6.4, and psr/log 2 or 3
• Deprecations are logged as warnings instead of stopping the request
• Quantum\Loader is removed; Setup is now Quantum\Config\Setup
• Fixes: the file rate limiter creates its missing folders, install:openapi creates the folders it needs, and several settings read from .env (booleans, ports, the remember-me lifetime) now work as expected

---

🚀 Starter project

quantum/project 3.1.0 is released too. It requires PHP 8.1 and quantum/framework 3.1.

composer create-project quantum/project my-project

---

🔜 Next

3.1.1 is a small follow-up:

• back() for the response redirect API, and the demo templates updated to use it
• install:demo with single-author and multi-author demo variants, for both Web and API
• the constant classes in the Enums folders turned into PHP enums

Thank you to everyone using, testing and contributing to Quantum PHP.