优先通过宝塔软件商店一键安装Swoole扩展；若失败或需特定版本（如swoole-5.1.5），则必须源码编译，严格校验phpize与php-config路径（如/www/server/php/80/bin/phpize），并确保CLI与FPM的php.ini均添加extension=swoole.so后重启PHP服务。
宝塔面板下 PHP 8.0 安装 Swoole 扩展，**优先走软件商店一键安装；失败或需特定版本时，必须源码编译，且不能跳过 phpize 和 php-config 路径校验**。PHP 8.0 的 Swoole 支持从 4.8.x 开始稳定，5.x 版本需注意 openssl/brotli 等依赖是否就位，否则编译会静默失败。
宝塔软件商店能装就别手动编译
宝塔 8.x 面板在 PHP 8.0 环境中已上架 Swoole4 和部分 Swoole5 选项，只要你的面板是最新版（2026 年 3 月后更新过），直接点装最省事。
常见误操作：
- 点错 PHP 版本：比如你用的是
/www/server/php/80，却去 PHP 74 的设置里找 swoole - 点了「重载」PHP 而非「重启」：重载不加载新扩展，
php -m仍看不到swoole - 装完没验证 CLI 环境：Web 页面能用，但命令行跑
php artisan swoole:http start报错，是因为/www/server/php/80/bin/php的php.ini没同步改
源码编译必须用对 phpize 和 php-config 路径
一旦软件商店没选项，或你要装 swoole-5.1.5 这类新版，就得进终端。关键不是“会不会 make”，而是路径一错全白干。
立即学习“PHP免费学习笔记（深入）”；
正确做法：
- 进入源码目录后，第一句必须是：
/www/server/php/80/bin/phpize（数字 80 必须和你实际 PHP 版本一致） -
./configure时，--with-php-config参数值必须是/www/server/php/80/bin/php-config，不能漏掉/bin/，也不能写成php-config-8.0 - 编译成功后，输出的
Installing shared extensions:路径要记下来，例如/www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/，后面配php.ini时 extension 路径要匹配
extension=swoole.so 不等于万事大吉
很多用户卡在这步：明明 swoole.so 已生成、php.ini 也加了 extension=swoole.so，但 php --ri swoole 报错说找不到模块——根本原因是 PHP CLI 和 FPM 加载了不同的 php.ini。
务必检查两处：
- CLI 用的配置：
/www/server/php/80/bin/php --ini输出的 “Loaded Configuration File” - FPM 用的配置：
/www/server/php/80/etc/php.ini（宝塔默认路径，但以php --ini实际输出为准） - 两个文件末尾都要加
extension=swoole.so，不能只改一个 - 如果启用了 opcache，重启前先清空 opcache 缓存，或临时注释
opcache.enable=0排查
openssl/brotli 等特性启用失败的典型表现
当你在 configure 里加了 --enable-openssl 却编译通过、运行时报 undefined symbol: SSL_CTX_set_alpn_select_cb，说明系统缺 OpenSSL 开发头文件，不是 PHP 扩展问题。
对应修复命令：
- CentOS/RHEL：
yum install openssl-devel brotli-devel - Ubuntu/Debian：
apt install libssl-dev libbrotli-dev - 装完必须重新执行
./configure ... && make clean && make && make install，make clean很关键，否则旧缓存会掩盖链接错误 - 若仅需基础功能（无 HTTPS/WebSocket SSL），可先去掉
--enable-openssl快速验证核心模块是否可用
最易被忽略的一点：宝塔面板里「PHP 设置」页面显示的「当前版本」可能和终端里 which php 返回的不一致，尤其当你用过宝塔百宝箱或自定义 PATH 后。每次验证前，先敲一遍 /www/server/php/80/bin/php --ri swoole，用绝对路径堵死环境混淆。
