首先确认缺失的扩展名称，如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 镜像中。下面介绍几种有效解决方法。
确认缺失的扩展名称
错误信息通常会明确指出缺少哪个扩展，例如：
- requires ext-mbstring *- requires ext-gd *
- requires ext-dom *
这些都属于 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）：
如果你通过 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 加载。不同系统包管理方式略有差异，但思路一致。
