Installation
This guide walks you through installing and running a new Quantum PHP project.
Requirements
Make sure your environment includes:
- PHP 8.1+;
- PHP extensions:
- PDO
- curl
- JSON
- simplexml
- fileinfo
- OpenSSL
- bcmath
- Composer installed and accessible globally
Optional framework features may require additional extensions or packages such as redis, memcached, zip, dom, or twig/twig.
Practical note: run php -v to check your PHP version before you start. Quantum needs PHP 8.1 or newer.
Installation Steps
Create a new project
bashcomposer create-project quantum/project my-projectThe current starter project runs a post-create setup sequence automatically after Composer finishes installing dependencies.
That setup currently:
- creates
.envfrom.env.example - generates an application key
- installs the demo
WebandApimodules - installs OpenAPI assets/routes for the
Apimodule - publishes DebugBar assets
- prints the installed framework version
- creates
Navigate into the project directory
bashcd my-projectStart the development server
bashphp qt serveThe development server starts and prints its address, by default
http://127.0.0.1:8000/. If port 8000 is busy, it uses the next free port. The options are described underserve.
Verification
You should now see a working Quantum demo application in the browser.
On a successful fresh install, you should also expect that:
.envalready existsAPP_KEYhas been generated- the starter demo modules are already installed
- the CLI can boot successfully with
php qt serve
