宝塔面板一键安装swoole扩展需先确认并选对php版本，进入其设置页的“安装扩展”选项卡搜索安装swoole，安装后必须点击“重启php”，再通过命令行执行php --ri swoole验证是否启用成功。
你想在宝塔面板上快速启用Swoole扩展，让PHP项目支持WebSocket、协程HTTP服务器等高性能能力，但又不想折腾编译、改配置、查路径——直接用宝塔软件商店一键安装是最稳妥的路径。
确认PHP版本并进入扩展管理
登录宝塔面板 → 左侧菜单点击「软件商店」→ 在「已安装」列表中找到你当前正在使用的PHP版本（例如PHP 80）→ 点击右侧「设置」按钮。
这一步必须做对，【选错PHP版本会导致swoole.so被装到错误目录，后续php --ri swoole始终显示未启用】。如果你不确定哪个PHP版本被网站使用，可进入「网站」→ 点击对应站点 → 查看「PHP版本」字段。
一键安装Swoole扩展
在PHP设置页中，切换到「安装扩展」选项卡 → 在搜索框输入 swoole → 找到匹配项（常见名称为“Swoole4”或“Swoole5”，取决于宝塔上架版本）→ 点击右侧「安装」按钮。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
等待进度条走完，页面提示“安装成功”后，立即点击右上角「重启PHP」（注意：是重启，不是重载；重载不会加载新扩展）。
验证是否生效
打开宝塔终端（或SSH连接服务器），执行命令：
/www/server/php/80/bin/php --ri swoole
若输出中包含 extension => enabled 和具体版本号（如 5.1.5），说明安装成功；如果报错 Extension 'swoole' not present，请返回第一步核对PHP版本是否一致，并确认是否点击了「重启PHP」而非「重载配置」。
这一步不能跳过，【仅靠面板显示“安装成功”不等于扩展已加载，必须用命令行验证】。
