一、环境准备与需求确认
在安装PHP扩展前,需通过SSH或控制面板获取以下信息:当前PHP版本(通过php -v
命令查询)、Web服务器类型(Apache/Nginx)、扩展依赖库要求。建议使用phpinfo
函数生成环境报告。
二、通过控制面板安装扩展
主流控制面板(如cPanel)提供可视化扩展管理:
- 登录控制面板,定位「PHP配置」模块
- 在扩展列表勾选目标扩展(如mbstring)
- 点击「应用配置」并重启Web服务
三、使用包管理器安装扩展
支持SSH访问的虚拟主机可通过包管理器快速安装:
- Debian/Ubuntu:
sudo apt install php-[扩展名]
- CentOS/RHEL:
sudo yum install php-[扩展名]
- 安装后需重启PHP-FPM服务生效
四、手动编译安装扩展
特殊扩展需源码编译安装:
cd /path/to/extension_source phpize ./configure --with-php-config=[php-config路径] make && make install
编译完成后需在php.ini
添加extension=扩展名.so
,并重启Web服务。
五、验证与故障排除
创建包含的测试文件,通过浏览器访问检查扩展状态。常见问题包括:
- 扩展未显示:检查php.ini加载路径
- 依赖缺失:使用
ldd
命令检查.so文件依赖 - 版本冲突:通过
pecl install
指定版本安装
虚拟主机安装PHP扩展需根据环境选择控制面板、包管理器或源码编译方式,重点注意权限管理、依赖项检查和配置生效机制。建议优先使用主机商提供的标准化安装方案。