FrankenPHP必须用systemd托管才能稳定常驻运行，因裸跑无进程生命周期管理，崩溃不自愈、重启不拉起；worker模式下需Type=exec、Environment=FRANKENPHP_WORKER=1、Restart=always等配置保障高可用。
FrankenPHP 必须用 systemd 托管才能稳定常驻运行，裸跑 frankenphp 命令只适合调试；worker 模式下进程一旦退出，systemd 能立刻拉起，否则 PHP 应用就彻底掉线。
为什么不能直接后台运行 frankenphp 命令
很多人试过 nohup frankenphp start & 或 screen，结果是：终端一关、SSH 断开、或系统重启后，进程就没了。更关键的是，FrankenPHP 在 worker 模式下如果因内存溢出、扩展崩溃或 SIGSEGV 退出，没有任何机制能自动恢复——它不像传统 FPM 那样有 master 进程兜底。裸跑等于把生产服务交给了 shell 生命周期，而不是系统级守护。
常见错误现象包括：
- 开机后 FrankenPHP 没启动，
curl localhost:8080直接 connection refused - 日志里出现
panic: runtime error后进程消失，但没人知道发生了什么 - worker 模式下 PHP 内存持续增长，OOM Killer 杀掉进程后服务静默中断
frankenphp.service 关键配置项怎么写
服务单元文件必须明确区分普通模式和 worker 模式，因为启动命令、环境变量、重启策略完全不同。以下是最小可用配置（以 worker 模式为例）：
立即学习“PHP免费学习笔记（深入）”；
[Unit] Description=FrankenPHP Worker Service After=network.target StartLimitIntervalSec=0 [Service] Type=exec User=www-data Group=www-data WorkingDirectory=/var/www/myapp Environment=FRANKENPHP_WORKER=1 Environment=APP_ENV=production ExecStart=/usr/local/bin/frankenphp serve --config /var/www/myapp/Caddyfile Restart=always RestartSec=3 KillMode=process LimitNOFILE=65536 [Install] WantedBy=multi-user.target
重点说明：
-
Type=exec：FrankenPHP 是单进程模型，不是 fork+daemon 化程序，不能用Type=forking，否则 systemd 会误判主进程已退出 -
Environment=FRANKENPHP_WORKER=1：这是启用常驻内存模式的开关，缺了这行，PHP 就是每次请求都重新加载，worker 模式形同虚设 -
Restart=always+RestartSec=3：确保崩溃后快速拉起，避免请求丢失；StartLimitIntervalSec=0禁用启动频率限制，防止连续崩溃被 systemd 锁死 -
KillMode=process：只杀主进程，不波及子线程（比如 Caddy 的 TLS 协程或 PHP 的 GC 线程），避免误杀
worker 模式下 PHP 内存泄漏怎么监控和兜底
FrankenPHP 的 worker 模式让 PHP 进程长期存活，但框架或扩展的内存泄漏不会自动释放。systemd 本身不提供内存阈值重启，得靠组合策略：
- 在
[Service]段加MemoryMax=512M（需 systemd v240+），超过后自动 kill 并触发Restart=always - 配合
journalctl -u frankenphp.service -f实时观察日志，留意memory_limit超限或zend_mm_heap corrupted类报错 - 不要依赖
php.ini的memory_limit，FrankenPHP 的 worker 进程绕过了 CLI 的内存限制逻辑，必须由 systemd 层面硬控 - 若用 Laravel/Symfony，建议在
Caddyfile中配php_backend时加上max_requests 1000参数，强制每处理千次请求后优雅重启 worker
日志和调试时容易忽略的三个点
systemd 日志默认走 journald，但 FrankenPHP 的内部 PHP 错误（比如未捕获异常、error_log() 输出）不会自动进 journal，需要显式配置：
- 在
Caddyfile的php_backend块里加log { output stdout }，否则 PHP 的error_log()会丢弃 - systemd 的
StandardOutput=journal和StandardError=journal必须显式写出，否则部分输出可能被截断或重定向到 /dev/null - 调试时别只看
systemctl status frankenphp，要执行journalctl -u frankenphp.service -o cat -n 100，-o cat能避免 ANSI 转义干扰，看清原始 PHP 错误堆栈
worker 模式真正的复杂点不在启动，而在生命周期管理：它把“PHP 进程该什么时候重启”这个本该由 FPM master 做的决策，交给了你——通过 systemd 的资源限制、Caddy 的 max_requests、以及应用自身的健康检查共同完成。漏掉任意一环，都可能让服务在看似正常的情况下缓慢退化。
