Workerman 通过常驻进程与异步I/O多路复用解决PHP-FPM无法高效处理长连接和高并发的问题,适用于WebSocket、IM、实时推送等场景,而非简单堆机器。

Workerman 本身不直接“扩展架构”,它解决的是 PHP 在传统 FPM 模式下无法高效处理长连接、高并发 I/O 的硬伤。用它不是为了堆机器,而是让单机 PHP 服务能扛住 WebSocket、IM、实时推送这类场景的连接压力。
为什么 PHP 原生 HTTP 模型撑不住长连接
PHP-FPM 是“请求-响应”短生命周期模型:每次 HTTP 请求启动进程、加载代码、执行、销毁。它天生不适合维持成千上万个 TCP 连接。一旦你写个 while(true) 持有 socket,FPM 进程就卡死,根本没法复用。
Workerman 绕过了 FPM,自己用 PHP 启动常驻进程(Worker 实例),通过 select/epoll(Linux)或 kqueue(macOS)做异步 I/O 多路复用,让一个进程同时管理数万连接——这不是靠多开进程,是靠事件循环。
- 连接数瓶颈从“每请求一个进程”变成“单进程数万连接”
- 内存占用下降明显:没有重复加载框架、Composer autoloader 的开销
- 无须依赖 Apache/Nginx 转发 WebSocket(
ws://可直连 Workerman 监听的端口)
典型应用场景:哪些业务必须用 Workerman
不是所有项目都需要它。只有当你的业务出现以下信号时,Workerman 才是合理解法:
立即学习“PHP免费学习笔记(深入)”;
-
WebSocket实时通信:聊天室、客服系统、协作编辑(如在线文档光标同步) - 设备长连接网关:IoT 设备心跳上报、指令下发(用
TcpConnection或自定义协议) - 高频低延迟推送:行情刷新、游戏状态同步、工单状态变更通知
- 需要自定义协议的服务:比如二进制协议接入、私有加密信令交互(Workerman 支持
Frame、Http、Text、Json等多种传输层封装)
注意:如果只是“用户量大但仍是 HTTP API”,用 Nginx + PHP-FPM + Redis 缓存 + 数据库读写分离,通常比强行套 Workerman 更稳、更易维护。
产品介绍微趣能 Weiqn 开源免费的微信公共账号接口系统。MVC框架框架结构清晰、易维护、模块化、扩展性好,性能稳定强大核心-梦有多大核心就有多大,轻松应对各种场景!微趣能系统 以关键字应答为中心 与内容素材库 文本 如图片 语音 视频和应用各类信息整体汇集并且与第三方应用完美结合,强大的前后台管理;人性化的界面设计。开放API接口-灵活多动的API,万名开发者召集中。Weiqn 系统开发者AP
和 Swoole 的关键区别:别只看性能数字
很多人一提高性能 PHP 就对比 Workerman 和 Swoole。真实选型要看团队能力和运维水位:
- Workerman 基于纯 PHP 实现,无 C 扩展依赖,
composer require workerman/workerman即装即用,部署在共享主机、Docker、老旧内核上几乎零门槛 - Swoole 是 C 扩展,性能略高(尤其协程调度),但要求 PHP 编译时启用、版本严格匹配;升级 PHP 或 Swoole 版本可能引发
Segmentation fault或协程上下文丢失 - Workerman 的
onMessage/onConnect是回调风格,接近 Node.js 思维;Swoole 协程写法更像同步代码,但需警惕mysql_query这类阻塞调用没切到协程客户端就会拖垮整个进程
小团队、快速验证、PHP 环境受限?Workerman 更安全。已有 DevOps 能力、追求极致吞吐、愿意为协程范式重构?Swoole 更合适。
实际部署要注意的三个坑
Workerman 不是“写完 start.php 就上线”的玩具,生产环境容易翻车:
- 必须用
php start.php start -d守护进程运行,否则终端关闭后进程退出;建议配合supervisord或 systemd 管理生命周期 - 不能在
onMessage回调里直接file_get_contents或curl_exec—— 这些是阻塞 IO,会卡住整个事件循环;要用Workerman\Connection\AsyncTcpConnection或集成GuzzleHttp\Ring\Client\StreamHandler异步客户端 - 全局变量/静态变量在常驻进程中不会重置,
$_SESSION、static $cache = []这类状态会跨连接污染,必须用$connection->session或外置 Redis 存储用户上下文
use Workerman\Worker;
use Workerman\Lib\Timer;
$worker = new Worker('websocket://0.0.0.0:2346');
$worker->count = 4; // 启动 4 个进程,利用多核
$worker->onMessage = function($connection, $data) {
// ❌ 错误:阻塞调用
// $res = file_get_contents('http://api.example.com/status');
// ✅ 正确:异步 HTTP 请求(需额外引入 workerman/http-client)
$client = new \Workerman\Http\Client();
$client->get('http://api.example.com/status', function($response) use ($connection) {
$connection->send($response->getBody());
});
};
Worker::runAll();
真正难的从来不是启动一个 WebSocket 服务,而是怎么让数万个连接稳定在线、消息不丢、状态可追溯、故障可降级。Workerman 提供了底座,但连接管理、心跳保活、断线重连、消息队列桥接这些,都得你自己补全逻辑。










