frankenphp/README.md

FrankenPHP: Modern App Server for PHP

FrankenPHP is a modern application server for PHP built on top of the Caddy web server.

FrankenPHP gives superpowers to your PHP apps thanks to its stunning features: Early Hints, worker mode, real-time capabilities, automatic HTTPS, HTTP/2, and HTTP/3 support...

FrankenPHP works with any PHP app and makes your Symfony projects faster than ever thanks to provided integration with the worker mode (Laravel Octane support coming).

FrankenPHP can also be used as a standalone Go library to embed PHP in any app using net/http.

Learn more on frankenphp.dev and in this slide deck:

Getting Started

docker run -v $PWD:/app/public \
    -p 80:80 -p 443:443 \
    dunglas/frankenphp

Go to https://localhost, and enjoy!

If you prefer not to use Docker, we provide standalone FrankenPHP binaries for Linux and macOS containing PHP 8.2 and most popular PHP extensions: Download FrankenPHP

Note: do not attempt to use https://127.0.0.1. Use localhost and accept the self-signed certificate. Caddy has an automatic TLS handling that auto-trusts some local-based hostnames like localhost, but it does not apply to IP addresses. More details on Caddy's "automatic https" docs.

Docs

• The worker mode
• Early Hints support (103 HTTP status code)
• Real-time
• Configuration
• Docker images
• Compile from sources
• Create static binaries
• Known issues
• Demo app (Symfony) and benchmarks
• Go library documentation
• Contributing and debugging

Examples and Skeletons

• Symfony
• API Platform
• Laravel
• Sulu
• WordPress
• Drupal
• Joomla