The modern PHP app server https://frankenphp.dev/

Alexander Hofbauer b40c5a64a8 docs: update instructions for xcaddy in Dockerfile (#1170) 2 days ago
.github e5ca97308e perf: optimize $_SERVER import (#1106) 2 weeks ago
caddy 7af06f18d7 chore: prepare release 1.3.1 6 days ago
docs b40c5a64a8 docs: update instructions for xcaddy in Dockerfile (#1170) 2 days ago
internal 0328d0600e fix: missing build tag for fastabs 1 week ago
testdata 9ad06f11d3 chore: simplify benchmark.Caddyfile 1 week ago
.dockerignore 6f108a4203 fix: do not extract embedded app on every execution (#488) 10 months ago
.gitignore 2e72b50d10 ci: add Apple Silicon build script (#313) 1 year ago
.hadolint.yaml c9bf9940d1 ci: add Super-Linter (#323) 11 months ago
.markdown-lint.yaml c9bf9940d1 ci: add Super-Linter (#323) 11 months ago
CONTRIBUTING.md 75dab8f33d chore: bump deps and misc improvements (#1135) 2 weeks ago
Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 3 weeks ago
LICENSE f8bdd640cf docs: add license (#24) 2 years ago
README.md fa64198d52 docs: simplify docker run command (#1168) 5 days ago
SECURITY.md 17e57287eb docs: fix link in SECURITY.md (#1111) 4 weeks ago
alpine.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 3 weeks ago
app.tar 537f899939 feat: use tar to embed apps (#333) 11 months ago
app_checksum.txt 6f108a4203 fix: do not extract embedded app on every execution (#488) 10 months ago
build-static.sh a441e22a1b fix: ignore watcher dir creation error if the watcher exists (#1165) 6 days ago
cgi.go 75dab8f33d chore: bump deps and misc improvements (#1135) 2 weeks ago
dev-alpine.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 3 weeks ago
dev.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 3 weeks ago
docker-bake.hcl 8d9b6e755b feat: restart workers when on source changes (#1013) 1 month ago
embed.go d53f909d20 chore: various cleanups 4 weeks ago
frankenphp.c 0c123a2563 remove opcache_reset (#1173) 3 days ago
frankenphp.go 022b8f1094 perf: use buffered chans for requests (#1146) 1 week ago
frankenphp.h 0c123a2563 remove opcache_reset (#1173) 3 days ago
frankenphp.png 625ab8906f docs: update logo 2 years ago
frankenphp.stub.php ea5e19ff4b fix: getallheaders() must return request headers (#772) 6 months ago
frankenphp_arginfo.h ea5e19ff4b fix: getallheaders() must return request headers (#772) 6 months ago
frankenphp_test.go 843d199469 perf: cache computations in WithRequestDocumentRoot (#1154) 1 week ago
go.mod 172b598f3b chore: bump deps (#1150) 1 week ago
go.sum 172b598f3b chore: bump deps (#1150) 1 week ago
install.sh cda74730ae fix: term capability code may not be available 1 month ago
metrics.go 843d199469 perf: cache computations in WithRequestDocumentRoot (#1154) 1 week ago
metrics_test.go aa585f7da0 handle worker failures gracefully (#1038) 1 month ago
options.go 8d9b6e755b feat: restart workers when on source changes (#1013) 1 month ago
php_thread.go 1c3ce114f6 perf: use hot worker threads when possible (#1126) 2 weeks ago
php_thread_test.go d99b16a158 perf: remove all cgo handles (#1073) 1 month ago
recorder_test.go 75dab8f33d chore: bump deps and misc improvements (#1135) 2 weeks ago
release.sh 6c708be99d ci: upgrade to super-linter 6 (#952) 3 months ago
reload_test.sh 6c708be99d ci: upgrade to super-linter 6 (#952) 3 months ago
request_options.go 843d199469 perf: cache computations in WithRequestDocumentRoot (#1154) 1 week ago
static-builder.Dockerfile 843d199469 perf: cache computations in WithRequestDocumentRoot (#1154) 1 week ago
watcher_test.go afedeb9d58 refactor: use build tags to disable, instead of to enable a feature (#1113) 4 weeks ago
worker.go 0c123a2563 remove opcache_reset (#1173) 3 days ago
worker_test.go 75dab8f33d chore: bump deps and misc improvements (#1135) 2 weeks ago

README.md

FrankenPHP: Modern App Server for PHP

FrankenPHP

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 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:

Slides

Getting Started

Docker

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.

Standalone Binary

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

On Windows, use WSL to run FrankenPHP.

Download FrankenPHP or copy this line into your terminal to automatically install the version appropriate for your platform:

curl https://frankenphp.dev/install.sh | sh
mv frankenphp /usr/local/bin/

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

Docs

Examples and Skeletons