需先确认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,内容为,通过浏览器访问,搜索 “swoole”,确认状态为 enabled
常见问题处理
如果安装后不显示或报错,重点检查这几项:










