Download the PHP package beauty-framework/app without Composer
On this page you can find all versions of the php package beauty-framework/app. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download beauty-framework/app
More information about beauty-framework/app
Files in beauty-framework/app
Informations about the package app
๐งฑ Beauty Framework
Beauty is a blazing-fast, PSR-compliant, modular microframework for building REST and gRPC APIs on top of RoadRunner. It provides first-class support for clean architecture, strong developer ergonomics, and production-ready features without FPM overhead.
๐ฏ Goals
Beauty is designed as a lightweight, modular and fast foundation for building microservices:
- ๐งฉ Package-oriented: each module is self-contained and reusable
- ๐ RoadRunner-native: zero FPM, ultra-low latency
- โ๏ธ Clean architecture: clear separation between application layers
- ๐งช Testing-friendly: services are testable by design
- ๐ณ Docker-first: fully containerized by default
๐ Features
- Fully PSR-compliant (PSR-3, 4, 7, 11, 15, 14)
- Built-in DI container (PHP-DI powered)
- Attribute-based routing and middleware
- Event system with listener registry
- Lightweight config and cache system
- Jobs, events, queues (via RoadRunner)
- Console kernel for CLI tools
- Powered by RoadRunner โ no FPM
๐ Project Structure
๐ฆ Installation
โ๏ธ Configuration (.env)
๐ง CLI Commands
| Command | Description |
|---|---|
| generate\:controller | Generate controller |
| generate\:command | Generate a new CLI command |
| generate\:middleware | Generate a new middleware |
| generate\:request | Generate a new request |
| generate\:event | Create a new event |
| generate\:listener | Create a new listener |
| generate\:job | Create a new job |
๐ณ Docker Setup (default)
Beauty is designed to run natively inside Docker. By default, all services are containerized:
| Service | Image | Notes |
|---|---|---|
| app | php:8.4-alpine + RR | RoadRunner + CLI build targets |
| db | postgres:16 | PostgreSQL 16 |
| redis | redis\:alpine | Redis 7 |
๐ Makefile Commands
| Category | Command | Description |
|---|---|---|
| Start | make up |
Start the DEV environment |
make prod |
Start the PROD environment | |
| Stop | make stop |
Stop all containers |
make down |
Remove all containers and volumes | |
make restart |
Restart all containers | |
make restart-container CONTAINER=... |
Restart a specific container | |
make stop-container CONTAINER=... |
Stop a specific container | |
| PHP | make php <cmd> |
Run php command inside the app container |
make beauty <cmd> |
Run beauty CLI command inside the app container | |
| Tests | make test |
Run PHPUnit tests |
| Composer | make composer <cmd> |
Run composer command inside the app container |
| Shell | make bash |
Open bash shell inside the app container |
| Logs | make logs <container> |
View logs of specific container |
| Database | make psql |
Access PostgreSQL CLI |
| Cache | make redis |
Access Redis CLI |
๐ Documentation
See Documentation page.
๐ฆ Related Modules
See full list of modules at Documentation page.
๐ TODO
- [ ] ORM support (query builder + migrations)
- [ ]
beauty/testingpackage with framework-aware test harness - [x] gRPC server module with RoadRunner integration
- [ ] Job retries, delays, and failure handlers
- [ ] OpenAPI/Swagger support
- [x] Full module documentation
Welcome to Beauty Framework โ lean, fast, clean. Let's build some serious APIs โก
All versions of app with dependencies
beauty-framework/core Version ^1.0
beauty-framework/database Version ^1.0
beauty-framework/cache Version ^1.0
beauty-framework/parallels Version ^1.0
beauty-framework/jobs Version ^1.0