首先检查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中文网其它相关文章！
