Composer 报错提示缺少 PHP 扩展，需根据错误信息中 ext- 后的扩展名（如 gd、mbstring）确认缺失项；通过 php -m 检查是否启用，未启用则依系统安装并启用对应扩展，最后验证并重试 Composer 命令。
这个错误说明 Composer 在安装或更新依赖时，发现当前 PHP 环境缺少某个扩展（extension），而项目或某个包的 composer.json 中声明了该扩展为必需（通常在 "require": { "ext-xxx": "*"} 里）。不是 PHP 版本不对，而是某个扩展根本没启用或没安装。
确认缺失的是哪个扩展
错误信息里一般会明确写出扩展名，比如：
The requested PHP extension ext-gd is missing
或
The requested PHP extension ext-mbstring is missing
注意看 ext- 后面的部分（如 gd、mbstring、curl、xml、zip 等），这就是你要装/启用的扩展。
检查当前 PHP 是否已加载该扩展
运行以下命令查看已启用的扩展列表：
php -m | grep -i gd
把 gd 换成你看到的扩展名。如果没输出，说明没启用。
也可以运行：
php -i | grep "Loaded Configuration File"
找到 php.ini 路径，然后用文本编辑器打开它，搜索 extension=gd 或 extension=mbstring 这类行 —— 如果被注释（前面有分号 ;）或根本不存在，就需要处理。
根据系统类型启用或安装扩展
Linux（Ubuntu/Debian）：
立即学习“PHP免费学习笔记（深入）”；
- 先查扩展是否已安装：例如
apt list --installed | grep php-gd - 没装就装：例如
sudo apt install php-gd（对应ext-gd）；sudo apt install php-mbstring；sudo apt install php-xml等 - 装完通常自动启用，但可再执行
sudo phpenmod gd强制启用 - 重启 Web 服务（如 Apache）或 PHP-FPM：
sudo systemctl restart apache2或sudo systemctl restart php8.1-fpm
macOS（Homebrew + PHP）：
- 运行
brew install php-gd（部分扩展已随 php 一起安装，如 mbstring、xml 通常默认开启） - 检查
/usr/local/etc/php/X.X/conf.d/ext-gd.ini是否存在且内容为extension=gd.so - 重启 PHP 服务：
brew services restart php
Windows（XAMPP/WAMP）：
- 打开 php.ini（通常在
XAMPP\php\php.ini或 WAMP 的 php 配置目录） - 搜索
;extension=gd，去掉前面的分号（变成extension=gd）；同理处理mbstring、curl等 - 确认扩展 DLL 文件存在（如
php_gd2.dll在php/ext/目录下） - 重启 Apache 或 Nginx 服务
验证并重试 Composer 命令
改完配置后，务必验证：
php -m | grep -E "(gd|mbstring|curl)"
确保目标扩展出现在输出中。再运行：
composer diagnose
看是否还有扩展缺失提示。最后再执行你的原始命令，比如 composer install 或 composer update。
基本上就这些。不复杂但容易忽略——关键是看清报错里的扩展名，再对症启用，别一上来就重装 PHP。
