宝塔面板如何安装swoole扩展_宝塔swoole安装步骤【扩展】-php教程-PHP中文网

宝塔面板如何安装swoole扩展_宝塔swoole安装步骤【扩展】

蓮花仙者

发布： 2025-12-23 14:53:02

原创

524人浏览过

需先确认PHP版本及路径（如74、80），再按对应路径执行phpize、php-config、编译安装Swoole，最后在php.ini中添加extension=swoole.so并重启PHP服务验证。

宝塔面板如何安装swoole扩展_宝塔swoole安装步骤【扩展】

确认 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（路径同上），在文件末尾添加一行：

MimicPC

一个AI驱动的浏览器运行工具，可以通过浏览器在线安装及运行各种开源的AI应用程序

145

查看详情

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，或检查端口监听是否被拦截