必须严格匹配php主版本、nts/zts类型及abi编号；执行php -v、php-config --version、php -i | grep "extension_dir"三步查清环境；php 7.4–8.1用pecl install swoole_loader，8.2+用pecl install swoole并双配置，8.3+仅支持源码编译。
在宝塔面板中为不同PHP版本安装Swoole扩展时，必须严格匹配Swoole版本与PHP主版本、线程安全类型（NTS/ZTS）及ABI标识（如20190902），错配会导致PHP服务启动失败或扩展加载后无响应。
查清当前PHP环境真实信息
打开宝塔终端，执行以下三行命令，顺序不能颠倒：
php -v → 查看PHP主版本号和NTS/ZTS标识；
php-config --version → 获取编译时主版本号（比php -v更可靠，尤其多PHP共存时）；
php -i | grep "extension_dir" → 确认so文件实际存放路径，例如输出/www/server/php/81/lib/php/extensions/no-debug-non-zts-20210902/，其中20210902即为PHP 8.1的ABI编号，【必须用此编号匹配Swoole Loader文件名】。
主流PHP版本对应Swoole推荐方案
宝塔面板未预置Swoole图形化安装按钮，所有版本均需跳过「PHP扩展管理」页直接操作：
方法一：PHP 7.4–8.1（含）→ 优先用pecl安装swoole_loader（非swoole扩展）
原因：Swoole Compiler加密主题依赖的是swoole_loader，不是swoole主扩展；装错扩展名（如只装swoole.so）会导致页面乱码或Fatal error。
方法二：PHP 8.2及以上 → 必须用pecl install swoole，且需手动补全CLI与FPM双配置
因为PHP 8.2起，宝塔软件商店仍未上架Swoole按钮，且PECL包已默认启用http2/openssl支持，不手动开启会导致WebSocket握手失败。
方法三：PHP 8.3–8.5 → 仅支持源码编译，禁用pecl
PECL官方尚未发布适配PHP 8.3+ ABI的稳定包，强行运行pecl install swoole会报错“invalid extension version”，此时必须下载对应版本tar.gz源码，用/www/server/php/83/bin/phpize → ./configure --with-php-config=/www/server/php/83/bin/php-config --enable-openssl --enable-http2 → make && make install。
各版本Swoole Loader文件名对照表
第一步：确认PHP版本与NTS/ZTS类型（来自php -v输出）；
第二步：根据ABI编号（来自php -i | grep extension_dir）锁定目录后缀；
第三步：按以下规则拼接文件名并下载：
PHP 7.4 NTS → swoole_loader74_nzts_x64.so；
PHP 8.0 ZTS → swoole_loader80_zts_x64.so；
PHP 8.1 NTS → swoole_loader81_nzts_x64.so；
PHP 8.2+ 不提供Loader，仅支持swoole.so主扩展，【切勿尝试下载loader文件，否则PHP-FPM进程会崩溃退出】。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
