答案是检查并安装缺失的PHP扩展。首先根据错误信息确定缺失的扩展名,如ext-gd;然后通过php -m查看已启用的扩展,确认其未激活;接着使用php --ini定位配置文件;最后按操作系统安装对应扩展,如Linux下用apt或yum,Windows下在php.ini中取消extension=gd注释,保存后重启服务。

当你在使用 Composer 安装或更新项目依赖时遇到 "The requested PHP extension is missing" 错误,说明当前 PHP 环境缺少某个扩展(如 ext-gd、ext-curl、ext-mbstring 等),而项目依赖中要求该扩展必须启用。
确认缺失的扩展名称
错误信息通常会明确提示是哪个扩展缺失,例如:
- The requested PHP extension ext-xxx * is missing from your system.记下 xxx(比如 gd、intl、xml、zip 等),这是你需要安装或启用的扩展名。
检查当前 PHP 配置
运行以下命令查看当前激活的扩展:
立即学习“PHP免费学习笔记(深入)”;
php -m在输出列表中查找你缺失的扩展。如果没找到,说明它未启用或未安装。
同时确认你使用的 PHP 版本和配置文件路径:
php --ini这会显示 php.ini 文件的位置,确保你修改的是正确的配置文件。
解决方法:安装或启用扩展
根据你的操作系统选择对应操作:
-
Linux(Ubuntu/Debian):
使用 apt 安装对应扩展包,例如: sudo apt install php-gd
sudo apt install php-curl
sudo apt install php-mbstring -
Linux(CentOS/RHEL):
使用 yum 或 dnf: sudo yum install php-gd
sudo dnf install php-mbstring -
macOS(使用 Homebrew):
如果你通过 brew 安装 PHP,运行: brew install php@8.1-gd (版本号根据实际情况调整) -
Windows:
打开 php.ini 文件(通常位于 PHP 安装目录),找到类似 ;extension=gd 的行,去掉前面的分号: extension=gd 或 extension=php_gd.dll 保存后重启 Web 服务器或 PHP-FPM。
跳过检查(不推荐用于生产)
若只是临时测试,可让 Composer 忽略扩展检查:
composer install --ignore-platform-reqs但这可能导致运行时错误,建议只在开发环境临时使用。
基本上就这些。关键是查清缺哪个扩展,然后在系统中正确安装或启用它。问题通常很快就能解决。











