FrankenPHP是基于Caddy的单二进制PHP应用服务器，内嵌PHP运行时，统一承载Web服务、TLS终止、HTTP/3、PHP执行及Worker常驻模式，无需Nginx或PHP-FPM。
用七天时间系统掌握 FrankenPHP 的核心部署、配置与调优能力，从零启动一个支持 HTTPS 和 HTTP/3 的 Laravel 应用，不依赖 Nginx 或 PHP-FPM，所有服务由单个二进制统一承载。
第1天：安装与验证环境
在终端中执行安装脚本，将 FrankenPHP 二进制文件放入系统路径并立即验证其内置 PHP 环境是否可用。
运行 curl https://frankenphp.dev/install.sh | sh → 执行 sudo mv frankenphp /usr/local/bin/ → 运行 frankenphp -v 查看版本号。
这一步操作起来很简单，直接把文件拖进去就行。但注意：【必须确认输出中包含 PHP 版本号（如 8.2.x）且无“command not found”报错】，否则后续所有 PHP 扩展加载和脚本执行都会失败。
立即学习“PHP免费学习笔记（深入）”；
第2天：跑通第一个 PHP 页面
不需要写任何配置文件，FrankenPHP 默认监听 8080 端口并自动提供静态文件服务和 PHP 解析能力。
新建目录 ~/myapp → 在其中创建 index.php，内容为 <?php echo "Hello from FrankenPHP"; ?> → 进入该目录后执行 frankenphp。
打开浏览器访问 http://localhost:8080，看到页面即表示基础运行时已就绪。此时 FrankenPHP 已同时充当 Web 服务器和 PHP 执行器，无需额外进程。
第3天：用 Caddyfile 配置域名与 HTTPS
FrankenPHP 使用标准 Caddyfile 语法，自动集成 Caddy 的 ACME 客户端，可一键启用 Let's Encrypt 证书。
方法一：本地测试启用自签名证书
在项目根目录创建 Caddyfile，内容为：
localhost {
php_server
}然后运行 frankenphp，浏览器访问 https://localhost:8080 即可（忽略证书警告）。
方法二：生产环境启用真实 HTTPS
将 Caddyfile 中的域名改为公网可解析的域名（如 myapp.example.com），确保 DNS 已指向服务器 IP → 启动 FrankenPHP → 它会自动向 Let's Encrypt 申请证书并每 90 天续期一次。
注意：首次申请需服务器开放 80 和 443 端口，且域名解析必须生效，否则卡在 ACME 挑战阶段无法继续。
第4天：接入 Laravel 并启用经典模式
FrankenPHP 的经典模式（classic）完全兼容传统 Laravel 部署方式，无需修改任何代码或框架逻辑。
第一步：准备 Laravel 项目
使用 composer create-project laravel/laravel myapp 初始化项目 → 将 public 目录下所有文件（含 index.php）移至项目根目录 → 删除原 public 文件夹。
第二步：调整入口路径
编辑根目录下的 index.php，将 require __DIR__.'/vendor/autoload.php'; 上方的两行路径修正为：$app = require_once __DIR__.'/bootstrap/app.php';<br>$kernel = $app->make(Illuminate\Contracts\Http\Kernel::class);
第三步：启动服务
在项目根目录运行 frankenphp，访问 http://localhost:8080 即可看到 Laravel 欢迎页。此时所有路由、中间件、数据库连接均正常工作。
第5天：开启 Worker 模式榨取性能
Worker 模式让 Laravel 应用常驻内存，跳过每次请求重复加载框架、注册服务、编译容器的过程，实测响应时间降低 58%。
① 安装 Octane 支持包：composer require laravel/octane
② 发布配置文件：php artisan octane:install
③ 修改 config/octane.php，将 'server' => 'frankenphp'
④ 创建 worker.php 入口文件（FrankenPHP 要求），内容为：<?php<br>use Laravel\Octane\Octane;<br>return Octane::server('frankenphp')->start();
⑤ 启动 worker 模式：frankenphp --worker
此时 FrankenPHP 不再按请求启动新进程，而是复用已初始化的 Laravel 应用实例。注意：【所有全局变量、静态属性、未清理的单例对象会在请求间残留，务必确保代码无状态】。
第6天：配置 PHP 扩展与 OPcache
FrankenPHP 内置常用扩展，但部分 Laravel 生产依赖（如 pdo_mysql、redis、opcache）需显式启用。
运行 frankenphp php-cli -m | grep pdo 查看当前已启用的扩展列表 → 若缺失关键扩展，使用 install-php-extensions 工具安装（Docker 环境）或手动编译（Linux 主机）。
在 Caddyfile 中添加 PHP 配置块：
{
frankenphp {
php_ini opcache.enable 1
php_ini opcache.memory_consumption 256
php_ini opcache.max_accelerated_files 20000
}
}OPcache 是提升性能的关键，未启用时 Worker 模式优势会被大幅削弱；启用后首次请求稍慢（预热），后续请求直击内存字节码。
第7天：压测与日志诊断
使用 ab 或 hey 对比 classic 与 worker 模式的真实吞吐能力，并通过 FrankenPHP 内置指标端口定位瓶颈。
启动指标服务：frankenphp --metrics → 访问 http://localhost:9090/metrics 获取 Prometheus 格式指标数据 → 查看 frankenphp_http_requests_total 和 frankenphp_php_worker_uptime_seconds。
用 hey -n 1000 -c 50 http://localhost:8080/ 分别对 classic 和 worker 模式发起压测 → 对比 QPS、平均延迟、P95 延迟三项核心指标。
若 worker 模式下出现内存持续增长，检查是否有未释放的资源句柄（如 PDO 连接未 close、Redis 连接未断开）或静态缓存未设 TTL。
