首先确认缺失的扩展名称,如 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.
检查当前 PHP 是否已安装该扩展
在终端运行以下命令查看已启用的扩展:php -m | grep mbstring
启用或安装缺失的 PHP 扩展
根据你的操作系统和 PHP 安装方式选择对应操作:-
Linux(Ubuntu/Debian):
运行命令安装扩展包,例如:
sudo apt-get install php-mbstring
sudo apt-get install php8.1-mbstring
-
Linux(CentOS/RHEL/Fedora):
使用 yum 或 dnf:
sudo yum install php-mbstring 或 sudo dnf install php-mbstring
-
macOS(使用 Homebrew):
若通过 brew 安装 PHP:
brew install php@8.1(某些版本默认包含 mbstring)
-
Windows:
打开 php.ini 文件(通常位于 PHP 安装目录),找到并取消注释这一行:
;extension=mbstring → 改为 extension=mbstring
验证扩展是否生效
再次运行:php -m | grep mbstring
也可以创建一个 PHP 文件测试:
完成上述步骤后,重新运行 Composer 命令:
composer install 或 composer update
基本上就这些。关键在于确保 PHP 运行环境中实际安装并启用了所需扩展,Composer 才能继续安装依赖。










