Worker::$eventLoopClass = \Workerman\Events\Swoole::class 会报错,因该类仅为废弃的空壳适配器,未实现完整事件循环,且在 PHP 8+ 下 TcpConnection 构造函数第3参数 $remoteAddress 接收 null 导致 TypeError。

不能直接用 Swoole 扩展替换 Workerman 的事件循环,除非你手动修补类型错误或降级 PHP 版本——Workerman 官方未适配 Swoole 作为 EventLoop,且 PHP 8+ 下会因 TcpConnection 构造函数参数类型不匹配而崩溃。
为什么 Worker::$eventLoopClass = \Workerman\Events\Swoole::class 会报错?
Workerman 的 \Workerman\Events\Swoole 类只是个空壳适配器,并未实现完整事件循环逻辑。它依赖 Swoole 的 swoole_event_* 系列函数(如 swoole_event_add),但这些函数在 Swoole 4.8+ 中已被标记为废弃,且在 PHP 8.0+ 严格类型检查下,TcpConnection 的第 3 个参数 $remoteAddress 可能传入 null,触发 TypeError。
常见错误信息长这样:
TypeError: Workerman\Connection\TcpConnection::__construct(): Argument #3 ($remoteAddress) must be of type string, null given
- 该问题在
workerman/gateway-worker v4.0.0及更早版本中稳定复现 - 不是配置遗漏,是类设计与 Swoole 运行时行为不兼容
- 即使强制绕过(如 patch 构造函数默认值),后续
onMessage/onClose回调也可能丢失上下文
想用 Swoole 的 event loop,实际可行的路径只有两条
第一种:放弃 Workerman,改用原生 Swoole Server —— 它自带完整的 Reactor + Worker 事件轮询,支持协程、异步 MySQL、HTTP/2 等,无需胶水层。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
第二种:坚持用 Workerman,但只把 Swoole 当作「协程 HTTP 客户端」来用,不碰事件循环 —— 即保留 Workerman 默认 EventLoop(如 libev),仅在业务回调里用 Swoole\Coroutine\Http\Client 发请求。
- Workerman 启动仍走
Worker::runAll(),事件调度由 libev 处理 - 所有耗时 IO(如调第三方 API)放进
Swoole\Coroutine\run()匿名函数内执行 - 避免在
onMessage中直接 new Swoole client;应提前初始化并复用连接池 - 注意:Swoole 协程不能跨 Workerman 进程共享,每个 Worker 进程需独立维护自己的协程上下文
Swow 是目前唯一被 Workerman 官方文档明确支持的协程替代方案
如果你真需要协程化 I/O 调度,Swow 比 Swoole 更稳妥 —— 它专为 PHP 8+ 设计,API 兼容性更好,且 Workerman 4.1.0+ 明确提供了接入路径。
- 必须满足:
PHP ≥ 8.0、已启用swow扩展(php -m | grep swow有输出)、Worker::$eventLoopClass = \Swow\EventLoop::class - 必须禁用 daemon 模式:
php start.php start(不能加-d),否则 fork 后协程状态丢失 - 必须关闭 Workerman 自带定时器:
Worker::$timerInterval = 0,否则与 Swow 的Timer冲突 - 监听 socket 会自动设为非阻塞,但若手写
stream_socket_server,需显式加STREAM_SERVER_BIND | STREAM_SERVER_LISTEN | SOCK_NONBLOCK
真正难的不是换 EventLoop,而是确认你是否真的需要它。大多数场景下,Workerman + 异步客户端(如 workerman/http-client 或 Swoole\Coroutine)已足够;强行拔高到协程事件轮询,反而引入进程模型、上下文切换、调试难度三重复杂度。

















