FrankenPHP实践-平芜编程栈

1. 说明

2. 程序修改

3. 性能测试

4. 配置

4.1 Docker化部署

4.2 Caddy泛域名和证书设置

4.3 相关命令

5. 要点：

6. 参考

1. 说明

Frankenphp是一个先进的，结合了高性能Caddy服务器的PHP环境框架，它允许用户只需要少量改动，就能让传统的php前端应用插上翅膀，享受到异步服务带来的量级提升体验，官网：https://frankenphp.dev。

它实际上是有两种运行模式：普通模式和worker模式，其中的普通模式类似于传统的LNMP容器，只是Nginx换成了Caddy Server，带来的提升并不特别明显。而worker模式就不同了，效果是原来性能的三倍左右。

2. 程序修改

以TP6为例，用worker模式的话，入口程序需改由frankenphp_handle_request包裹使用，参考官网docs:FrankenPHP: the modern PHP app server

<?php ignore_user_abort(true); require __DIR__ . '/../vendor/autoload.php'; $thinkApp = new hinkApp(); $http = $thinkApp->http; $handler = static function () use ($http) { // 初始化并处理请求 $response = $http->run(); // 发送响应 $response->send(); // 返回响应后终止应用 $http->end($response); }; $maxRequests = (int)($_SERVER['MAX_REQUESTS'] ?? 0); for ($nbRequests = 0; !$maxRequests || $nbRequests < $maxRequests; ++$nbRequests) { // 处理请求 $keepRunning = rankenphp_handle_request($handler); // 执行一些在发送 HTTP 响应后的操作 gc_collect_cycles(); // 垃圾回收 if (!$keepRunning) break; }

3. 性能测试

Performance benchmark of PHP runtimes - DEV Community

4. 配置

4.1 Docker化部署

docker-compose.yml，其中: 证书路径映射到 /data0/Server/Auths/certs
多个应用需添加不同的worker入口描述
compose.yaml
services:
php:
container_name: frankenphp
# image: dunglas/frankenphp
build:
dockerfile: frankenphp.Dockerfile
context: ./docker
restart: always
# restart: unless-stopped
# uncomment the following line if you want to use a custom Dockerfile
#build: .
environment:
SERVER_NAME: php:80
MAX_REQUESTS: 600
FRANKENPHP_CONFIG: |
worker {
file /app1/public/index.php
num 42
watch
}
worker {
file /app2/public/index.php
num 42
watch
}
#CADDY_SERVER_EXTRA_DIRECTIVES: try_files {path} {path}/ /index.php?s=/{path}&{query}
CADDY_SERVER_EXTRA_DIRECTIVES: |
try_files {path} {path}/ /index.php?s=/{path}&{query}
ports:
- “80:80” # HTTP
- “443:443” # HTTPS
- “443:443/udp” # HTTP/3
volumes:
- /data0/Server/Logs/caddy:/logs
# - /data0/Projects/Test/test001:/app/public
#- /home/website/ad_serving_backend:/app # App src
- /home/website/app1:/app1 # App1 src
- /home/website/app2:/app2 # App2 src
- /data0/Server/Settings/caddy/Caddyfile:/etc/caddy/Caddyfile
- /data0/Server/Db/caddy:/data
- /data0/Server/Settings/caddy/config:/config
- /data0/Server/Auths/certs:/certs
# comment the following line in production, it allows to have nice human-readable logs in dev
tty: true

4.2 Caddy泛域名和证书设置

尽管Caddy自带无敌好感的自注册安全证书机制，但有时候我们还是需要手动部署一些已有的证书(nginx原有证书即可)，这时我们要编辑Caddyfile做定制:

{ {$CADDY_GLOBAL_OPTIONS} frankenphp { #worker /path/to/your/worker.php {$FRANKENPHP_CONFIG} } # Logging log { output stderr level INFO #level DEBUG } } {$CADDY_EXTRA_CONFIG} {$SERVER_NAME:localhost} { #log { # # Redact the authorization query parameter that can be set by Mercure # format filter { # request>uri query { # replace authorization REDACTED # } # } #} root * public/ encode zstd br gzip # Uncomment the following lines to enable Mercure and Vulcain modules #mercure { # # Transport to use (default to Bolt) # transport_url {$MERCURE_TRANSPORT_URL:bolt:///data/mercure.db} # # Publisher JWT key # publisher_jwt {env.MERCURE_PUBLISHER_JWT_KEY} {env.MERCURE_PUBLISHER_JWT_ALG} # # Subscriber JWT key # subscriber_jwt {env.MERCURE_SUBSCRIBER_JWT_KEY} {env.MERCURE_SUBSCRIBER_JWT_ALG} # # Allow anonymous subscribers (double-check that it's what you want) # anonymous # # Enable the subscription API (double-check that it's what you want) # subscriptions # # Extra directives # {$MERCURE_EXTRA_DIRECTIVES} #} #vulcain {$CADDY_SERVER_EXTRA_DIRECTIVES} php_server } app1.com { #log { # # Redact the authorization query parameter that can be set by Mercure # format filter { # request>uri query { # replace authorization REDACTED # } # } #} root * /app1/public/ encode zstd br gzip tls /certs/app1.com/serv.pem /certs/app1.com/serv.key {$CADDY_SERVER_EXTRA_DIRECTIVES} log { output file /logs/app1.com.log { rotate_size 100 # Rotate after 100 MB rotate_keep 5 # Keep at most 20 log files roll_keep_for 72h } } php_server } app2.com { root * /app2/public/ encode zstd br gzip tls /certs/app2.com/serv.pem /certs/app2.com/serv.key {$CADDY_SERVER_EXTRA_DIRECTIVES} log { output file /logs/app2.com.log { rotate_size 100 # Rotate after 100 MB rotate_keep 5 # Keep at most 20 log files roll_keep_for 72h } } php_server }

4.3 相关命令

docker compose down && docker compose up -d --wait # 修改配置后重拉容器 docker compose -f /data0/Server/Settings/docker-compose/frankenphp/docker-compose.yml down && docker compose -f /data0/Server/Settings/docker-compose/frankenphp/docker-compose.yml up -d --wait # restart docker compose -f /data0/Server/Settings/docker-compose/frankenphp/docker-compose.yml restart # 日志 docker logs frankenphp