swoole中不存在socket_bind_port函数，实现多端口监听的唯一合法方式是addlistener，它封装了socket创建、bind、listen全流程并注册到reactor；调用后必须检查返回值以防静默失败。
没有 socket_bind_port 这个函数，Swoole 中实现多端口监听的唯一合法方式是调用 addlistener（或旧版写法 listen），它不是 PHP 原生 socket 函数的封装，也不涉及底层 bind() 调用细节。
为什么搜不到 socket_bind_port
Swoole 源码和文档中均不存在 socket_bind_port。这个名称可能是混淆了以下几种情况：
- 把 PHP 原生
socket_bind()和 Swoole 的端口监听机制混为一谈 - 误记了某些第三方封装库或旧版非官方扩展的命名
- 将
addlistener($host, $port, $type)的参数语义理解成“绑定端口”，进而脑补出该函数名
真正起作用的是 addlistener —— 它在 Swoole 内部完成 socket 创建、bind()、listen() 全流程，并注册到 reactor 线程中。
addlistener 失败时不会报错，但返回 false
这是最常被忽略的致命点：调用 addlistener 后如果不检查返回值，端口监听失败会静默跳过，进程照常启动，但对应端口根本没起来。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 常见错误现象：
netstat -tuln | grep :9502查不到监听，curl http://127.0.0.1:9502直接 connection refused，日志里却没有任何提示 - 必须显式判断：
if (!$server->addlistener('0.0.0.0', 9502, SWOOLE_SOCK_TCP)) { throw new RuntimeException('failed to listen on 9502'); } - 失败原因通常是端口被占用、权限不足（如非 root 绑定 1–1023 端口）、IP 不可用（如指定
192.168.1.100但网卡没配该地址）
不同协议端口必须用匹配的回调和处理逻辑
TCP 和 UDP 看似都用 addlistener，但后续事件模型完全不同，不能复用同一套回调。
- TCP 端口必须注册
on('connect')、on('receive')、on('close') - UDP 端口只能用
on('packet')，且收发地址格式是字符串（如'127.0.0.1:12345'），不是$fd - HTTP/WS 端口必须启用对应协议开关：
'open_http_protocol' => true或'open_websocket_protocol' => true，否则请求会被丢弃 - SSL 端口需额外配置
ssl_cert_file和ssl_key_file，且协议类型要带SWOOLE_SSL标志
业务逻辑区分端口不能只靠 port 号，得用 from_fd
虽然每个 addlistener 返回的 Swoole\Server\Port 对象可单独设回调，但若你选择统一用主 on('receive') 处理所有 TCP 端口，就不能只比对 $info['from_port'] —— 因为 from_port 是客户端发起连接的目标端口，在 NAT 或代理后可能失真。
- 正确做法是用
$serv->connection_info($fd)获取'from_fd'字段，它指向该连接所属的监听器索引（即$serv->ports[$from_fd]） -
$serv->ports是一个数组，下标从 0 开始，主端口是$serv->ports[0]，第一个addlistener返回的是$serv->ports[1]，依此类推 - 更稳妥的写法：
$listener = $serv->connection_info($fd)['from_fd']; if ($listener === 1) { /* 处理 9502 端口逻辑 */ }
多端口本身不难，难的是每个端口背后隐含的协议栈差异、资源隔离边界和错误传播路径——这些地方不提前踩一遍，上线后问题往往出现在最意想不到的环节。
