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）：

• 先查扩展是否已安装：例如 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。

# php  # linux  # js  # json  # composer  # php8  # windows  # apache  # nginx  # ubuntu  # require  # xml  # cURL  # macos  # debian  # 扩展名  # 重启  # 报错  # 错误信息  # 重试  # 的是  # 你要  # 这就是  # 出现在  # 这类 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 浏览器如何快速切换搜索引擎_在地址栏使用不同搜索引擎【搜索】  网站页面设计需要考虑到这些问题  Windows Hello人脸识别突然无法使用  Java类加载基本过程详细介绍  如何在宝塔面板中修改默认建站目录？  html5如何实现懒加载图片_ intersectionobserver api用法【教程】  香港服务器网站生成指南：免费资源整合与高速稳定配置方案  实现点击下箭头变上箭头来回切换的两种方法【推荐】  Android自定义listview布局实现上拉加载下拉刷新功能  Laravel Eloquent：优雅地将关联模型字段扁平化到主模型中  为什么要用作用域操作符_php中访问类常量与静态属性的优势【解答】  ai格式如何转html_将AI设计稿转换为HTML页面流程【页面】  Laravel如何集成第三方登录_Laravel Socialite实现微信QQ微博登录  Laravel如何优化应用性能？（缓存和优化命令）  Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  Laravel怎么使用Collection集合方法_Laravel数组操作高级函数pluck与map【手册】  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  Laravel如何配置任务调度？（Cron Job示例）  谷歌浏览器如何更改浏览器主题 Google Chrome主题设置教程  Laravel Asset编译怎么配置_Laravel Vite前端构建工具使用  JS去除重复并统计数量的实现方法  中国移动官方网站首页入口 中国移动官网网页登录  制作ppt免费网站有哪些,有哪些比较好的ppt模板下载网站？  Windows10电脑怎么查看硬盘通电时间_Win10使用工具检测磁盘健康  如何在景安云服务器上绑定域名并配置虚拟主机？  详解Oracle修改字段类型方法总结  Laravel如何配置Horizon来管理队列？（安装和使用）  如何在建站主机中优化服务器配置？  google浏览器怎么清理缓存_谷歌浏览器清除缓存加速详细步骤  Laravel如何使用模型观察者？（Observer代码示例）  深圳网站制作公司好吗,在深圳找工作哪个网站最好啊？  JavaScript数据类型有哪些_如何准确判断一个变量的类型  用v-html解决Vue.js渲染中html标签不被解析的问题  Laravel如何获取当前登录用户信息_Laravel Auth门面使用与Session用户读取【技巧】  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  如何在搬瓦工VPS快速搭建网站？  Laravel如何处理表单验证？（Requests代码示例）  桂林网站制作公司有哪些,桂林马拉松怎么报名？  如何快速搭建支持数据库操作的智能建站平台？  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办？  微信小程序 HTTPS报错整理常见问题及解决方案  悟空识字如何进行跟读录音_悟空识字开启麦克风权限与录音  高端企业智能建站程序：SEO优化与响应式模板定制开发  Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门  电商网站制作价格怎么算,网上拍卖流程以及规则？  Laravel Docker环境搭建教程_Laravel Sail使用指南  Laravel如何监控和管理失败的队列任务_Laravel失败任务处理与监控  Laravel如何优雅地处理服务层_在Laravel中使用Service层和Repository层  阿里云网站搭建费用解析：服务器价格与建站成本优化指南