Go to file
Kévin Dunglas 334139ca2b
Some checks are pending
Lint Code Base / Lint Code Base (push) Waiting to run
Sanitizers / ${{ matrix.sanitizer }} (asan) (push) Waiting to run
Sanitizers / ${{ matrix.sanitizer }} (msan) (push) Waiting to run
Tests / tests (8.2) (push) Waiting to run
Tests / tests (8.3) (push) Waiting to run
Tests / tests (8.4) (push) Waiting to run
feat: improve install script (#1097)
2024-10-15 18:06:21 +02:00
.github feat: add build tag to skip Watcher support (#1076) 2024-10-08 23:23:53 +02:00
caddy feat: add build tag to skip Watcher support (#1076) 2024-10-08 23:23:53 +02:00
docs feat: improve install script (#1097) 2024-10-15 18:06:21 +02:00
internal feat: add build tag to skip Watcher support (#1076) 2024-10-08 23:23:53 +02:00
testdata Removes worker panic when the watcher is enabled. (#1092) 2024-10-14 20:58:26 +02:00
.dockerignore fix: do not extract embedded app on every execution (#488) 2024-01-21 18:13:08 +01:00
.gitignore ci: add Apple Silicon build script (#313) 2023-11-19 17:06:18 +01:00
.hadolint.yaml ci: add Super-Linter (#323) 2023-12-01 17:26:21 +01:00
.markdown-lint.yaml ci: add Super-Linter (#323) 2023-12-01 17:26:21 +01:00
alpine.Dockerfile chore: make the branch from which Watcher is built a release branch (#1072) 2024-10-11 17:37:53 +02:00
app_checksum.txt fix: do not extract embedded app on every execution (#488) 2024-01-21 18:13:08 +01:00
app.tar feat: use tar to embed apps (#333) 2023-12-03 19:17:36 +01:00
build-static.sh chore: make the branch from which Watcher is built a release branch (#1072) 2024-10-11 17:37:53 +02:00
cgi.go perf: reduce allocs when creating $_SERVER (#540) 2024-03-12 18:31:30 +01:00
CONTRIBUTING.md feat: improve install script (#1097) 2024-10-15 18:06:21 +02:00
dev-alpine.Dockerfile chore: make the branch from which Watcher is built a release branch (#1072) 2024-10-11 17:37:53 +02:00
dev.Dockerfile chore: make the branch from which Watcher is built a release branch (#1072) 2024-10-11 17:37:53 +02:00
docker-bake.hcl feat: restart workers when on source changes (#1013) 2024-10-07 13:17:24 +02:00
Dockerfile chore: make the branch from which Watcher is built a release branch (#1072) 2024-10-11 17:37:53 +02:00
embed.go fix: temporary directory name for embed apps 2024-04-28 10:45:38 +02:00
frankenphp_arginfo.h fix: getallheaders() must return request headers (#772) 2024-05-08 11:43:39 +02:00
frankenphp_test.go feat: restart workers when on source changes (#1013) 2024-10-07 13:17:24 +02:00
frankenphp.c perf: only import os environment variables once per worker thread (#1080) 2024-10-15 12:03:58 +02:00
frankenphp.go perf: remove all cgo handles (#1073) 2024-10-09 07:31:09 +02:00
frankenphp.h perf: remove all cgo handles (#1073) 2024-10-09 07:31:09 +02:00
frankenphp.png docs: update logo 2022-10-14 12:23:39 +02:00
frankenphp.stub.php fix: getallheaders() must return request headers (#772) 2024-05-08 11:43:39 +02:00
go.mod add basic metrics (#966) 2024-09-26 09:53:37 +02:00
go.sum feat: restart workers when on source changes (#1013) 2024-10-07 13:17:24 +02:00
install.sh feat: improve install script (#1097) 2024-10-15 18:06:21 +02:00
LICENSE docs: add license (#24) 2022-10-15 11:21:21 +02:00
metrics_test.go handle worker failures gracefully (#1038) 2024-10-03 21:53:12 +02:00
metrics.go handle worker failures gracefully (#1038) 2024-10-03 21:53:12 +02:00
options.go feat: restart workers when on source changes (#1013) 2024-10-07 13:17:24 +02:00
php_thread_test.go perf: remove all cgo handles (#1073) 2024-10-09 07:31:09 +02:00
php_thread.go perf: remove all cgo handles (#1073) 2024-10-09 07:31:09 +02:00
README.md feat: improve install script (#1097) 2024-10-15 18:06:21 +02:00
recorder_test.go chore: improve tests and add missing file (#13) 2022-10-11 20:41:50 +02:00
release.sh ci: upgrade to super-linter 6 (#952) 2024-08-04 14:05:54 +02:00
reload_test.sh ci: upgrade to super-linter 6 (#952) 2024-08-04 14:05:54 +02:00
request_options.go perf: cache document root resolution when possible 2024-08-26 20:26:27 +02:00
SECURITY.md docs: create SECURITY.md 2024-08-13 16:08:59 +02:00
static-builder.Dockerfile chore: make the watcher module internal 2024-10-07 15:37:40 +02:00
watcher_test.go feat: add build tag to skip Watcher support (#1076) 2024-10-08 23:23:53 +02:00
worker_test.go perf: only import os environment variables once per worker thread (#1080) 2024-10-15 12:03:58 +02:00
worker.go Removes worker panic when the watcher is enabled. (#1092) 2024-10-14 20:58:26 +02:00

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