FrankenPHP Worker Boilerplate 🐘⚡

A minimal boilerplate for building native PHP applications using FrankenPHP in worker mode.
Ideal for fast, efficient, and modern PHP web apps — without the overhead of a full framework.

🚀 Features

• ✅ Native PHP (no framework required)
• ⚙️ Pre-configured for FrankenPHP with worker mode
• 🐳 Docker support with development and production configurations
• 📦 Composer for dependency management
• 🗂 Clean and minimal project structure
• ♻️ Efficient request handling using long-running PHP worker
• 🔧 Ready for extension and customization

📁 Project Structure

.
├── app/                 # Application core
│   └── Kernel.php      # Worker kernel implementation
├── public/             # Public web root
│   └── index.php       # Entry point for FrankenPHP
├── vendor/             # Composer dependencies
├── compose.yml         # Docker Compose configuration
├── Dockerfile          # Development Docker configuration
├── Dockerfile.production # Production Docker configuration
├── composer.json       # Composer configuration
└── README.md          # Project documentation

🛠️ Development

1. Clone the repository
2. Run composer install to install dependencies
3. Use Docker Compose to start the development environment:

   docker compose up

🚢 Production

For production deployment, use the production Dockerfile:

docker build -f Dockerfile.production -t your-app-name .

📝 License

This project is open-sourced software licensed under the MIT license.

.
├── public/              # Public web root (set as document root)
│   └── index.php        # Entry point for FrankenPHP
├── src/                 # Main application logic
│   └── App.php          # Example worker handler class
├── .frankenphp.yaml     # FrankenPHP configuration
└── README.md            # Project documentation