frankenphp二进制本身不支持--daemon参数，必须通过systemd管理实现守护进程：需创建.service文件，设type=simple、restart=always、workingdirectory为项目根目录，并用journalctl查日志排错。
frankenphp 二进制如何以守护进程方式启动
FrankenPHP 本身不内置 daemon 化能力（比如 --daemon 参数），它默认前台运行。想让它常驻后台、开机自启、崩溃自动拉起，必须靠系统级进程管理工具，而不是改 frankenphp 命令本身。
最稳妥、生产推荐的方式是用 systemd —— 它能精准控制启动顺序、资源限制、重启策略、日志归集，且所有主流 Linux 发行版都原生支持。
-
frankenphp php-server -r public/这类命令不能直接丢进nohup &或screen：它依赖标准输入/输出做信号交互，且无法感知子进程异常退出 - systemd 单元文件里必须显式设置
Type=simple（不是forking），因为 frankenphp 不会自行 double-fork - 务必加
Restart=always和RestartSec=5，否则 PHP 扩展崩溃或未捕获异常会导致服务静默退出 - 工作目录（
WorkingDirectory）必须设为 Laravel 项目根目录，否则-r public/会找不到路由入口
示例 /etc/systemd/system/frankenphp.service：
[Unit] Description=FrankenPHP Laravel Server After=network.target [Service] Type=simple User=www-data WorkingDirectory=/var/www/my-laravel-app ExecStart=/usr/local/bin/frankenphp php-server -r public/ Restart=always RestartSec=5 Environment=APP_ENV=production StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target
为什么不能用 supervisor 或 pm2 管理 frankenphp
supervisor 和 pm2 都是通用进程管理器，但它们对 FrankenPHP 有兼容性风险：
- supervisor 的
autostart=true在系统启动早期可能触发过早，此时 Caddy 内置的 Let's Encrypt 证书申请会因网络未就绪失败，且 supervisor 不会重试 HTTPS 初始化 - pm2 默认用
fork模式启动，而 frankenphp 是单进程模型，pm2 的 watch + restart 机制容易和 frankenphp 自身的 worker 热更新冲突，导致端口被重复绑定 - 两者都不原生支持 HTTP/3 或 TLS 证书生命周期管理 —— 这些本该由 FrankenPHP 内置的 Caddy 层处理，外层再套一层反而干扰证书自动续期
结论：systemd 是唯一能与 FrankenPHP 的 Caddy+PHP 融合架构对齐的进程管理方案。
常见启动失败原因与检查点
服务启用后 systemctl status frankenphp 显示 failed 或 activating (start) 卡住，优先排查这几点：
- 端口被占：
sudo ss -tulpn | grep ':80\|:443'—— FrankenPHP 默认监听 80/443，若 Nginx/Apache 已在运行，必须先停掉 - 权限不足：确保
User=www-data对public/和storage/有读写权，特别是storage/logs/和storage/framework/ - 扩展缺失：运行
frankenphp php-cli -m | grep -E 'pdo|openssl|mbstring'，确认 Laravel 必需扩展已启用（如pdo_mysql缺失会导致APP_KEY解密失败） - Caddyfile 冲突：如果自定义了
Caddyfile，注意其中php_server指令不能和php-server命令行参数重复，否则端口绑定冲突
systemd 日志是第一手线索：journalctl -u frankenphp -f 能实时看到 PHP 启动时的 fatal error 或扩展加载失败信息，比反复试错快得多。
真正麻烦的不是启动，而是让 FrankenPHP 在证书自动续期、OPcache 预热、worker 模式热重载这些环节不掉链子 —— 这些都依赖 systemd 正确传递环境变量和信号，而不是靠脚本临时打补丁。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
