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

Kévin Dunglas c2524a5022 fix test 9 months ago
.github 77f858d009 ci: bump actions/download-artifact from 3 to 4 9 months ago
C-Thread-Pool 517e086786 fix: random crashes when reloading (#394) 9 months ago
caddy c2524a5022 fix test 9 months ago
docs b6e2277863 feat: introduce debug symbols flag for static build (#397) 9 months ago
internal aa1d968dcf refactor: faster $_SERVER variables creation 10 months ago
testdata 3d2c9b6f6f chore: add missing file 10 months ago
.dockerignore 537f899939 feat: use tar to embed apps (#333) 9 months ago
.gitignore 2e72b50d10 ci: add Apple Silicon build script (#313) 10 months ago
.hadolint.yaml c9bf9940d1 ci: add Super-Linter (#323) 9 months ago
.markdown-lint.yaml c9bf9940d1 ci: add Super-Linter (#323) 9 months ago
CONTRIBUTING.md 5c9d7d3f6d docs: link to the website 9 months ago
Dockerfile fd6e28df2a ci: improve linker flags (#383) 9 months ago
LICENSE f8bdd640cf docs: add license (#24) 1 year ago
README.md b845670f07 Fix the broken link in README.md 9 months ago
alpine.Dockerfile fd6e28df2a ci: improve linker flags (#383) 9 months ago
app.tar 537f899939 feat: use tar to embed apps (#333) 9 months ago
build-static.sh ebd5b45dda fix: add back PostreSQL extensions on Mac (#402) 9 months ago
cgi.go aa1d968dcf refactor: faster $_SERVER variables creation 10 months ago
dev-alpine.Dockerfile c9bf9940d1 ci: add Super-Linter (#323) 9 months ago
dev.Dockerfile c9bf9940d1 ci: add Super-Linter (#323) 9 months ago
docker-bake.hcl cb02ce4783 ci: add Docker tags containing the minor and major PHP version (#373) 9 months ago
embed.go 537f899939 feat: use tar to embed apps (#333) 9 months ago
frankenphp.c 517e086786 fix: random crashes when reloading (#394) 9 months ago
frankenphp.go 6509cddd2a feat: embed PHP apps into the FrankenPHP binary 9 months ago
frankenphp.h c9bf9940d1 ci: add Super-Linter (#323) 9 months ago
frankenphp.png 625ab8906f docs: update logo 1 year ago
frankenphp.stub.php 9ef3bd7c47 feat: add fastcgi_finish_request() support (#69) 1 year ago
frankenphp_arginfo.h c9bf9940d1 ci: add Super-Linter (#323) 9 months ago
frankenphp_test.go aa1d968dcf refactor: faster $_SERVER variables creation 10 months ago
go.mod 9b09be22be chore: bump github.com/stretchr/testify from 1.8.1 to 1.8.4 9 months ago
go.sum 9b09be22be chore: bump github.com/stretchr/testify from 1.8.1 to 1.8.4 9 months ago
options.go fb63099a88 feat: allow passing env vars to workers (#210) 1 year ago
recorder_test.go 5012ac30cd chore: improve tests and add missing file (#13) 1 year ago
release.sh d427f55298 ci: fix release script 9 months ago
reload_test.sh 517e086786 fix: random crashes when reloading (#394) 9 months ago
request_options.go aa1d968dcf refactor: faster $_SERVER variables creation 10 months ago
static-builder.Dockerfile 58597bfeab ci: better tags for static-builder Docker image 9 months ago
worker.go b4aa8038ff feat: detect when worker crashes or terminates normally (#315) 10 months ago
worker_test.go aa1d968dcf refactor: faster $_SERVER variables creation 10 months 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 Symfony projects faster than ever thanks to the 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:

Slides

Getting Started

Docker

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

Go to https://localhost, and enjoy!

[!TIP]

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.

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

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