先确认缺失的扩展名称和PHP版本，再按系统类型安装对应扩展。例如Ubuntu执行sudo apt install php8.1-mbstring，CentOS用sudo dnf install php-mbstring，macOS用brew install php-ext-intl，Windows则需修改php.ini并启用extension=mbstring，最后通过php -m验证扩展是否加载成功。

安装 Composer 项目时遇到 "The requested PHP extension ... is missing" 错误，说明当前 PHP 环境缺少某些必需的扩展。这在本地开发或部署项目时很常见，尤其是 Laravel、Symfony 等现代 PHP 框架对扩展依赖较多。别担心，这个问题有清晰的解决路径。

1. 明确是哪个扩展缺失

错误信息通常会明确指出缺少的扩展名称，例如：

先复制这个扩展名（如 mbstring），下一步就是安装它。

2. 检查当前 PHP 版本和配置

一台服务器可能安装多个 PHP 版本（如 7.4、8.1、8.2），你必须确保操作的是 Composer 实际使用的那个版本。

运行以下命令查看 PHP 版本和已加载的扩展：

• php -v —— 查看当前 CLI 使用的 PHP 版本
• php -m —— 列出已启用的所有扩展
• php -i | grep extension_dir —— 查看扩展存放目录

确认你要安装的扩展是否真的不在列表中。

3. 根据操作系统安装缺失的扩展

不同系统安装方式不同，以下是主流环境的操作方法：

• 更新包管理器：sudo apt update
• 安装扩展（以 mbstring 为例）：sudo apt install php-mbstring
• 如果你用的是特定版本，比如 PHP 8.1：sudo apt install php8.1-mbstring

其他常用扩展命名类似：

• php8.1-xml
• php8.1-gd
• php8.1-curl
• php8.1-intl
• php8.1-zip

• 安装扩展示例：sudo yum install php-mbstring
• 新版系统使用 dnf：sudo dnf install php-mbstring
• 指定版本：sudo dnf install php81-php-mbstring（取决于 remi 源配置）

• 如果你通过 brew 安装 PHP：brew install php（默认包含多数核心扩展）
• 单独安装扩展（如 intl）：brew install php-ext-intl 或查看对应 formula
• 推荐使用 shivammathur/php 源来管理多版本 PHP

• 打开 php.ini 文件（可通过 php --ini 查找位置）
• 找到类似 ;extension=mbstring 的行，去掉前面的分号
• 保存后重启 Web 服务（Apache/Nginx）
• 如果 .dll 文件不存在，需重新下载对应版本的 PHP 并替换 ext 目录

4. 验证扩展是否生效

修改后运行：

• php -m | grep 扩展名 —— 看是否出现在列表中
• php -r "echo extension_loaded('mbstring') ? 'yes' : 'no';" —— 检查特定扩展

如果返回 yes，说明已加载成功。

5. 多版本 PHP 注意切换正确 SAPI

如果你在同一台机器上使用多个 PHP 版本，注意：

• CLI（命令行）和 Web（Apache/FPM）可能使用不同配置
• 用 which php 和 php --ini 确认 CLI 加载的 php.ini
• Web 端可用 phpinfo() 函数查看实际加载的配置文件
• 确保两个环境都启用了所需扩展

6. 临时跳过依赖检查（不推荐生产环境）

若只是想快速测试项目结构，可临时忽略扩展依赖：

• composer install --ignore-platform-reqs

⚠️ 警告：这会让 Composer 忽略所有平台要求（PHP 版本、扩展等），可能导致运行时报错。仅用于调试或打包用途。

基本上就这些。只要按步骤确认版本、安装对应扩展、验证加载状态，99% 的“missing extension”问题都能解决。关键是搞清楚你用的是哪个 PHP，然后给它装上缺的组件。

# php  # linux  # laravel  # centos  # composer  # php8  # windows  # apache  # nginx  # symfony  # echo  # xml  # cURL  # macos  # ubuntu  # debian  # 的是  # 加载  # 如果你  # 多个  # 扩展名  # 你用  # 系统安装  # 尤其是  # 你要  # 都能 

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

相关推荐： Laravel 419 page expired怎么解决_Laravel CSRF令牌过期处理  Laravel队列任务超时怎么办_Laravel Queue Timeout设置详解  如何用景安虚拟主机手机版绑定域名建站？  Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】  Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】  浅谈redis在项目中的应用  Laravel怎么多语言本地化设置_Laravel语言包翻译与Locale动态切换【手册】  Laravel如何使用Telescope进行调试？（安装和使用教程）  如何构建满足综合性能需求的优质建站方案？  Laravel如何实现API版本控制_Laravel版本化API设计方案  如何快速建站并高效导出源代码？  如何自定义safari浏览器工具栏？个性化设置safari浏览器界面教程【技巧】  美食网站链接制作教程视频,哪个教做美食的网站比较专业点？  如何快速查询网址的建站时间与历史轨迹？  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  进行网站优化必须要坚持的四大原则  Laravel如何实现URL美化Slug功能_Laravel使用eloquent-sluggable生成别名【方法】  如何快速搭建高效香港服务器网站？  如何在建站之星绑定自定义域名？  Laravel模型事件有哪些_Laravel Model Event生命周期详解  如何在不使用负向后查找的情况下匹配特定条件前的换行符  如何在新浪SAE免费搭建个人博客？  Laravel如何构建RESTful API_Laravel标准化API接口开发指南  使用spring连接及操作mongodb3.0实例  Laravel怎么调用外部API_Laravel Http Client客户端使用  中山网站制作网页,中山新生登记系统登记流程？  详解Android——蓝牙技术 带你实现终端间数据传输  Laravel如何编写单元测试和功能测试？（PHPUnit示例）  谷歌Google入口永久地址_Google搜索引擎官网首页永久入口  悟空浏览器如何设置小说背景色_悟空浏览器背景色设置【方法】  在线教育网站制作平台,山西立德教育官网？  最好的网站制作公司,网购哪个网站口碑最好，推荐几个？谢谢？  Laravel如何创建自定义Artisan命令？（代码示例）  网页设计与网站制作内容,怎样注册网站？  Laravel怎么做数据加密_Laravel内置Crypt门面的加密与解密功能  如何在阿里云域名上完成建站全流程？  js代码实现下拉菜单【推荐】  如何利用DOS批处理实现定时关机操作详解  Laravel如何使用API Resources格式化JSON响应_Laravel数据资源封装与格式化输出  作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】  如何在企业微信快速生成手机电脑官网？  关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework)  Midjourney怎样加参数调细节_Midjourney参数调整技巧【指南】  Laravel如何实现API速率限制？（Rate Limiting教程）  阿里云网站搭建费用解析：服务器价格与建站成本优化指南  如何在万网自助建站平台快速创建网站？  如何登录建站主机？访问步骤全解析  购物网站制作费用多少,开办网上购物网站，需要办理哪些手续？  如何快速上传建站程序避免常见错误？  手机软键盘弹出时影响布局的解决方法