必须用topthink/think-swoole（ThinkPHP项目）或原生swoole/swoole（纯PHP项目），因Ratchet基于ReactPHP同步阻塞模型，与Swoole协程异步模型冲突，混用会导致端口占用、连接断开、事件不触发等问题。
直接结论：别用 ratchet，它不兼容 Swoole；必须用 topthink/think-swoole（ThinkPHP 项目）或原生 swoole/swoole（纯 PHP 项目）。
为什么不能用 composer require cboden/ratchet
Ratchet 是基于 PHP 原生 socket + ReactPHP 的同步阻塞模型，和 Swoole 的协程异步模型完全冲突。即使装上，IoServer::factory() 启动后会立即报错：Warning: stream_socket_server(): unable to bind to ... Address already in use —— 因为 Swoole 已独占端口，Ratchet 尝试再开一个监听失败。
- 你看到的“Ratchet + Composer”教程基本都来自 2022 年前的老项目，当时 Swoole 还没普及
- 宝塔面板里搜“Swoole”安装的是
swoole.so扩展，不是 Ratchet 包 - 强行混用会导致连接频繁断开、
onOpen不触发、消息收发不同步
topthink/think-swoole 的正确引入方式（ThinkPHP 5/6/8）
这是 ThinkPHP 官方维护的 Swoole 桥接库，自动适配框架生命周期，避免手动管理连接池和内存泄漏。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行命令时加
--ignore-platform-reqs避免因 PHP 版本小版本号不匹配失败：composer require topthink/think-swoole --ignore-platform-reqs - 安装后检查
vendor/topthink/think-swoole/src/websocket/Handler.php是否存在，不存在说明安装被跳过 - 配置文件
config/swoole.php必须启用'websocket' => ['enable' => true]，否则Handler类不会被加载 - 别在
config/swoole.php里写'host' => '127.0.0.1'—— 生产环境需改成'0.0.0.0'，否则外网连不上
原生 Swoole 服务的最小可运行代码（无框架）
不依赖任何框架时，直接用 swoole/swoole 扩展，但注意：Composer 只是声明依赖，真正起作用的是 PHP 加载的 swoole.so 扩展。
- 先确认扩展已启用：
php -m | grep swoole，输出为空就去宝塔或 CLI 手动安装 - Composer 命令只需执行一次：
composer require swoole/swoole（仅用于 autoload 和 IDE 提示） - 服务启动脚本必须用
new Swoole\WebSocket\Server，不是new swoole_websocket_server（后者是旧版函数式写法，PHP 8+ 已废弃） - 关键配置项
'heartbeat_check_interval'建议设为30（秒），太长会导致客户端假死连接堆积
server.php
<?php
$server = new Swoole\WebSocket\Server('0.0.0.0', 9501);
$server->set([
'worker_num' => 4,
'heartbeat_check_interval' => 30,
'heartbeat_idle_time' => 60,
]);
$server->on('open', function ($server, $request) {
echo "client {$request->fd} connected\n";
});
$server->on('message', function ($server, $frame) {
$server->push($frame->fd, "echo: {$frame->data}");
});
$server->start();
常见启动失败的三个硬坑
90% 的“服务跑不起来”问题集中在这三处，不是代码写错，而是环境或权限卡住。
-
bind() failed: Permission denied：Linux 下非 root 用户不能绑定 1024 以下端口，把端口改成9501或8080，别用80或443 - 宝塔防火墙没开对应端口：不只是服务器安全组，宝塔面板后台的「安全」→「放行端口」也得手动添加
9501 -
Class 'Swoole\WebSocket\Server' not found：PHP CLI 使用的 php.ini 和 Web 用的不是同一个，用php --ini查路径，确保该 php.ini 里有extension=swoole.so
端口、扩展、配置文件这三样对不上，代码再标准也起不来。调试时先用 php -r "var_dump(class_exists('Swoole\WebSocket\Server'));" 确认类是否存在，比反复改代码更省时间。
