宝塔面板安装swoole 4优先推荐软件商店一键安装：登录面板→软件商店→找到对应php版本→设置→安装扩展→搜索swoole4→点击安装→重启php→执行php --ri swoole验证enabled及版本号；仅当商店无该选项、需特定功能（如openssl/async redis）或版本不匹配时，才手动编译安装。
宝塔面板安装 Swoole 4，优先走「软件商店一键安装」路径，既快又稳；只有在版本不匹配、功能缺失或商店未上架时，才需手动配置。关键不是选哪种方式，而是确认 PHP 版本、扩展路径和启用状态是否一致。
宝塔软件商店一键安装 Swoole 4
这是绝大多数场景的首选方案，全程图形化操作，5 分钟内完成：
- 登录宝塔面板 → 左侧「软件商店」→ 找到已安装的 PHP（如 PHP 80）→ 点击「设置」
- 切换到「安装扩展」选项卡 → 搜索框输入 swoole 或 swoole4
- 若列表中显示“Swoole4”（常见于 PHP 7.4–8.1），点击右侧「安装」按钮
- 安装完成后，务必点击「重启 PHP」（不是重载，否则扩展不生效）
- 验证命令：/www/server/php/80/bin/php --ri swoole，输出含 enabled 和版本号（如 4.11.1）即成功
手动配置 Swoole 4 的适用场景与步骤
当软件商店无 Swoole 4 选项、需启用 OpenSSL/Async Redis、或使用特定 patch 版本时，才进入手动流程：
- 先装编译工具：yum install -y gcc gcc-c++ make cmake autoconf（CentOS）或 apt install -y build-essential cmake autoconf（Ubuntu）
- 下载 Swoole 4 稳定版（如 4.11.1）：wget https://pecl.php.net/get/swoole-4.11.1.tgz
- 解压并编译：tar zxvf swoole-4.11.1.tgz && cd swoole-4.11.1
/www/server/php/80/bin/phpize
./configure --with-php-config=/www/server/php/80/bin/php-config --enable-openssl --enable-async-redis
make && make install - 记下扩展路径（通常为 /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/），确认该目录下存在 swoole.so
- 在宝塔 PHP 设置 → 配置文件中，在 ; extension= 区域末尾添加：extension=swoole.so，保存后重启 PHP
常见问题排查要点
安装后不生效？别急着重装，先检查这三项：
- PHP CLI 与 Web 使用版本是否一致：执行 php -v 和查看宝塔站点设置里的 PHP 版本，必须完全相同（如都是 PHP 80）
- php.ini 是否改对了文件：宝塔每个 PHP 版本有独立配置文件，路径是 /www/server/php/{版本号}/etc/php.ini，不是系统全局 php.ini
- 扩展名是否拼写正确：必须是 swoole.so（Linux）或 swoole.dll（Windows），且不能带空格或分号前缀
