本地测试PHP连接WebSocket需先启动Node.js的ws服务端（如ws://localhost:8080），再用textalk/websocket库实现PHP客户端收发消息，注意超时设置与UTF-8编码。
本地启动一个可连接的 WebSocket 服务
PHP 本身不原生提供 WebSocket 服务器，fsockopen 或 stream_socket_client 只能做客户端；要测试“PHP 连接 WebSocket”，你必须先有一个运行着的 WebSocket 服务端。最轻量、适合本地开发的方式是用 Node.js 的 ws 库快速起一个：
安装并启动（需已装 Node.js）：
npm init -y npm install ws
新建 server.js：
const WebSocket = require('ws');
const wss = new WebSocket.Server({ port: 8080 });
wss.on('connection', (ws) => {
console.log('Client connected');
ws.send('Hello from local WS server');
ws.on('message', (data) => {
console.log('Received:', data.toString());
ws.send('Echo: ' + data.toString());
});
});
运行：node server.js，服务就跑在 ws://localhost:8080 了。
立即学习“PHP免费学习笔记（深入）”；
PHP 客户端用 Ratchet 或 ReactPHP 连？别——用更直接的方案
想让 PHP 主动连 WebSocket 服务，不是用 Laravel Echo 或 Pusher SDK（它们面向浏览器或长轮询），而是需要一个能发起 WebSocket 握手并收发帧的客户端库。推荐 textalk/websocket（轻量、无依赖、纯 PHP 实现）：
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
安装：
composer require textalk/websocket
写个 client.php 测试连接和通信：
$client = new WebSocket\Client("ws://localhost:8080");
$client->send("Hi PHP here");
echo $client->receive() . "\n"; // 输出：Hello from local WS server 或 Echo: Hi PHP here
$client->close();
注意：textalk/websocket 不支持 WSS（加密），本地测试用 ws:// 即可；若强行连 wss:// 会报 SSL operation failed 错误。
常见失败现象和对应检查点
连不上？大概率卡在这几个地方：
-
Connection refused：Node 服务没运行，或端口被占（换端口重试，比如8081） -
WebSocket connection to 'ws://...' failed：这是浏览器报的，和 PHP 无关；PHP 报错通常是Connection timed out或Invalid response - 收不到消息或
receive()阻塞：服务端没调ws.send()，或 PHP 客户端没在send()后立刻receive()（WebSocket 是全双工，但简单测试建议一发一收） - 中文乱码或二进制错误：确保
send()内容是 UTF-8 字符串；textalk/websocket默认按文本帧发送，不要传 raw binary
为什么不用 PHP 写 WebSocket 服务端来测试？
可以，但没必要。Ratchet 或 Swoole 虽然能写服务端，但本地测试只需验证“PHP 能否作为客户端连上 WS”，重点在客户端行为（握手、ping/pong、消息收发）。自己搭服务端反而引入额外复杂度：Swoole 需编译扩展，Ratchet 依赖 ReactPHP 事件循环，出错时难以区分是网络问题还是框架配置问题。用 ws + textalk/websocket 组合，两端都极简可控。
真正容易被忽略的是：PHP 进程默认没有超时等待机制，receive() 会一直挂起直到有数据或连接断开。本地测试务必加超时控制（textalk/websocket 支持构造时传 ['timeout' => 5]），否则脚本可能卡死不动。
