Composer install报ext-xxx缺失，是因为它在解析依赖前强制检查php -m中未启用或版本不匹配的扩展，需通过php -m验证、php --ini定位配置并启用extension=xxx。
Composer install 时为什么突然报 ext-xxx 缺失？
因为 Composer 在解析依赖树前，会强制检查 composer.json 中所有 ext-* 声明（包括你项目直接 require 的，也包括下游包间接声明的），只要当前 PHP 环境里没加载对应扩展，或版本不匹配，就会中断安装并报错。
常见错误信息长这样：Problem 1 - Root composer.json requires ext-curl * but it is missing from your system. 或更隐蔽的：ext-json ^1.5 is required, but 1.4.0 is installed.
- 检测发生在
composer install/update阶段早期，早于自动加载器初始化 - 它读的是
php -m输出的已启用扩展列表，不是phpinfo()页面里的“已编译”状态 - 版本比对逻辑较简单：多数扩展不提供
PHP_VERSION_ID式精确版本号，Composer 实际依赖phpversion('json')返回值，而该值可能为空或格式不规范（如"1.5.0"vs"1.5"） - 注意：
ext-*检查和php版本检查是独立流程，但共享同一套 platform 校验机制
如何让 Composer 正确识别你已装好的扩展？
不是装了就完事——必须确保扩展被 PHP CLI 和 Web SAPI 同时加载，且版本可被 phpversion() 正确返回。
- Linux/macOS 下确认扩展是否生效：
php -m | grep curl；若无输出，说明未启用 - 检查
php.ini路径：php --ini，然后确认对应 ini 文件中存在类似extension=curl或extension=php_curl.dll（Windows） - 某些扩展（如
ext-igbinary）需额外配置igbinary.compact_strings=0才能被正确识别版本 - 重启 PHP-FPM / Apache / Nginx 后，CLI 和 Web 环境可能仍用不同配置 —— 用
php -i | grep "Loaded Configuration File"分别验证
config.platform.ext-* 是“骗过”Composer 还是真实模拟？
它是明确的“环境降级声明”，不是欺骗。当你在 composer.json 中写："config": { "platform": { "ext-gd": "0" } }，Composer 就会彻底忽略系统实际加载的 gd 扩展，转而按你声明的版本做依赖解析。
立即学习“PHP免费学习笔记（深入）”；
这在 CI/CD 或多环境部署中极关键：
- 生产环境没装
ext-memcached，但本地有 —— 不加platform，composer install会成功，上线却炸 - 你想测试兼容性：声明
"ext-json": "1.3.0"，即使你本地是 1.5.0，Composer 也会只允许满足 1.3.0 要求的包被选中 - 注意：
platform只影响依赖解析阶段，不影响运行时行为 —— 它不会禁用扩展，也不会修改php.ini
为什么 ext-dom 冲突提示里出现两个不同版本范围？
这是 Composer 依赖解析器发现多个上游包对同一扩展提出互斥要求时的标准输出，本质是版本约束无法同时满足。
例如：library-a 要求 ext-dom >=3.0, ，而 <code>framework-b 要求 ext-dom >=2.9, —— 交集是 <code>[3.0, 3.1)，看似有解，但 Composer 解析器会进一步校验 ABI 兼容性（尤其 PHP 8.6+ 引入的扩展 ABI 标识），若底层符号表不一致，仍判为冲突。
- 这类冲突在升级 major 版本的框架时高频出现（如 Symfony 6 → 7、Laravel 10 → 11）
- 不能靠
--ignore-platform-reqs绕过 —— 它跳过的是“是否存在”，不是“是否兼容” - 真正解法是：查清哪个包在强依赖特定
ext-dom版本，再看它是否有新版支持更宽泛范围，或提交 issue 推动维护者放宽约束
最易被忽略的一点：PHP 扩展的版本号由扩展自身决定，不是 PHP 主版本号；ext-dom 的 3.x 版本可能只存在于 PHP 8.4+，而你用的是 8.3 —— 此时即便声明 "ext-dom": "*"，Composer 也无法装入一个根本不存在的版本。
