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, hot reloading, automatic HTTPS, HTTP/2, and HTTP/3 support...
FrankenPHP works with any PHP app and makes your Laravel and Symfony projects faster than ever thanks to their official integrations with the worker mode.
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
Install script
On Linux and macOS, copy this line into your terminal to automatically
install an appropriate version for your platform:
curl https://frankenphp.dev/install.sh | sh
On Windows, run this in PowerShell:
irm https://frankenphp.dev/install.ps1 | iex
Standalone binary
We provide FrankenPHP binaries for Linux, macOS and Windows
containing PHP 8.5.
Linux binaries are statically linked, so they can be used on any Linux distribution without installing any dependency. macOS binaries are also self-contained.
They contain most popular PHP extensions.
Windows archives contain the official PHP binary for Windows.
Download FrankenPHP
rpm packages
Our maintainers offer rpm packages for all systems using dnf. To install, run:
sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm
sudo dnf module enable php-zts:static-8.5 # 8.2-8.5 available
sudo dnf install frankenphp
Installing extensions: sudo dnf install php-zts-<extension>
For extensions not available by default, use PIE:
sudo dnf install pie-zts
sudo pie-zts install asgrim/example-pie-extension
deb packages
Our maintainers offer deb packages for all systems using apt. To install, run:
VERSION=85 # 82-85 available
sudo curl https://pkg.henderkes.com/api/packages/${VERSION}/debian/repository.key -o /etc/apt/keyrings/static-php${VERSION}.asc
echo "deb [signed-by=/etc/apt/keyrings/static-php${VERSION}.asc] https://pkg.henderkes.com/api/packages/${VERSION}/debian php-zts main" | sudo tee -a /etc/apt/sources.list.d/static-php${VERSION}.list
sudo apt update
sudo apt install frankenphp
Installing extensions: sudo apt install php-zts-<extension>
For extensions not available by default, use PIE:
sudo apt install pie-zts
sudo pie-zts install asgrim/example-pie-extension
apk packages
Our maintainers offer apk packages for all systems using apk. To install, run:
VERSION=85 # 82-85 available
echo "https://pkg.henderkes.com/api/packages/${VERSION}/alpine/main/php-zts" | sudo tee -a /etc/apk/repositories
KEYFILE=$(curl -sJOw '%{filename_effective}' https://pkg.henderkes.com/api/packages/${VERSION}/alpine/key)
sudo mv ${KEYFILE} /etc/apk/keys/ &&
sudo apk update &&
sudo apk add frankenphp
Installing extensions: sudo apk add php-zts-<extension>
For extensions not available by default, use PIE:
sudo apk add pie-zts
sudo pie-zts install asgrim/example-pie-extension
Homebrew
FrankenPHP is also available as a Homebrew package for macOS and Linux.
brew install dunglas/frankenphp/frankenphp
Installing extensions: Use PIE.
Usage
To serve the content of the current directory, run:
frankenphp php-server
You can also run command-line scripts with:
frankenphp php-cli /path/to/your/script.php
For the deb and rpm packages, you can also start the systemd service:
sudo systemctl start frankenphp
Docker
Alternatively, Docker images are available:
docker run -v .:/app/public \
-p 80:80 -p 443:443 -p 443:443/udp \
dunglas/frankenphp
Go to https://localhost, and enjoy!
[!TIP]
Do not attempt to use https://127.0.0.1. Use https://localhost and accept the self-signed certificate.
Use the SERVER_NAME environment variable to change the domain to use.
Docs
- Classic mode
- Worker mode
- Migrating from Nginx/PHP-FPM
- Early Hints support (103 HTTP status code)
- Real-time
- Logging
- Hot reloading
- Efficiently serving large static files
- Configuration
- Writing PHP extensions in Go
- Docker images
- Deploy in production
- Performance optimization
- Create standalone, self-executable PHP apps
- Create static binaries
- Compile from sources
- Observability
- WordPress integration
- Symfony integration
- Laravel integration
- Known issues
- Demo app (Symfony) and benchmarks
- Go library documentation
- Contributing and debugging
- Internals (architecture overview)
Examples and skeletons
- Symfony
- API Platform
- Laravel
- Sulu
- WordPress
- Drupal
- Joomla
- TYPO3
- Magento2
- WoltLab Suite
