elephant.io仅兼容socket.io v0.9.x/v1.x及部分v2/v3，不支持v4+；需服务端启用allowEIO3、PHP端用v3.3.2、URL带/socket.io路径、事件名小写、emit参数为数组、手动close()释放连接、避免传二进制数据。
elephant.io 客户端连接不上 Node.js 的 socket.io 服务？先确认协议和版本对齐
elephant.io 不是 socket.io 官方客户端，它只支持 socket.io v0.9.x 和 v1.x（部分兼容），但完全不支持 v4.x 及以上。如果你的 Node.js 端用的是最新版 socket.io@4.7.2，PHP 端连上就会静默失败，或报 Connection refused、Unexpected HTTP status code: 400 —— 这不是 PHP 配置问题，是协议层不兼容。
- Node.js 端若用
socket.io@2.x/3.x，需在服务端显式降级握手兼容性：const io = new Server(server, { allowEIO3: true // 允许 engine.io v3（elephant.io v3.x 依赖此） }); - PHP 端必须用
elephant.io@3.3.2（最后兼容 socket.io v2/v3 的稳定版），dev-master或v4.x分支已放弃对老协议支持 - 连接 URL 格式必须带 path：用
http://localhost:3000/socket.io，不能只写http://localhost:3000；否则 elephant.io 会拼出错误的 upgrade 请求路径
用 emit() 发消息总被忽略？检查命名空间和事件名大小写
elephant.io 默认连接的是 / 命名空间，且所有事件名在底层被强制转成小写。如果你 Node.js 端监听的是 userLogin 或 OrderCreated，PHP 端 emit userLogin 会被发成 userlogin，服务端收不到。
- Node.js 端监听要适配小写：
socket.on('userlogin', ...)，或改用socket.on('userLogin'.toLowerCase(), ...) - 如果用了自定义命名空间（如
/admin），PHP 必须显式指定：$client = new \ElephantIO\Client(new \ElephantIO\Engine\SocketIO\Version3('http://localhost:3000/admin')); -
emit()第二个参数必须是数组（即使只传一个值），传字符串或对象会触发 silent fail：emit('msg', ['hello'])✅，emit('msg', 'hello')❌
PHP 进程退出后连接没释放？别依赖析构函数自动断开
elephant.io 的 __destruct() 在 CLI 模式下不一定被调用（尤其遇到 exit()、信号中断或 fatal error），导致 Node.js 端 socket 连接一直 dangling，积累大量 zombie socket。
- 必须手动调用
close()：$client->initialize(); $client->emit('ping', ['test']); $client->close(); // 关键：显式关闭 - 在命令行脚本中，建议用
register_shutdown_function()做兜底：register_shutdown_function(function () use ($client) { if ($client->isConnected()) $client->close(); }); - 不要在 long-running PHP-FPM 请求里复用同一个
Client实例 —— elephant.io 内部没有重连逻辑，网络抖动后emit()会直接抛ConnectionException
想传二进制数据（比如图片 base64）？elephant.io 不支持 ArrayBuffer / Blob
elephant.io 底层走 HTTP 轮询（polling）或 WebSocket 文本帧，所有数据都会被 JSON 编码。传大段 base64 字符串不仅慢，还容易触发 max_http_header_size 或 socket.io 的 maxHttpBufferSize 限制，报错 Payload too large。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法：PHP 端把文件存到临时目录，只通过 elephant.io 传一个
file_id或 URL，Node.js 端再自行读取或下载 - 如果坚持走 elephant.io，务必在 Node.js 端调大限制：
const io = new Server(server, { maxHttpBufferSize: 10e6 // 10MB }); - elephant.io 对 UTF-8 外的编码（如 GBK）处理不可靠，传中文前统一
mb_convert_encoding($str, 'UTF-8', 'auto')
elephant.io 的本质是个轻量胶水库，不是实时通信基础设施。只要 Node.js 端协议版本锁死、事件名全小写、每次用完必 close()，它就能稳住基础交互。真正麻烦的是错误边界 —— 比如网络中断时它不会重试，超时时间固定为 5 秒且无法配置，这些都得在业务层自己兜住。
