根本原因是宝塔软件商店未提供Swoole4，其依赖PHP≥7.3且需手动编译；同时Swoole4与禾匠swoole_loader冲突，且PHP CLI与FPM版本不一致、编译依赖缺失、disable_functions限制等共同导致安装失败。
为什么宝塔里装不上 Swoole4？根本原因不是“没点安装”，而是版本链断了
宝塔面板默认软件商店里的 Swoole 扩展，多数是 2.x 或 3.x 版本（尤其 PHP7.2/7.3 下），而 Swoole4 要求 PHP ≥ 7.3，且必须手动编译——它压根不在宝塔官方扩展列表里。你点“安装”没反应、装完 php -m 看不到、或者 php --ri swoole 显示版本是 2.2.0，基本就是这个原因。
- 宝塔自带的两个 Swoole 扩展（
swoole和swoole_loader）不能混用，尤其是禾匠系项目明确要求swoole_loader_20_php72.so，装 Swoole4 反而会冲突 - PHP CLI 和 FPM 使用不同
php.ini，只改了一个，另一个环境还是不认扩展 - CentOS 8+ 或较新系统缺少
gcc-c++、autoconf、openssl-devel等基础编译依赖，phpize直接报错退出
PHP7.4 安装 Swoole4 的实操路径（绕过宝塔商店）
别碰宝塔软件商店里的 Swoole 按钮，直接走源码编译。以 PHP7.4 为例（路径为 /www/server/php/74）：
- 先确认编译工具就位：
yum install -y gcc gcc-c++ autoconf libtool make openssl-devel - 下载并解压 Swoole4.8.0：
wget https://github.com/swoole/swoole-src/archive/v4.8.0.tar.gz && tar -zxvf v4.8.0.tar.gz - 进入目录执行编译：
cd swoole-src-4.8.0 && /www/server/php/74/bin/phpize && ./configure --with-php-config=/www/server/php/74/bin/php-config --enable-openssl && make && sudo make install - 检查生成的 so 文件位置：
ls -l /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/swoole.so - 分别编辑 CLI 和 FPM 的
php.ini：
CLI 配置路径通常是/www/server/php/74/etc/php.ini，FPM 是/www/server/php/74/etc/php-fpm.d/www.conf里指定的php_admin_value[extension]或主php.ini；在两处都加一行：extension=swoole.so - 重启服务：
bt 16（重载 PHP 配置）+systemctl restart php-fpm-74
装完仍报 Class 'swoole_websocket_server' not found？检查 loader 冲突和函数禁用
这不是扩展没装上，而是运行时被拦截了。禾匠系项目（如榜店商城 v4）依赖的是加密 loader（swoole_loader_20_php72.so），它和原生 swoole.so 互斥。如果你强行共存，PHP 启动时就会报 Module 'swoole' already loaded，或类找不到。
- 删掉所有重复的
extension=行：检查php.ini里是否同时存在swoole_loader_20_php72.so和swoole.so，留一个，删另一个 - 确认
proc_open和proc_get_status没被禁用：宝塔默认在disable_functions里关了它们，队列和 Swoole 进程管理必须用，删掉这两项 -
pcntl_*函数必须清空：宝塔有时会把pcntl_fork等写进disable_functions，Swoole4 无法启动子进程，全删 - 验证加载状态：
php -m | grep swoole（CLI）、phpinfo()页面搜索 “swoole”（Web 环境），两者都要显示
PHP 命令行版本 ≠ 网站用的 PHP 版本，队列跑不起来大概率卡在这
宝塔允许网站绑定不同 PHP 版本，但服务器全局 php 命令只指向一个 CLI 版本。禾匠项目队列命令如 php queue listen 默认走 CLI，如果 CLI 是 PHP8.0，而网站用 PHP7.2 + loader，必然失败。
立即学习“PHP免费学习笔记（深入）”；
- 查当前 CLI 版本：
php -v，不是网站后台显示的版本 - 切换 CLI 版本（以 PHP7.2 为例）：
rm -f /usr/bin/php && ln -sf /www/server/php/72/bin/php /usr/bin/php - 再执行队列前，务必确认：
which php输出路径含/72/，且php -m | grep swoole有输出 - 阿里云/腾讯云用户额外注意：安全组必须放行你用的 Swoole 端口（如 9501），宝塔防火墙开了≠云厂商防火墙开了
最常被忽略的一点：Swoole4 不支持 PHP7.2，但禾匠 loader 只支持 PHP7.2 ——二者不可兼得。选 loader 就别强上 Swoole4；真要用 Swoole4，就得换框架或自己解密 loader，没有“两全其美”的配置。
