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

这个错误说明 Composer 检测到你的项目 composer.json 中声明了某个 PHP 扩展（比如 mbstring、gd、pdo_mysql 等），但当前 PHP 环境里没有启用它。

确认缺失的扩展名

错误信息里的 xxx 就是实际缺失的扩展名，例如：

• The requested PHP extension gd is missing
• The requested PHP extension zip is missing
• The requested PHP extension sodium is missing

先把它记下来，这是后续操作的关键。

检查当前 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 服务。