Composer报错表明PHP缺少composer.json中声明的扩展,需先记下错误中的扩展名(如gd、zip),再通过php -m检查是否启用,未启用则按系统安装对应扩展包并重启服务。

这个错误说明 Composer 检测到你的项目 composer.json 中声明了某个 PHP 扩展(比如 mbstring、gd、pdo_mysql 等),但当前 PHP 环境里没有启用它。
确认缺失的扩展名
错误信息里的 xxx 就是实际缺失的扩展名,例如:
The requested PHP extension gd is missingThe requested PHP extension zip is missingThe requested PHP extension sodium is missing
先把它记下来,这是后续操作的关键。
检查当前 PHP 是否已安装该扩展
在终端运行:
立即学习“PHP免费学习笔记(深入)”;
php -m | grep -i xxx
或者查看完整扩展列表:
php -m
如果没看到对应模块,说明确实没启用。注意大小写不敏感,但拼写要一致(如 mysqli 不是 mysql)。
启用或安装缺失的扩展
不同系统操作方式不同:
-
Ubuntu/Debian:运行
sudo apt install php-xxx(如php-gd、php-zip),然后重启 Web 服务(sudo systemctl restart apache2或sudo systemctl restart php8.1-fpm) -
CentOS/RHEL:用
sudo yum install php-xxx或sudo dnf install php-xxx(如php-gd) -
macOS(Homebrew + PHP):运行
brew install php-xxx,或检查php.ini中是否已取消注释extension=xxx.so -
Windows(XAMPP/WAMP):打开
php.ini,去掉对应行前的分号,例如;extension=gd→extension=gd,然后重启 Apache
验证 PHP 配置是否生效
运行 php --ini 查看正在加载的 php.ini 路径,确认你修改的是那个文件。再执行 php -m 确认扩展已列出。也可以建个 info.php 文件写 ,用浏览器访问查看扩展状态。
基本上就这些。关键是定位扩展名、装对包、配对配置、重启服务。别跳步骤,尤其别忘了重启 PHP 或 Web 服务。











