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 才是合理解法：
-
WebSocket实时通信：聊天室、客服系统、协作编辑（如在线文档光标同步） - 设备长连接网关：IoT 设备心跳上报、指令下发（用
TcpConnection或自定义协议） - 高频低延迟推送：行情刷新、游戏状态同步、工单状态变更通知
- 需要自定义协议的服务：比如二进制协议接入、私有加密信令交互（Workerman 支持
Frame、Http、Text、Json等多种传输层封装）
注意：如果只是“用户量大但仍是 HTTP API”，用 Nginx + PHP-FPM + Redis 缓存 + 数据库读写分离，通常比强行套 Workerman 更稳、更易维护。
和 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 提供了底座，但连接管理、心跳保活、断线重连、消息队列桥接这些，都得你自己补全逻辑。
