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

Kévin Dunglas 9013614801 fix: sapi_module.getenv() should delegate to Go 3 days ago
.github e5ca97308e perf: optimize $_SERVER import (#1106) 6 days ago
caddy 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
docs 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
internal 56d5d50ea9 fix: watcher pattern matching and retrying (#1143) 5 hours ago
testdata 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
.dockerignore 6f108a4203 fix: do not extract embedded app on every execution (#488) 9 months ago
.gitignore 2e72b50d10 ci: add Apple Silicon build script (#313) 11 months 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) 6 days ago
Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 1 week ago
LICENSE f8bdd640cf docs: add license (#24) 2 years ago
README.md 334139ca2b feat: improve install script (#1097) 3 weeks ago
SECURITY.md 17e57287eb docs: fix link in SECURITY.md (#1111) 2 weeks ago
alpine.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 1 week 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) 9 months ago
build-static.sh 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 1 week ago
cgi.go 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
dev-alpine.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 1 week ago
dev.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 1 week ago
docker-bake.hcl 8d9b6e755b feat: restart workers when on source changes (#1013) 1 month ago
embed.go d53f909d20 chore: various cleanups 2 weeks ago
frankenphp.c 9013614801 fix: sapi_module.getenv() should delegate to Go 5 hours ago
frankenphp.go 9013614801 fix: sapi_module.getenv() should delegate to Go 5 hours ago
frankenphp.h e5ca97308e perf: optimize $_SERVER import (#1106) 6 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 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
go.mod 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
go.sum 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
install.sh cda74730ae fix: term capability code may not be available 3 weeks ago
metrics.go d53f909d20 chore: various cleanups 2 weeks 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) 6 days 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) 6 days 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 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
static-builder.Dockerfile 69c43ee43d chore: use upstream e-dant/watcher headers and build system (#1119) 1 week ago
watcher_test.go afedeb9d58 refactor: use build tags to disable, instead of to enable a feature (#1113) 2 weeks ago
worker.go 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days ago
worker_test.go 75dab8f33d chore: bump deps and misc improvements (#1135) 6 days 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 $PWD:/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