Composer报ext-xxx缺失本质是PHP CLI环境未启用对应扩展，需先用php --ini定位CLI配置文件、php -m验证加载状态、按系统规范安装扩展并重启服务，且CLI与Web配置常不一致。
Composer 报 ext-xxx 缺失，不是 Composer 有问题，而是你当前 CLI 模式下运行的 PHP 没加载那个扩展——改对配置、装对包、重启对服务，三步缺一不可。
确认 Composer 实际用的是哪个 PHP 和 php.ini
很多人只在 Apache 的 php.ini 里开了 extension=mbstring，但 Composer 走的是 CLI 模式，用的是另一份配置。不查清楚就乱改，纯属白忙。
- 运行
composer --version看它背后调用的 PHP 版本 - 再执行
php -v和php --ini，重点看 Loaded Configuration File 那行路径 - 打开那个
php.ini，搜索extension=xxx（比如extension=zip），确认没被分号注释 - 如果整行不存在，Linux/macOS 加
extension=zip.so，Windows 加extension=php_zip.dll
按系统和安装方式装扩展，不能只改 ini
光写 extension= 行没用，.so 或 .dll 文件得真存在，且 extension_dir 得指向对的位置。不同安装方式路径差异极大。
- Ubuntu/Debian：
sudo apt install php8.2-zip（版本号必须匹配php -v输出），它会自动在/etc/php/8.2/cli/conf.d/下生成启用文件 - macOS Homebrew：
brew install php@8.2-zip，然后检查php -r "echo ini_get('extension_dir');"输出路径下是否有zip.so - Windows XAMPP：打开
php.ini，确认extension_dir = "ext"，再取消;extension=php_zip.dll前的分号 - Docker：
RUN docker-php-ext-install zip curl mbstring，别用apt install php-zip，那装的是系统包，PHP 加载不到
--ignore-platform-req=ext-xxx 是临时绕过，不是解决方案
这个参数只跳过安装时校验，不解决运行时问题。代码里调了 gd_info()，而没装 ext-gd，照样 Fatal error。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
composer install --ignore-platform-req=ext-gd（必须带ext-前缀，大小写敏感） - 多个扩展重复写：
--ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring - 比
--ignore-platform-reqs更安全，但它不修改composer.lock，也不让扩展真正生效 - CI 或离线部署可用，但上线前必须补全真实扩展，否则上线即崩
用 platform 配置“伪声明”扩展更可控
比起命令行加参数，把环境适配逻辑固化在项目里更可靠，尤其多人协作或容器部署时。
- 在
composer.json的config段加：
"config": {
"platform": {
"ext-gd": "1.0",
"ext-mbstring": "1.0",
"ext-openssl": "1.0"
}
}
require 到相关类时会报错最容易被忽略的点是：CLI 和 Web 的 php.ini 完全独立，连 extension_dir 都可能指向不同路径；装完扩展后不重启 PHP-FPM 或 Apache，php -m 也看不到新模块——验证必须用 php -m | grep xxx，而不是靠浏览器里 phpinfo()。
