最简Worker脚本必须显式调用frankenphp_handle_request()、禁止exit/die、初始化逻辑置于循环外；否则进程启动即退出或无法响应后续请求，因传统index.php依赖PHP-FPM“一次请求一次执行”模型，而Worker模式需常驻复用且手动管理生命周期。
最简 Worker 脚本必须满足三个硬性条件：显式调用 frankenphp_handle_request()、不 exit 或 die、所有初始化逻辑放在循环外。缺一不可，否则进程启动即退出或无法响应后续请求。
为什么不能直接用 public/index.php 当 Worker 脚本
传统 index.php 依赖 PHP-FPM 的“一次请求、一次执行”模型：它读取 $_SERVER、解析路由、输出响应、然后自然结束。Worker 模式下，这个脚本会被长期加载，exit 会让整个 worker 进程终止；未重置的静态变量、全局数组、数据库连接会跨请求残留；$_SERVER 的某些字段（如 REQUEST_URI）在 FrankenPHP 中由 Go 层动态注入，不是固定值。
- 常见错误现象：
curl http://localhost:8080第一次成功，第二次返回空或 500，日志里出现Segmentation fault或connection reset - 根本原因：脚本里写了
exit、用了static $cache = []缓存用户数据、或在循环内重复require_once 'vendor/autoload.php' - 正确做法：把框架初始化（如
$app = require 'bootstrap/app.php'）写在frankenphp_handle_request()外层；把请求处理逻辑（如$response = $kernel->handle($request)）包进回调函数里
最小可用 Worker 脚本长什么样
以下是一个能跑通、无框架依赖、可验证生命周期的最小示例（保存为 /var/www/worker.php）：
<?php
// 必须：防止客户端断连导致 worker 退出
ignore_user_abort(true);
<p>// 循环外：只执行一次的初始化
$counter = 0;
$startTime = time();</p><p>// 循环内：每次请求都执行的逻辑
$handler = function () use (&$counter, $startTime) {
$counter++;
$response = sprintf(
"Hello from worker! Request #%d. Uptime: %ds",
$counter,
time() - $startTime
);</p><pre class="brush:php;toolbar:false;">// 输出 HTTP 响应头和正文（FrankenPHP 不自动加 Content-Type）
header('HTTP/1.1 200 OK');
header('Content-Type: text/plain; charset=utf-8');
echo $response;};
立即学习“PHP免费学习笔记（深入）”；
// 必须：只调用一次，传入处理函数 frankenphp_handle_request($handler);
// 可选：主动触发 GC，缓解内存缓慢增长 gc_collect_cycles();
- 关键点：
frankenphp_handle_request($handler)是唯一入口，不能包在while (true)里，也不能重复调用 - 路径必须是绝对路径，启动命令得写
--script /var/www/worker.php，写--script worker.php会报failed to open stream - 不要在
$handler外部写echo或header()，那会在进程启动时就输出，破坏 HTTP 协议
启动它之前必须确认的三件事
脚本写完只是第一步，启动失败往往卡在这三个检查点上：
-
--script参数是否用了绝对路径？FrankenPHP 启动后工作目录可能已切换，相对路径必报错 - 是否用
docker run -v $(pwd):/app正确挂载了脚本所在目录？没挂载就只能访问镜像内置文件 - 是否加了
--addr :8081（或其他未被占用端口）？多个 worker 实例必须端口不冲突，否则第二个会因bind: address already in use直接退出
最容易被忽略的是：FrankenPHP 的 Worker 模式不提供任何自动重载、日志聚合或进程保活——它只负责运行你给的脚本。一旦脚本里抛出未捕获异常、或 frankenphp_handle_request() 返回 false，worker 就静默退出。上线前务必用 try/catch 包住 $handler 内容，并写入明确日志。
