在使用 Ratchet 客户端建立 WebSocket 连接时，若需同步等待连接、消息处理及关闭流程全部结束再执行后续逻辑，必须显式调用事件循环的 run() 方法以阻塞主线程，否则异步回调中的状态（如 $reason）尚未更新，后续代码便已执行。
在使用 ratchet 客户端建立 websocket 连接时，若需同步等待连接、消息处理及关闭流程全部结束再执行后续逻辑，必须显式调用事件循环的 `run()` 方法以阻塞主线程，否则异步回调中的状态（如 `$reason`）尚未更新，后续代码便已执行。
ReactPHP 的事件循环（React\EventLoop\Loop）本质上是非阻塞异步运行时：调用 Loop::get() 仅获取循环实例，但不会自动启动；而 .then() 等 Promise 回调注册后，需主动触发 ->run() 才开始监听 I/O 并执行排队任务。若省略该调用，脚本会立即执行后续语句（如 echo "the echo $reason\n";），此时 $reason 仍为初始值 "unknown"，因为所有 WebSocket 交互（连接、收消息、关闭）均未发生。
✅ 正确做法是在连接逻辑注册完成后、关键后续操作前，插入 $loop->run();：
WebSocket 8.18.2
下载
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
use React\EventLoop\Loop;
$loop = Loop::get();
$reason = "unknown";
\Ratchet\Client\connect(
'wss://demo.piesocket.com/v3/channel_1?api_key=VCXCEuvhGcBDP7XhiJJUDvR1e1D3eiVjgZ9VRiaV¬ify_self',
[],
[],
$loop
)->then(
function ($conn) use ($loop, &$reason) {
$conn->on('message', function ($msg) use ($loop, $conn, &$reason) {
echo $msg . "\n";
if ($msg == "quit") {
$conn->close();
$loop->stop(); // 终止事件循环
$reason = "quit";
}
});
},
function ($e) {
echo "Could not connect: {$e->getMessage()}\n";
}
);
// ⚠️ 关键：显式启动并阻塞等待事件循环结束
$loop->run();
// 此时 $reason 已被回调更新，输出符合预期
echo "the echo $reason\n";? 注意事项：
- Loop::get() 的文档注释提到：“Automatically run loop at end of program, unless already started or stopped explicitly”。这意味着若未手动调用 run() 或 stop()，PHP 脚本退出前会自动触发一次 run() —— 但这属于“兜底行为”，不可靠且无法控制执行时机，绝不应依赖此特性。
- 在大型脚本中封装为子函数时，确保该函数内部包含 $loop->run()，且避免重复调用（多次 run() 会抛出异常）；若需复用同一循环，建议由主流程统一管理启停。
- 若需实现“超时退出”或“带返回值的同步调用”，可结合 React\Promise\Deferred 和定时器（$loop->addTimer()）增强健壮性，但基础场景下 ->run() 即足够。
总结：$loop->run() 是 ReactPHP 异步流程同步化的锚点——它让事件驱动模型与传统顺序执行逻辑安全衔接。遗漏它，就等于启动了引擎却忘了挂挡。
