udp服务器必须显式指定swoole_sock_udp类型,否则默认创建tcp服务器;udp无连接,仅支持onpacket事件,不支持onconnect/onclose及fd操作,客户端须用sendto而非connect。

UDP服务器必须显式指定 SWOOLE_SOCK_UDP 类型
不写或写错类型,Swoole\Server 默认创建的是 TCP 服务器。哪怕端口监听成功,客户端用 UDP 发包也收不到——因为底层协议栈根本没打开 UDP 套接字。
正确写法是:
$server = new Swoole\Server('127.0.0.1', 9502, SWOOLE_PROCESS, SWOOLE_SOCK_UDP);
常见错误包括:
- 漏掉第四个参数,误用
new Swoole\Server('127.0.0.1', 9502)—— 这仍是 TCP - 传入字符串如
"udp"或数字2,而非常量SWOOLE_SOCK_UDP - 在协程风格中混用
Swoole\Http\Server或Swoole\WebSocket\Server,它们不支持 UDP
TCP 的 onConnect/onClose 事件在 UDP 中完全不存在
UDP 是无连接协议,没有“建立连接”和“断开连接”的概念,所以 onConnect、onClose 回调注册了也不会触发。强行注册只会浪费资源,还可能误导逻辑判断。
UDP 唯一的数据入口是 onPacket,它接收三个参数:$server、$data、$client_info(含 address 和 port)。你必须靠 $client_info 自行识别来源,不能依赖 $fd(该变量在 UDP 中无效)。
典型误用:
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 在 UDP server 中写
$server->on('Connect', ...)并期待日志输出 - 试图调用
$server->close($fd)—— UDP 不支持关闭单个客户端会话 - 把 TCP 的
$fd当作客户端标识缓存,结果发现每次onPacket的$fd都是0或随机值
set() 配置项对 TCP 和 UDP 的生效逻辑不同
部分配置项只对 TCP 有意义,Swoole 不会报错,但实际不生效。例如:
-
heartbeat_idle_time和heartbeat_check_interval:仅作用于 TCP 连接,UDP 无心跳机制 -
open_tcp_nodelay:TCP 专用选项,UDP 不涉及 Nagle 算法 -
open_eof_split、package_max_length:这些是为解决 TCP 粘包设计的,UDP 天然按报文边界收发,设了也无效
但以下配置项两者都可用:
-
worker_num:影响处理并发 packet 的能力 -
daemonize、log_file:进程与日志控制通用 -
dispatch_mode:UDP 同样支持按 IP/PORT 哈希分发(mode=4),避免单 worker 过载
客户端发送方式根本不同:TCP 要 connect(),UDP 直接 sendto()
TCP 客户端必须先调用 $client->connect() 建立连接,之后才能 send()/recv();而 UDP 客户端压根不需要 connect,直接 sendto($ip, $port, $data) 即可。
如果你用 TCP 客户端代码去连 UDP 服务端(或反过来),会出现:
- TCP client 调
connect()到 UDP 端口 → 返回Connection refused(系统层拒绝) - UDP client 调
send()(非sendto)→ 报错Operation not supported - UDP client 忘记传
$port给sendto()→ 数据发到 0 端口,服务端收不到
务必核对客户端构造时的协议类型:
$tcp_client = new Swoole\Client(SWOOLE_SOCK_TCP); // 必须 connect $udp_client = new Swoole\Client(SWOOLE_SOCK_UDP); // 用 sendto,不 connect
最易被忽略的一点:UDP 没有连接状态,也就没有“连接超时”“重连”“连接池”这些概念。所有可靠性保障(比如重传、应答、顺序)都得你自己在应用层实现,Swoole 不介入。










