Composer引入并初始化基于Swoole的WebSocket服务依赖（代码搭建）-composer-PHP中文网

必须用topthink/think-swoole（thinkphp项目）或原生swoole/swoole（纯php项目），因ratchet基于reactphp同步阻塞模型，与swoole协程异步模型冲突，混用会导致端口占用、连接断开、事件不触发等问题。

composer引入并初始化基于swoole的websocket服务依赖（代码搭建）

直接结论：别用 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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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