最简TCP服务只需四行代码：$server = new Swoole\Server('127.0.0.1', 9501); $server->on('receive', function($server, $fd, $from_id, $data) { $server->send($fd, "OK\n"); }); $server->start();——注意扩展启用、端口未被占用、必须设置on('receive')回调，且start()后代码不再执行。
怎么用 Swoole\Server 启动一个最简 TCP 服务
直接能跑起来的最小代码就是核心——不是配环境、不是装扩展，而是确认 swoole 已启用后，三行初始化 + 一行启动即可。
常见错误现象：Fatal error: Class 'Swoole\Server' not found，说明 PHP 没加载 swoole 扩展，不是代码写错了；bind() failed. Address already in use 是端口被占，换 9501 以外的端口试试。
-
$server = new Swoole\Server('127.0.0.1', 9501);—— 地址建议写'127.0.0.1'而非'0.0.0.0'，本地调试更安全，也避免 Docker 或云主机里权限问题 - 必须设置
on('receive')回调，否则连上就断，客户端收不到任何响应 - 启动前不用
set_time_limit(0)，swoole 进程本身不走 PHP CLI 的超时逻辑
on('receive') 回调里怎么安全读写数据
TCP 是流式协议，on('receive') 触发时收到的不一定是“一条完整消息”，可能是半包、粘包，别一上来就 json_decode($data) 硬解析。
使用场景：做简单命令交互（如 time 返回当前时间）、透传二进制帧头、或配合自定义分隔符（比如每条以 \n 结尾）。
- 如果协议简单，用
explode("\n", $data)拆分，但得先rtrim($data, "\n\r")清理末尾 - 不要在回调里执行
sleep()或同步 MySQL 查询，会阻塞整个事件循环；改用Swoole\Coroutine\MySQL或投递到task进程 -
$fd参数是客户端连接唯一 ID，可用于单聊广播，但它在连接断开后失效，不能长期存数据库当用户 ID 用
为什么 start() 后脚本不退出，也没日志输出
这是 swoole 和传统 PHP 最反直觉的一点：$server->start() 是阻塞调用，进程进入事件循环，之后的代码根本不会执行。所谓“后台运行”其实是它自己 fork 出 master + worker 进程，不是靠 & 或 nohup。
性能影响：默认只起 1 个 worker 进程，压测时 QPS 上不去，得显式设 $server->set(['worker_num' => 4])；但别盲目设太高，超过 CPU 核数反而因上下文切换拖慢。
- 想看启动日志？加
$server->set(['log_file' => '/tmp/swoole.log'])，否则默认输出到 stderr，CLI 下看不见 - 修改代码后要手动
kill -USR1 $(cat /tmp/swoole.pid)热重启，swoole 不支持像 Node.js 那样文件监听自动重载 - 别在
on('start')里写var_dump()，stdout 被重定向了，看不到；要用swoole_error_log()或写文件
客户端连不上？检查这三处网络配置
90% 的“连不上”和 swoole 代码无关，是本地防火墙、Docker 网络或云服务器安全组卡的。
兼容性影响：macOS 默认开启防火墙，Windows WSL2 的端口映射规则和原生 Linux 不同，阿里云 ECS 必须在控制台开安全组端口，光改 iptables 没用。
- 先用
telnet 127.0.0.1 9501在服务端本机测试，通了再查外部访问 - Docker 运行时加
-p 9501:9501，且Swoole\Server构造函数里地址必须是'0.0.0.0'，不能是'127.0.0.1' - 云服务器上
netstat -tuln | grep 9501看是否监听在*:9501，如果是127.0.0.1:9501就只能本地连
真正麻烦的是协议层分包逻辑和多进程间状态共享，那已经不是“基础搭建”该碰的问题了。
