PHP WebSocket并发连接数受限于同步阻塞模型、系统文件描述符限制(如ulimit -n)及运行模式(FPM/CLI),实际稳定值通常为100–500;突破需改用ReactPHP等异步事件循环方案。
PHP 本身没有内置的 WebSocket 客户端连接数硬性上限,但实际并发连接数受
操作系统
、网络栈、PHP 运行模式和所用扩展三重限制,通常远低于理论值 —— 常见生产环境稳定维持在
左右,超限后会直接触发
或
错误。
为什么 PHP 的 WebSocket 并发连接数上不去
PHP 是同步阻塞模型(尤其在 CLI 或 Apache/FPM 下),每个连接需独占一个进程/线程;不像 Node.
js
或 Go 那样靠事件循环复用 I/O。即使使用
或
,底层仍依赖
/
,而这些函数创建的是阻塞 socket —— 每个连接都卡住一个 PHP 执行上下文。
限制了单进程可打开文件描述符总数(socket 占用 fd),默认常为
,连满 1000 个 WebSocket 就可能 hit 到边界
FPM 模式下,
决定了并发进程上限,每个进程若维持多个长连接,极易耗尽资源
CLI 脚本虽无 FPM 约束,但未做异步调度时,
会阻塞整个进程,无法复用
SSL/TLS 握手开销大,大量并发连接时 CPU 和熵池(
)可能成为瓶颈
用 ReactPHP 实现千级 WebSocket 并发的关键配置
要突破百级限制,必须切换到真正异步的运行时,ReactPHP 是目前 PHP 生态最成熟的方案。它不依赖多进程,而是基于事件循环 + 非阻塞 socket。
必须使用
+
,而非
手动拼帧
启动前调高系统限制:
(并写入
)
禁用 DNS 阻塞:所有
必须传 IP 地址,或配合
异步解析
连接池需手动实现 —— ReactPHP 不自带连接复用,频繁
+
会快速打满 fd
示例关键片段:
常见错误现象与对应排查点
遇到连接失败,别急着调 PHP 配置,先看这几点:
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记(深入)
”;
报
→ 目标服务拒收,或本地端口被占满(
)
报
→ 立即查
和
连接建立后收不到消息,且
无效 → 说明用了阻塞 socket,没走异步循环,recv 被挂起
内存持续上涨,
显示 PHP 进程 RES 达数 GB → 对象未释放,WebSocket 实例未
,或事件监听器泄漏(如
中循环引用)
真正卡住并发上限的,从来不是 PHP 语法或扩展版本,而是同步模型与长连接本质的冲突。哪怕你把
设成 10000,只要还在用
或
模拟 WebSocket,就永远达不到 —— 因为它们根本不是 WebSocket。
100–500Connection refusedToo many open filesext-websocketreactphp/websocket-clientfsockopenstream_socket_clientulimit -n1024pm.max_childrenwhile (true) { $client->recv() }/dev/randomreactphp/socketreactphp/websocketfsockopenulimit -n 65536/etc/security/limits.confconnect()reactphp/dnsnew WebSocketClientconnect()$loop = \React\EventLoop\Factory::create();
$connector = new \React\Socket\Connector($loop, ['dns' => '8.8.8.8', 'timeout' => 5]);
$client = new \Ratchet\Client\Connector($loop, $connector);
$client('wss://echo.websocket.org')->then(function ($conn) {
$conn->send('hello');
}, function ($e) {
echo "Connection failed: " . $e->getMessage();
});
$loop->run();PHP Warning: stream_socket_client(): unable to connect to ... (Connection refused)netstat -an | grep :8080 | wc -lPHP Warning: stream_socket_client(): unable to connect to ... (Too many open files)ulimit -nlsof -p | wc -l stream_set_timeouttopclose()$conn->on('message', function () use ($conn) { ... })max_connectionsfile_get_contentscurl_exec