必须设置onreceive，否则swoole_server->start()直接失败；tcp/udp server依赖onreceive作为数据入口，http用onrequest，websocket用onmessage/onopen。
必须设置 onReceive，否则 swoole_server->start() 会直接失败——这是最常被忽略的硬性约束。
为什么没写 onReceive 就启动不了
不是警告，是 fatal error：Swoole 在启动校验阶段会明确检查该回调是否存在。TCP/UDP Server 必须有数据入口，onReceive 就是这个入口。HTTP Server 要用 onRequest，WebSocket Server 要用 onMessage 或 onOpen，但普通 swoole_server 实例只认 onReceive。
常见错误现象：
- 报错
Fatal error: Uncaught RuntimeException: onReceive callback is not set - 调用
$serv->start()后进程立即退出，无日志、无监听端口 - 误以为是配置问题（比如
worker_num设太小），实际根本没走到配置加载后阶段
解决方式就一条：$serv->on('receive', function($serv, $fd, $reactor_id, $data) { /* 至少 echo 或 return */ }); ——哪怕空函数体也得有。
onStart 里只能干三件事
它运行在 Master 进程主线程，此时 Worker 和 Manager 进程已 fork 完毕但尚未开始处理请求。能做的只有：
- 输出日志（
echo/error_log） - 调用
swoole_set_process_name()改进程名 - 把
$serv->master_pid和$serv->manager_pid写入文件供外部脚本控制
不能做的事比能做的多得多：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 不能 new 对象或 require 文件（可能引发进程间资源竞争）
- 不能连接数据库、Redis、发起 HTTP 请求（这些操作会阻塞 Master 进程）
- 不能调用
sleep()、usleep()等同步等待函数 - 不能使用协程（Master 进程不启用协程调度器）
注意：onStart 和 onWorkerStart 是并发执行的，不存在“等 Worker 启动完再执行”的逻辑。想在 Worker 中初始化 DB 连接，请放到 onWorkerStart 回调里。
onConnect / onClose 在 UDP 下无效
UDP 是无连接协议，onConnect 和 onClose 根本不会触发。如果你写了却没看到日志，不是代码错了，是协议不支持。
正确做法：
- UDP 场景下只依赖
onReceive（或显式设置onPacket）接收数据包 - 如果需要模拟连接状态，得自己维护
$serv->connections或用Server->getClientInfo($fd)查客户端地址做白名单/限流 - 别试图在
onReceive里调$serv->close($fd)—— UDP 没有 fd 可关，调了会静默失败
容易踩的坑：把 TCP 的连接管理逻辑原样搬进 UDP Server，结果发现 onConnect 日志永远不出现，还怀疑是防火墙或 bind 失败。
回调函数传参差异和兼容性陷阱
不同版本 Swoole 对参数顺序和类型处理略有差异，尤其要注意：
-
onReceive第三个参数在旧版叫$from_id，新版文档统一为$reactor_id，但实际值一样，都是 reactor 线程编号 -
onWorkerStart的第二个参数是$worker_id（从 0 开始），不是 PID；PID 要用$serv->worker_pid - 回调函数名大小写不敏感（
'START'、'Start'、'start'都行），但建议全小写保持一致性 - PHP 8.1+ 使用静态方法回调时，若类方法未声明
static，会抛TypeError
最隐蔽的问题：在 onWorkerStart 里初始化的 PDO 实例，如果没设 PDO::ATTR_PERSISTENT => true，下次请求时连接可能已断——因为 Worker 进程复用，但连接超时由 MySQL server 控制，不是 Swoole 管的。
