需先确认PHP版本及路径（如74、80），再按对应路径执行phpize、php-config、编译安装Swoole，最后在php.ini中添加extension=swoole.so并重启PHP服务验证。
确认 PHP 版本和路径
安装前先明确你用的是哪个 PHP 版本（如 7.4、8.0、8.1），因为路径和命令中的数字必须严格对应。在宝塔面板中，进入「软件商店 → 已安装」，找到对应 PHP 版本，点击「设置」即可看到版本号和安装路径。常见路径格式为：/www/server/php/74、/www/server/php/80 等。后续所有操作（phpize、php-config、扩展目录）都依赖这个路径。
下载并编译安装 Swoole 源码
推荐从 PECL 官方下载稳定版（如 swoole-5.1.5），避免 GitHub 被墙导致失败：
- 进入临时目录，例如：
cd /www/server - 下载源码：
wget https://pecl.php.net/get/swoole-5.1.5.tgz -
解压并进入：
tar -zxvf swoole-5.1.5.tgz && cd swoole-5.1.5 - 调用对应 PHP 的 phpize：
/www/server/php/74/bin/phpize（请按实际版本替换 74） - 配置编译参数：
./configure --with-php-config=/www/server/php/74/bin/php-config - 编译安装：
make && make install
成功后会提示类似 Installing shared extensions: /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/，记住这个路径。
启用扩展并验证
编辑对应 PHP 版本的配置文件：/www/server/php/74/etc/php.ini（路径同上），在文件末尾添加一行：
extension = swoole.so
保存后，在宝塔面板中点击「重启 PHP」服务（不是重载，是完整重启）。然后执行以下任一方式验证：
- 终端运行：
php -m | grep swoole—— 应输出swoole - 终端运行：
php --ri swoole—— 显示详细版本与配置说明 - 新建
info.php，内容为<?php phpinfo(); ?>，通过浏览器访问，搜索 “swoole”，确认状态为 enabled
常见问题处理
如果安装后不显示或报错，重点检查这几项：
- PHP 命令行版本是否和宝塔面板里设置的版本一致？可用
which php和php -v查看；不一致时需用全路径调用，例如/www/server/php/74/bin/php -m - 扩展名是否写对？确保
swoole.so（不是 .dll 或其他）且路径中无拼写错误 - 缺少依赖库？比如提示 brotli 相关错误，执行
yum install brotli-devel（CentOS/RHEL）或apt install libbrotli-dev（Ubuntu/Debian） - SELinux 或防火墙未关闭？临时禁用测试：
setenforce 0，或检查端口监听是否被拦截
以上就是宝塔面板如何安装swoole扩展_宝塔swoole安装步骤【扩展】的详细内容，更多请关注php中文网其它相关文章！
相关标签：