【面试点拨】Swoole 中的多端口监听（addlistener）-Swoole-PHP中文网

根本原因是addlistener必须在start()前调用，且仅限master进程；若在workerstart等子进程上下文中调用会直接报错，运行时无法动态增删监听端口。

【面试点拨】swoole 中的多端口监听（addlistener）

为什么 `addlistener` 调用后新端口没生效？

常见现象是调用 addlistener 成功返回，但 telnet 或 curl 无法连上新端口。根本原因通常是：监听必须在 start 之前完成，且不能在 WorkerStart 回调里补加——Swoole 的监听列表在 master 进程启动时就已固化，worker 进程无权修改。

实操建议：

所有 addlistener 必须写在 Server->start() 之前，通常放在 Server 实例化之后、配置完 set() 之后
若需动态增删端口（如热加载），得走进程间通信 + 重启 worker 或用 reload 信号配合主监听端口转发，addlistener 本身不支持运行时变更
注意端口是否被占用或防火墙拦截，可用 netstat -tuln | grep :端口号 确认监听状态

`addlistener` 返回的 `$port` 对象能做什么？

它不是普通对象，而是继承自 Swoole\Server\Port 的实例，代表该监听端口的独立配置入口。你不能再用它调 start()，但可以单独设置协议行为和回调：

可为每个端口单独指定 onReceive、onConnect、onClose —— 比如 HTTP 端口用 onRequest，WebSocket 端口用 onOpen/onMessage
可单独调用 set() 设置超时、缓冲区大小等，例如 $ws_port->set(['open_websocket_protocol' => true])
不能调 addProcess 或改全局 onWorkerStart，这些仍由主 Server 控制

示例：

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。

下载

$http_port = $server->addlistener('0.0.0.0', 9501, SWOOLE_SOCK_TCP);
$http_port->on('request', function ($req, $resp) { $resp->end('HTTP'); });
<p>$ws_port = $server->addlistener('0.0.0.0', 9502, SWOOLE_SOCK_TCP);
$ws_port->set(['open_websocket_protocol' => true]);
$ws_port->on('message', function ($server, $frame) { /<em> ... </em>/ });</p>

TCP/UDP/SSL 端口混用时要注意什么？

同一 Server 可混合添加不同协议监听，但类型一确定就不能改，且资源隔离不等于完全独立：

UDP 端口只能绑定 SWOOLE_SOCK_UDP，不能设 open_websocket_protocol 或 http_parse_post，否则静默忽略
SSL 端口必须在 set() 中提前配好 ssl_cert_file 和 ssl_key_file，且 addlistener 第三个参数得是 SWOOLE_SOCK_TCP | SWOOLE_SSL
多个 TCP 端口共享同一个 reactor 线程池（除非显式设 reactor_num），高并发下可能互相影响，必要时用 task_worker_num > 0 卸载耗时逻辑
Unix socket 监听路径长度有限制（通常 108 字节），且需确保运行用户有读写权限