首先确认缺失的扩展名称,如 mbstring;然后通过 php -m 检查是否已安装;根据操作系统使用对应命令安装或启用扩展,如 linux 下 sudo apt-get install php8.1-mbstring;最后验证扩展是否生效并重新运行 composer 命令。

当你在使用 Composer 安装或更新 PHP 项目依赖时,遇到类似 “requires ext-mbstring *” 的错误,说明当前 PHP 环境缺少项目所依赖的 PHP 扩展(如 mbstring)。这类问题不是 Composer 本身的问题,而是运行环境未满足依赖要求。以下是解决方法:
确认缺失的扩展名称
错误信息中会明确指出缺少哪个扩展,例如:
your-project v1.0.0 requires ext-mbstring * -> it is missing from your system.
这里缺少的是 mbstring 扩展。其他常见扩展还包括 json、dom、xml、curl 等。
检查当前 PHP 是否已安装该扩展
在终端运行以下命令查看已启用的扩展:
php -m | grep mbstring
如果无输出,说明扩展未启用或未安装。
启用或安装缺失的 PHP 扩展
根据你的操作系统和 PHP 安装方式选择对应操作:
sudo apt-get install php-mbstring
如果你使用的是特定版本的 PHP(如 8.1),则写为:
sudo apt-get install php8.1-mbstring
sudo yum install php-mbstring 或 sudo dnf install php-mbstring
- macOS(使用 Homebrew):
若通过 brew 安装 PHP:
brew install php@8.1(某些版本默认包含 mbstring)
或手动确认扩展是否在配置目录中启用。
;extension=mbstring → 改为 extension=mbstring
保存后重启 Web 服务器(如 apache 或 nginx)或 PHP-FPM。
验证扩展是否生效
再次运行:
php -m | grep mbstring
看到输出 mbstring 表示成功启用。
也可以创建一个 PHP 文件测试:
<?php var_dump(extension_loaded('mbstring')); ?>
返回 true 即表示已加载。
完成上述步骤后,重新运行 Composer 命令:
composer install 或 composer update
此时应该不会再报 ext-mbstring 缺失的错误。
基本上就这些。关键在于确保 PHP 运行环境中实际安装并启用了所需扩展,Composer 才能继续安装依赖。
以上就是composer如何解决“requires ext-mbstring *”这类扩展依赖问题的详细内容,更多请关注php中文网其它相关文章!


