PHP跨平台实时通讯,不用切换技术栈也能搞定

很多 PHP 开发者都有过这样的困扰：想做个在线聊天室、实时客服或者弹幕推送，却发现主流方案都是 Node.js + Socket.IO，自己还要额外学一门语言、搭一套环境，成本实在太高。

好在有 PHPSocket.IO，它是由 Workerman 作者 walkor 开发的 PHP 版 Socket.IO 服务端，让咱们只用 PHP就能快速搭建稳定、兼容、低延迟的实时应用，前端代码几乎不用改动。

一、PHPSocket.IO 到底是什么？

简单说，它就是Socket.IO 的 PHP 实现，完全兼容 Socket.IO 客户端协议（支持 v1.3.0 ~ v2.x），API 风格也高度一致，on、emit、to、join 这些常用方法和 JS 版一模一样，前端同学几乎零成本对接。

它基于 Workerman 构建，天生自带异步非阻塞、多进程高性能的优势，同时又比原生 Workerman 更友好，自带完善的兼容降级方案，不支持WebSocket 的环境会自动切换到长轮询、JSONP甚至 Flash Socket，对开发者完全透明。

二、核心亮点，一次看懂

• 兼容极强：优先 WebSocket，不支持则自动降级，全设备、全浏览器通吃。
• 学习成本低：API 对标 JS 版 Socket.IO，会用就能上手。
• 高性能：依托 Workerman，异步非阻塞，支撑中小型高并发场景毫无压力。
• 易集成：可以无缝接入 Webman、ThinkPHP、Laravel 等主流框架。
• 场景丰富：聊天室、客服系统、弹幕、实时看板、在线通知都能用。

三、和 Workerman、Node.js 版 Socket.IO 有啥区别？

1. 与 Workerman 的区别PHPSocket.IO 是基于 Workerman 开发的，继承了所有性能优点，但更专注于实时通信，兼容策略更完善；而 Workerman 是更底层的通用服务器，支持 TCP、UDP、HTTP 等更多协议。

2. 与 Node.js Socket.IO 的区别

• Node.js 版底层基于 libuv，高并发极限更强；
• PHPSocket.IO 基于 Workerman（libevent/epoll），性能略低，但足够支撑绝大多数项目；
• 最大优势：PHP 开发者部署、维护更熟悉，不用切换技术栈。

四、快速上手：一行安装，几步跑通

安装非常简单，直接 Composer 一键引入：

composer require workerman/phpsocket.io

下面是一套完整可用的服务端示例，包含用户登录、房间绑定、断开清理、外加 HTTP 推送接口：

<?phpnamespaceapp\http\controller;usePHPSocketIO\SocketIO;usethink\facade\Log;useWorkerman\Worker;classServer{publicfunctionserver(){        $uidConnectionMap = [];// 监听 2120 端口        $sender_io = new SocketIO(2120);// 客户端连接        $sender_io->on('connection', function($socket){// 登录事件            $socket->on('login', function($uid)use($socket){global $uidConnectionMap;if (isset($socket->uid)) return;                $uid = (string)$uid;if (!isset($uidConnectionMap[$uid])) {                    $uidConnectionMap[$uid] = 0;                }                $uidConnectionMap[$uid]++;                $socket->join($uid);                $socket->uid = $uid;            });// 断开连接            $socket->on('disconnect', function()use($socket){global $uidConnectionMap;if (!isset($socket->uid)) return;if (--$uidConnectionMap[$socket->uid] <= 0) {unset($uidConnectionMap[$socket->uid]);                }            });        });// 启动内部 HTTP 推送接口        $sender_io->on('workerStart', function()use($sender_io){            $inner_http_worker = new Worker('http://0.0.0.0:2121');            $inner_http_worker->onMessage = function($http_connection, $data)use($sender_io){global $uidConnectionMap;                $to = $data['post']['to'] ?? '';                $content = htmlspecialchars($data['post']['content'] ?? '');if ($to) {                    $sender_io->to($to)->emit('new_msg', $content);                } else {                    $sender_io->emit('new_msg', $content);                }if ($to && !isset($uidConnectionMap[$to])) {                    $http_connection->send('offline');                } else {                    $http_connection->send('ok');                }            };            $inner_http_worker->listen();        });        Worker::runAll();    }}

五、启动服务

后台守护进程启动：

php web_msg.php start -d

启动成功后，会显示类似这样的状态：

Workerman[web_msg.php] start in DAEMON modeWorkerman version: 5.1.2     PHP version: 8.2.19proto  user  worker       listen                     processes  statustcp    www   PHPSocketIO  socketIO://0.0.0.0:2120    1          [OK]

六、后端推送消息函数

项目里直接调用这个函数，就能向指定用户推送实时消息：

functionsend_web_msg($to_uid = 1, string $content = ''): string|array{if (empty($content)) {return ['error_code' => 404, 'reason' => '缺少推送内容'];    }    $url = 'http://127.0.0.1:2121/';    $data = ['type'    => 'publish','content' => $content,'to'      => (string)$to_uid,    ];    $ch = curl_init($url);    curl_setopt_array($ch, [        CURLOPT_POST           => true,        CURLOPT_POSTFIELDS     => http_build_query($data),        CURLOPT_RETURNTRANSFER => true,        CURLOPT_TIMEOUT        => 5,    ]);    $response = curl_exec($ch);    curl_close($ch);return trim($response) ?: 'ok';}

七、前端接入代码（现代 CDN 版）

直接引入客户端，连接、登录、收消息一步到位：