该页面已由社区翻译,可能不是最新的。参见参考版本(英文)。
该页面已由社区翻译,可能不是最新的。参见参考版本(英文)。
该页面已由社区翻译,可能不是最新的。参见参考版本(英文)。
FrankenPHP 将您的 Web 服务器(Nginx、Apache)和 PHP-FPM 都替换为一个单独的二进制文件。本指南涵盖了典型 PHP 应用程序的基本迁移。
| PHP-FPM 设置 | FrankenPHP 等效项 |
|---|---|
| Nginx/Apache + PHP-FPM | 单个 frankenphp 二进制文件 |
php-fpm.conf 池设置 | frankenphp 全局选项 |
Nginx server {} 块 | Caddyfile 站点块 |
php_value / php_admin_value | php_ini Caddyfile 指令 |
pm = static / pm.max_children | num_threads |
pm = dynamic | max_threads auto |
| Web 服务器请求过滤 | Caddy 路由和匹配器 |
从标准的 Nginx 或 Apache 软件包迁移时,请检查在 PHP-FPM 收到请求之前由 Web 服务器完成的任何请求过滤。
FrankenPHP 基于 Caddy 构建,因此有效的 HTTP 方法和头信息会通过 Caddy 的正常路由传递,除非您的 Caddyfile 或其他代理首先拒绝它们。
例如,某些 Web 服务器默认拒绝 TRACE 请求。如果您的应用程序应保留此行为,请在 php_server 之前添加一个显式匹配器:
example.com {
@trace method TRACE
respond @trace 405
root /var/www/app/public
php_server
}
将相同的方法应用于您的旧 Web 服务器强制执行的任何更严格的方法或头信息策略。请求头名称也适用:某些 Web 服务器或代理在 PHP-FPM 看到它们之前拒绝或删除有效但罕见的 HTTP 字段名称,而 FrankenPHP 可能会将它们传递给 PHP 应用程序。
典型的 Nginx + PHP-FPM 配置:
# /etc/nginx/sites-available/example.com
server {
listen 80;
server_name example.com;
root /var/www/app/public;
index index.php;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
变成一个单独的 Caddyfile:
example.com {
root /var/www/app/public
php_server
}
就是这样。php_server 指令处理 PHP 路由、try_files 类似的行为以及静态文件服务。
您现有的 php.ini 可以按原样工作。有关其放置位置(取决于您的安装方法),请参阅配置。
一个设置的含义有所改变:max_execution_time 在 FrankenPHP 中计算实际时间,而在 Linux 上非 ZTS 编译的 PHP-FPM 则计算 CPU 时间。等待数据库查询、HTTP 调用、sleep() 或会话文件锁定的时间现在计入限制,因此为 PHP-FPM 调整的值可能过低。
您也可以直接在 Caddyfile 中设置指令:
{
frankenphp {
php_ini memory_limit 256M
php_ini max_execution_time 30
}
}
example.com {
root /var/www/app/public
php_server
}
在 PHP-FPM 中,您通过调整 pm.max_children 来控制 worker 进程的数量。在 FrankenPHP 中,等效项是 num_threads:
{
frankenphp {
num_threads 16
}
}
默认情况下,FrankenPHP 为每个 CPU 启动 2 个线程。对于类似于 PHP-FPM 的 pm = dynamic 的动态扩展:
{
frankenphp {
num_threads 4
max_threads auto
}
}
典型的使用两个容器(Nginx + PHP-FPM)的 PHP-FPM Docker 设置可以被单个容器替换:
之前:
# compose.yaml
services:
nginx:
image: nginx:1
volumes:
# 将 Nginx 配置挂载到容器中
- ./config:/etc/nginx/conf.d
- .:/var/www/app
ports:
- "80:80"
- "443:443"
php:
image: php:8.5-fpm
volumes:
- .:/var/www/app
之后:
# compose.yaml
services:
php:
image: dunglas/frankenphp:1-php8.5
volumes:
- .:/var/www/app
# 将 Caddyfile 挂载到容器中
- ./config:/etc/frankenphp
- caddy_data:/data
- caddy_config:/config
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
caddy_data:
caddy_config:
如果您需要额外的 PHP 扩展,请参阅构建自定义 Docker 镜像。
对于特定框架的 Docker 设置,请参阅 Symfony Docker 和使用 FrankenPHP Docker 镜像运行 Laravel。
在经典模式下,FrankenPHP 的工作方式类似于 PHP-FPM:每个请求都从头开始启动应用程序。这是一个安全的迁移起点。
为了获得更好的性能,您可以切换到Worker 模式,它会启动您的应用程序一次并将其保留在内存中:
example.com {
root /var/www/app/public
php_server {
root /var/www/app/public
worker index.php 4
}
}
[!注意]
Worker 模式将您的应用程序保留在内存中,跨越多个请求。请确保您的代码不依赖于请求之间全局状态的重置。像 Symfony、Laravel 和 API Platform 等框架原生支持此模式。
迁移后,您不再需要:
php-fpm 服务/进程)