宝塔面板中安装PHP扩展有三种方法:一、通过软件商店勾选安装;二、在PHP管理页面启用已存在扩展;三、命令行手动编译安装。均需根据扩展状态选择对应方式,部分需重启PHP服务。

如果您在宝塔面板中安装PHP环境后发现缺少某些必需的扩展(如redis、swoole、gd、mbstring等),则无法正常运行依赖这些扩展的PHP程序。以下是通过宝塔面板一键安装缺失PHP扩展的具体操作步骤:
一、通过宝塔面板软件商店安装扩展
宝塔面板内置的PHP管理模块支持对已安装PHP版本进行扩展增补,无需手动编译,所有扩展均从官方源同步,兼容性与安全性有保障。
1、登录宝塔面板,在左侧菜单栏点击软件商店,在搜索框中输入当前使用的PHP版本号(例如“PHP 8.2”)并回车。
2、在搜索结果中找到对应PHP版本的安装包,点击右侧设置按钮。
立即学习“PHP免费学习笔记(深入)”;
3、在打开的PHP设置页面中,切换到安装扩展选项卡。
4、在扩展列表中勾选需要安装的扩展名称(如redis、opcache、fileinfo等),勾选完成后点击提交按钮。
5、等待面板执行安装任务,进度条完成后,扩展即生效,无需重启PHP服务(部分扩展需重启生效,面板会自动提示)。
二、通过PHP管理页面直接启用已存在但未启用的扩展
部分扩展虽已随PHP主程序一同安装,但默认处于禁用状态,仅需启用即可使用,不涉及重新编译或下载。
1、进入宝塔面板左侧菜单网站 → 点击PHP管理,选择目标PHP版本。
2、在PHP管理页面中点击配置文件选项卡,查看当前php.ini路径。
3、返回PHP管理首页,切换至禁用函数选项卡,确认所需扩展未被列在禁用列表中。
4、切换至扩展管理选项卡,查找对应扩展名称(如“redis”),若其状态显示为未安装则跳转方法一;若显示为已安装但未启用,则点击右侧启用按钮。
5、启用成功后,面板将自动写入extension指令至php.ini,并提示请重启PHP服务以使配置生效。
三、通过命令行手动安装扩展(适用于商店无对应扩展的情况)
当宝塔软件商店未提供特定PHP扩展(如较新版本的swoole或自定义分支扩展)时,可使用宝塔提供的PHPize路径与编译环境进行手动安装,确保与当前PHP版本完全匹配。
1、通过SSH登录服务器,执行命令获取当前PHP版本及安装路径:/www/server/php -v 与 ls /www/server/php/。
2、进入对应PHP版本的bin目录,例如:cd /www/server/php/82/bin/(其中82代表PHP 8.2)。
3、执行./phpize初始化扩展构建环境。
4、下载对应PHP版本兼容的扩展源码包(如redis-5.3.7.tgz),解压后进入源码目录,执行:./configure --with-php-config=/www/server/php/82/bin/php-config。
5、依次执行make && make install,成功后终端将输出类似Installing shared extensions: /www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/的路径信息。
6、编辑该PHP版本的php.ini文件(路径可通过PHP管理页面查看),在文件末尾新增一行:extension=redis.so(so文件名依实际编译输出为准)。











