解决composer“requires ext-mbstring *”这类PHP扩展缺失问题

首先确认缺失的扩展名称，如ext-mbstring、ext-gd等；接着通过php -m检查是否已加载；然后根据系统选择对应包管理工具安装，如Ubuntu用apt、CentOS用yum或dnf、macOS用brew、Docker在Dockerfile中用docker-php-ext-install；安装后重启Web服务或PHP-FPM；最后用php -m验证并重新运行composer install即可解决依赖问题。

当你在使用 Composer 安装或更新 PHP 项目依赖时，遇到类似 "requires ext-mbstring *" 的错误提示，说明当前 PHP 环境缺少某个必需的扩展（如 mbstring、xml、gd 等）。这类问题很常见，尤其在新环境或 Docker 镜像中。下面介绍几种有效解决方法。

确认缺失的扩展名称

错误信息通常会明确指出缺少哪个扩展，例如：

这些都属于 PHP 的原生扩展，需要在 PHP 编译或配置时启用。

检查当前已加载的扩展

运行以下命令查看当前 PHP 支持的扩展列表：

立即学习“PHP免费学习笔记（深入）”；

php -m

在输出结果中查找 mbstring、xml、gd 等关键词。如果没找到，说明未启用。

安装缺失的 PHP 扩展

根据你的操作系统选择对应方法：

Ubuntu / Debian 系统：

使用 apt 安装扩展包：

sudo apt update<br>sudo apt install php-mbstring<br>sudo apt install php-xml<br>sudo apt install php-gd

如果你使用的是特定版本的 PHP（如 8.1），请指定版本：

sudo apt install php8.1-mbstring

CentOS / RHEL / Fedora：

使用 yum 或 dnf：

sudo yum install php-mbstring

或（较新系统）：

sudo dnf install php-mbstring

macOS（使用 Homebrew）：

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

22

查看详情

如果你通过 brew 安装了 PHP：

brew install php@8.1

某些扩展可能已包含在内。若单独安装失败，考虑重装 PHP 并确保配置完整。

Docker 环境：

在 Dockerfile 中添加扩展安装命令：

RUN docker-php-ext-install mbstring

对于某些需要额外库的扩展（如 gd），先安装系统依赖：

RUN apt-get update && apt-get install -y libpng-dev<br>RUN docker-php-ext-install gd

重启 Web 服务或 CLI 测试

安装完成后，重启相关服务：

sudo systemctl restart apache2

或如果你用的是 Nginx + PHP-FPM：

sudo systemctl restart php8.1-fpm

然后再次运行：

php -m | grep mbstring

确认扩展已加载。

最后重新执行 Composer 命令：

composer install

问题通常即可解决。

基本上就这些。关键是识别缺失扩展、正确安装并确保其被 PHP 加载。不同系统包管理方式略有差异，但思路一致。

以上就是解决composer“requires ext-mbstring *”这类PHP扩展缺失问题的详细内容，更多请关注php中文网其它相关文章！