FrankenPHP 是嵌入 PHP 运行时的定制版 Caddy 二进制，非独立插件或搭配软件；它共用一个进程、一份 Caddyfile 配置，启动即提供 HTTP/HTTPS/静态文件与 PHP 执行能力。
FrankenPHP 就是 Caddy 的一个内置 PHP 应用插件
它不是“搭配使用”的两个独立软件，而是 FrankenPHP 二进制本身就是一个定制版 Caddy —— 编译时把 libphp 直接嵌进去了。启动 frankenphp php-server，你看到的其实是 Caddy 的 HTTP 服务、TLS 管理、静态文件逻辑，加上内建的 PHP 执行器，共用一个进程、一份配置（Caddyfile）。所以不存在“先装 Caddy 再装 FrankenPHP”，官方安装脚本下载的就是这个融合体。
安装后直接运行却报错 exec: "frankenphp": executable file not found
这是 PATH 没配好最常见的情况。官方一键安装脚本默认把二进制放到 /usr/local/bin/frankenphp，但某些 Linux 发行版（比如 Alpine 或最小化 CentOS）的 $PATH 不包含该路径。
- 先确认文件是否存在：
ls -l /usr/local/bin/frankenphp - 如果存在但命令不可用，临时加 PATH：
export PATH="/usr/local/bin:$PATH"，再试frankenphp --version - 要永久生效，把上面那行写进
/etc/profile或用户家目录下的~/.bashrc - Docker 用户注意：
dunglas/frankenphp镜像里frankenphp已在 PATH 中，无需额外配置
用 Docker 启动后访问 404，或 PHP 文件被直接下载而不是执行
根本原因是 Caddyfile 里漏了 php_server 指令。FrankenPHP 不会自动识别 .php 文件 —— 它不像传统 Nginx 那样靠 location ~ \.php$ 匹配，而是靠显式启用 PHP 处理模块。
- 最简可用配置必须含这两块：
{ frankenphp { } } yourdomain.com { php_server } - 如果项目入口是
public/index.php（如 Laravel），还要加重写规则：php_server { rewrite * /index.php?{query} } - 别把
php_server放在reverse_proxy后面——它不转发，是直接执行；放错位置会导致请求被跳过 - 检查
Caddyfile是否在当前工作目录，FrankenPHP 默认只读当前目录下的该文件
num_threads 设太高反而变慢，怎么调才合理
FrankenPHP 的线程池不是越多越好。每个线程会常驻加载一次 PHP 解释器+OPcache+框架 bootstrap，内存占用随线程数线性增长；而真实并发请求数受 CPU 核心和 I/O 瓶颈限制。设成 auto 通常比硬编码更稳。
立即学习“PHP免费学习笔记（深入）”；
-
num_threads 2：适合本地开发或 1C1G 的轻量服务器 -
num_threads auto：推荐生产环境首选，它按runtime.NumCPU()自动设为 CPU 核心数 -
max_threads 8：可设略高于num_threads，用于突发流量，但别超过物理核心数 × 2 - 观察指标：用
ps aux | grep frankenphp看实际活跃线程数，再对比htop里 CPU/内存使用率 —— 如果 CPU 没跑满但内存吃紧，说明线程冗余了
FrankenPHP 的“简单”是建立在理解它和 Caddy 是一体两面的基础上的；最容易忽略的，是把它当成传统 LNMP 去套用 Nginx 思维，结果卡在 php_server 漏写、PATH 不对、或线程乱调上。
