如何解决Ubuntu 20.04上PHP扩展安装失败的处理方法？

首先检查PHP版本和路径，确保使用正确的PHP版本；接着安装php-dev等开发包以支持编译；优先通过pecl或apt安装扩展；必要时从源码手动编译并配置php.ini加载。

如果您在Ubuntu 20.04系统中尝试安装PHP扩展时遇到依赖缺失、命令无法识别或编译失败等问题，可能是由于软件源配置不当、PHP版本不匹配或缺少必要构建工具所致。以下是针对此类问题的多种处理方式。

本文运行环境：Dell XPS 13，Ubuntu 20.04

一、检查并启用正确的PHP版本

Ubuntu 20.04可能同时安装多个PHP版本，若未正确指向目标版本，会导致扩展安装失败。需确认当前CLI和Apache/FPM使用的是同一PHP版本。

1、运行 php -v 查看当前PHP版本。

立即学习“PHP免费学习笔记（深入）”；

2、执行 which php 确认PHP二进制文件路径。

3、若使用Apache，编辑对应配置文件如 /etc/apache2/mods-available/phpX.X.conf，确保加载正确的模块。

4、通过 sudo update-alternatives --config php 设置默认PHP版本。

二、安装PHP开发包和通用工具

缺少php-dev或php-pear包将导致无法编译扩展。这些包包含头文件和构建脚本，是安装自定义扩展的前提条件。

1、更新系统包列表：sudo apt update。

2、安装核心开发组件：sudo apt install php-dev php-pear。

3、根据实际PHP版本指定安装，例如：sudo apt install php7.4-dev。

4、验证pear是否可用，运行 pear version 检查输出结果。

三、使用官方扩展管理工具pecl安装

PECL是PHP官方的扩展仓库，支持直接下载、编译并注册扩展，适用于大多数第三方模块。

1、确保已安装php-pear后，尝试安装示例扩展：sudo pecl install redis。

2、安装完成后，手动添加扩展到php.ini文件：echo "extension=redis.so" | sudo tee -a /etc/php/7.4/cli/php.ini。

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

31

查看详情

3、针对不同SAPI环境（如Apache），还需修改对应目录下的php.ini，例如 /etc/php/7.4/apache2/php.ini。

4、重启服务以应用更改：sudo systemctl restart apache2。

四、通过apt包管理器安装预编译扩展

对于常用扩展，Ubuntu官方源提供预编译deb包，避免手动编译带来的兼容性问题。

1、搜索可用的PHP扩展包：apt search php- | grep -i extension-name。

2、安装指定扩展，例如安装cURL支持：sudo apt install php-curl。

3、启用其他常见扩展如GD、MySQLi、Zip等：sudo apt install php-gd php-mysql php-zip。

4、检查扩展是否生效：php -m | grep curl。

五、手动编译源码方式安装扩展

当PECL不可用或需要特定版本时，可从源码手动编译扩展，此方法灵活性最高但操作复杂度较高。

1、下载对应扩展的源码压缩包或克隆GitHub仓库，例如：git clone https://github.com/phpredis/phpredis.git。

2、进入源码目录并初始化构建环境：cd phpredis && phpize。

3、运行configure脚本生成Makefile：./configure。

4、执行编译命令：make && sudo make install。

5、将生成的redis.so路径写入php.ini文件中，并确认extension_dir指向正确目录。

以上就是如何解决Ubuntu 20.04上PHP扩展安装失败的处理方法？的详细内容，更多请关注php中文网其它相关文章！