如何解决The requested PHP extension xxx is missing的Composer错误？

Composer 报错因 PHP 缺少 composer.json 所需扩展，需确认其调用的 PHP 版本及 php.ini 路径，检查并启用对应扩展（如 extension=redis.so），用 php -m 或 phpinfo() 验证加载，必要时通过 COMPOSER_PHP 指定正确 PHP 环境。

这个错误说明 Composer 检测到当前 PHP 环境缺少项目 composer.json 中声明所依赖的某个扩展（比如 ext-gd、ext-mbstring、ext-curl 等），导致无法继续安装或更新依赖。

确认当前 PHP 版本和配置路径

Composer 可能调用的是系统默认 PHP，而非你预期的版本（例如通过 Homebrew、XAMPP、Docker 或手动编译安装的 PHP）。先运行：

which php<br>php -v<br>php -i | grep "Loaded Configuration File"

登录后复制

注意输出的 PHP 路径和 php.ini 位置。Composer 默认使用该 PHP 二进制及其扩展配置 —— 如果你改了别的 php.ini 却没改对这个，扩展就“看不见”。

检查并启用缺失的 PHP 扩展

根据报错中的扩展名（如 ext-redis），确认它是否已安装并启用：

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

标签： php linux redis js json docker composer php8 windows 浏览器 ubu