ThinkPHP 5.1 引入 Swoole/Workerman 扩展的详细步骤-ThinkPHP-PHP中文网

优先选 think-swoole；高并发、长连接、实时推送场景用 swoole，低负载或 windows 环境选 workerman；两者互不兼容，tp5.1 需手动引入，且启动后绕过框架生命周期。

thinkphp 5.1 引入 swoole/workerman 扩展的详细步骤

tp5.1 里装 think-swoole 还是 think-worker？先看需求再选

直接结论：高并发、长连接、实时推送（如聊天室、IM）优先用 swoole；低负载、快速验证、Windows 环境或不想装扩展，选 workerman。两者在 tp5.1 中互不兼容，不能混用。

think-swoole 是官方维护的 Swoole 集成包，依赖 PHP 扩展；think-worker 是对 Workerman 的轻量封装，纯 PHP 实现。tp5.1 默认不带任一扩展，必须手动引入。

常见误判点：composer require topthink/think-worker 装的是旧版（已停止维护），tp5.1 应用应改用 composer require topthink/think-swoole 或直接集成原生 Workerman —— 后者更可控，尤其涉及广播、连接管理等逻辑时。

装 Swoole 扩展失败的三个高频原因

不是 composer 报错，而是 php -m 看不到 swoole，或 php --ri swoole 提示版本低于 4.8 —— 这会导致 think-swoole 启动报错或握手失败。

PHP 版本不匹配：Swoole v5.x 要求 PHP ≥ 7.4；tp5.1 推荐搭配 PHP 7.4–8.1，别用 PHP 8.2+（部分函数签名变更未适配）
扩展未启用：检查 php.ini 是否有 extension=swoole，且该 ini 文件确被加载（php --ini 查路径）
安全组/防火墙拦端口：启动后访问 http://127.0.0.1:9501 失败，先确认 netstat -tuln | grep 9501 是否监听 0.0.0.0:9501，而非仅 127.0.0.1:9501

Windows 用户注意：Swoole 官方不支持 Windows，tp5.1 + Swoole 方案在 Windows 下只能跑在 WSL2 或 Docker 里，别浪费时间调 php_swoole.dll。

tp5.1 集成 Workerman 的正确姿势（绕过 think-worker 封装）

think-worker 在 tp5.1 中对 $worker 对象作用域控制太死，onMessage 回调拿不到 $worker->connections，导致无法广播——这不是配置问题，是设计限制。必须跳过封装，直连 Workerman 原生 API。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

操作步骤：

执行 composer require workerman/workerman（别装 topthink/think-worker）
新建 server.php 在项目根目录，内容为标准 Workerman 启动脚本，use Workerman\Worker 开头
在 onMessage 中用 global $worker 或闭包 use ($worker) 显式传入（注意：必须在 Worker::runAll() 前定义好回调）
连接管理需自己维护：Workerman 不自动存用户 ID，要在 onConnect 中给 $connection->uid = uniqid()，广播时遍历 $worker->connections 并校验 isset($worker->connection_info($fd))

示例关键片段：

$worker = new Worker('websocket://0.0.0.0:2346');
$worker->onMessage = function ($connection, $data) use ($worker) {
    foreach ($worker->connections as $conn) {
        if ($conn !== $connection && $conn->isConnected()) {
            $conn->send($data);
        }
    }
};