必须基于Swoole异步非阻塞IO构建TCP服务，步骤包括安装验证、创建服务器、注册connect/receive/close事件、启动服务，并配置worker数、Nagle算法关闭、粘包处理、心跳保活及安全加固。
要在生产环境中稳定支撑数万并发连接、低延迟响应的TCP服务，必须绕过PHP-FPM同步阻塞模型，直接基于Swoole的异步非阻塞IO和协程机制构建服务器。这要求从协议选择、进程配置、事件处理到粘包解决全程精准控制。
创建并启动基础TCP服务器
第一步：确保已安装 Swoole 扩展（PHP 8.1+ 推荐使用 v6.1.1 或更高稳定版），执行 php -m | grep swoole 验证加载成功。
第二步：新建 server.php 文件，写入以下最小可行代码：
$server = new Swoole\Server('0.0.0.0', 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP);
第三步：注册核心事件——【必须注册 onConnect/onReceive/onClose，否则客户端连接后立即断开】：
$server->on('connect', fn($server, $fd) => printf("Client %d connected\n", $fd));$server->on('receive', fn($server, $fd, $reactor_id, $data) => $server->send($fd, "Echo: " . $data));$server->on('close', fn($server, $fd) => printf("Client %d closed\n", $fd));
第四步：调用 $server->start() 启动服务。此时服务已在后台运行，监听 9501 端口。
关键性能调优配置
不加配置的默认参数在高并发下极易成为瓶颈。需在 $server->set() 中显式声明：
方法一：按 CPU 核心数动态设参（推荐）
$server->set([ 'worker_num' => swoole_cpu_num() * 2, 'reactor_num' => swoole_cpu_num(), 'max_conn' => 65535, 'open_tcp_nodelay' => true, 'backlog' => 128]);
方法二：硬编码适配中小规模部署（开发/测试环境）
'worker_num' => 4 —— 少于 CPU 核心数会导致资源闲置；大于 8 倍则引发进程调度争抢，反而降低吞吐。
【open_tcp_nodelay 必须设为 true，否则小数据包会因 Nagle 算法被合并延迟发送，实测延迟从 2ms 升至 200ms+】
正确处理 TCP 粘包与拆包
TCP 是流式协议，onReceive 回调收到的数据不等于一次 send 的完整业务单元。不处理粘包将导致协议解析失败。
步骤一：选用内置包解析器（最简方案）
在 $server->set() 中添加：
'package_max_length' => 1024 * 1024,'package_length_type' => 'N','package_length_offset' => 0,'package_body_offset' => 4
这表示每个包前 4 字节为 uint32_t 类型长度字段，后续为实际内容——客户端需先发 4 字节长度，再发对应字节数数据。
步骤二：若协议固定分隔符（如 \n），改用：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
'open_eof_split' => true,'package_eof' => "\n"
注意：此方式严禁传输含换行符的二进制数据，否则提前截断。
实现长连接状态管理与心跳保活
真实业务中客户端不会频繁重连，需维护连接上下文并防超时断连。
第一步：在 onConnect 中为每个 $fd 存储用户标识或会话信息：
$server->connection_info($fd)['uid'] = gen_uid(); // 示例生成逻辑
第二步：启用心跳检测（避免僵尸连接占用 fd）：
'heartbeat_check_interval' => 30,'heartbeat_idle_time' => 60
第三步：主动踢出异常连接（在 onReceive 中判断空数据或非法格式）：
if (empty($data)) { $server->close($fd); return; }
这一步不能省略——空包可能是探测包，也可能是连接已断但未触发 onClose 的残留状态。
安全加固与生产就绪配置
上线前必须关闭调试输出、限制资源、启用日志归档：
方法一：禁用所有 var_dump / echo 输出
'log_file' => '/var/log/swoole/server.log','log_level' => SWOOLE_LOG_ERROR,'daemonize' => 1
方法二：防止内存泄漏导致 worker 崩溃
'max_request' => 5000 —— 每个 worker 处理 5000 请求后自动重启，强制释放 PHP 内存引用。
方法三：绑定指定网卡避免暴露内网地址
把 '0.0.0.0' 替换为实际监听 IP，例如 '192.168.1.100'。
执行 php server.php 启动服务。
