先确认缺失的扩展名称和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 框架对扩展依赖较多。别担心，这个问题有清晰的解决路径。
错误信息通常会明确指出缺少的扩展名称，例如：
The requested PHP extension ext-name (e.g., mbstring, gd, intl, xml) is missing from your system.先复制这个扩展名（如 mbstring），下一步就是安装它。
一台服务器可能安装多个 PHP 版本（如 7.4、8.1、8.2），你必须确保操作的是 Composer 实际使用的那个版本。
立即学习“PHP免费学习笔记（深入）”；
运行以下命令查看 PHP 版本和已加载的扩展：
php -v —— 查看当前 CLI 使用的 PHP 版本php -m —— 列出已启用的所有扩展php -i | grep extension_dir —— 查看扩展存放目录确认你要安装的扩展是否真的不在列表中。
不同系统安装方式不同，以下是主流环境的操作方法：
Ubuntu / Debian 系统
sudo apt update
sudo apt install php-mbstring
sudo apt install php8.1-mbstring
其他常用扩展命名类似：
php8.1-xmlphp8.1-gdphp8.1-curlphp8.1-intlphp8.1-zipsudo yum install php-mbstring
sudo dnf install php-mbstring
sudo dnf install php81-php-mbstring（取决于 remi 源配置）brew install php（默认包含多数核心扩展）brew install php-ext-intl 或查看对应 formulaphp --ini 查找位置）;extension=mbstring 的行，去掉前面的分号修改后运行：
php -m | grep 扩展名 —— 看是否出现在列表中php -r "echo extension_loaded('mbstring') ? 'yes' : 'no';" —— 检查特定扩展如果返回 yes，说明已加载成功。
如果你在同一台机器上使用多个 PHP 版本，注意：
which php 和 php --ini 确认 CLI 加载的 php.iniphpinfo() 函数查看实际加载的配置文件若只是想快速测试项目结构，可临时忽略扩展依赖：
composer install --ignore-platform-reqs⚠️ 警告：这会让 Composer 忽略所有平台要求（PHP 版本、扩展等），可能导致运行时报错。仅用于调试或打包用途。
基本上就这些。只要按步骤确认版本、安装对应扩展、验证加载状态，99% 的“missing extension”问题都能解决。关键是搞清楚你用的是哪个 PHP，然后给它装上缺的组件。
以上就是Composer安装时提示 "The requested PHP extension ... is missing" 怎么办_PHP扩展依赖问题的终极解决方案的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
795
收藏
