Composer install 报“PHP extension xxx is missing”是因为它检查当前CLI PHP环境是否满足composer.json中声明的扩展依赖，而CLI与Web环境可能使用不同PHP实例或配置。
为什么 composer install 会报 “PHP extension xxx is missing”？
这不是 Composer 自己的问题，而是它在检查当前 PHP 环境是否满足项目 composer.json 中声明的 require 扩展依赖。比如你写了 "ext-gd": "*"，但当前 CLI 使用的 PHP 没启 gd，就会直接中断。
常见错误现象：
- 报错形如：
PHP extension gd is missing（注意是 CLI 环境，不是 Web 环境） - 同一台机器，
php -m | grep gd看得见，但 Composer 就不认 - Docker 构建时反复失败，本地却正常
关键原因：Composer 用的是 php 命令对应的二进制和配置，和你 phpinfo() 看到的可能根本不是同一个 PHP 实例。
怎么确认当前 Composer 在用哪个 PHP？
别猜，直接问：
立即学习“PHP免费学习笔记（深入）”；
which php
php -i | grep "Loaded Configuration File"
php -m | grep -E '^(gd|mbstring|curl|pdo|xml)$'
实操建议：
- 如果你在 macOS 用 Homebrew，可能有多个 PHP 版本，
brew unlink php@8.1 && brew link php@8.2后再试 - Linux 上检查
/usr/bin/php和/usr/local/bin/php是否指向不同版本 - Docker 中确保
Dockerfile里php -m和composer install在同一层执行，避免缓存导致误判
扩展已装但 Composer 仍报错？重点查 ini 加载路径
PHP 扩展启用靠 .ini 文件，而 CLI 和 FPM 可能加载不同的 conf.d/ 目录。
常见错误现象：
-
php -m能看到扩展，但composer install死活报缺 -
php --ini显示加载了/etc/php/8.2/cli/conf.d/20-gd.ini，但文件实际不存在或被注释
检查步骤：
- 运行
php --ini，看 CLI 配置路径 - 进入该目录，确认对应扩展的
.ini文件存在且未被注释（开头不能有;） - 文件内容应类似：
extension=gd.so（Linux/macOS）或extension=php_gd.dll（Windows） - 某些扩展（如
sqlsrv、pdo_sqlsrv）需额外下载 DLL/so 并手动放对位置，不是apt install就完事
CI/CD 或 Docker 中如何稳定处理扩展依赖？
别依赖宿主机环境，把扩展安装逻辑写死在构建流程里。
实操建议：
- Ubuntu/Debian：用
apt-get install php8.2-gd php8.2-mbstring php8.2-curl，注意版本号必须和php -v一致 - Alpine：用
apk add php82-gd php82-mbstring（包名带版本前缀） - Docker 中避免用
php:alpine这种泛标签，改用php:8.2-cli-alpine3.19，减少不确定性 - Laravel 项目常见组合：
ext-mbstring、ext-xml、ext-zip、ext-pdo—— 缺一不可，尤其ext-zip在 Alpine 上默认不带，要单独装php82-zip
扩展没装全时 Composer 不会给你留情面，它只认 php -m 输出结果。最省事的方式永远是先跑通 php -m，再让 Composer 跑。
