17370845950

根本原因是宝塔软件商店未提供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_php

  

  72.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，必然失败。

• 查当前 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，没有“两全其美”的配置。