Composer不安装PHP扩展，仅在install/update时检查composer.json声明的ext-*依赖是否已通过php -m启用；缺失则中止并报错，解决需确认CLI环境php.ini启用对应extension，或用--ignore-platform-req=ext-xxx临时跳过。
Composer 本身不编译、不检测、也不安装 PHP C 扩展——它只管理 PHP 包（即 vendor/ 下的纯 PHP 代码），对 ext-redis、ext-gd、ext-swoole 这类 C 扩展完全无感知。所谓“自动检测”，实际是靠包作者在 composer.json 的 require 字段声明 ext-xxx，再由 Composer 在 install 或 update 阶段检查 php -m 输出是否包含该模块名。
为什么 composer install 会突然失败并提示 ext-xxx missing
这不是网络或权限问题，而是 Composer 在解析依赖时读到了某个包的 composer.json 中写了："require": {"ext-gd": "*"} 或 "ext-openssl": "^1.0"。它会立刻调用 PHP 的 extension_loaded() 检查本地环境——失败就中止，不写入 composer.lock，也不下载任何包。
- 常见触发点：装
intervention/image（依赖ext-gd或ext-imagick）、laravel/sanctum（某些版本要求ext-openssl）、amphp/amp（要求ext-sodium） - 注意：版本号如
"ext-redis": "^5.3"不代表扩展的「发布版本」，而是 PHP 内部PHP_VERSION_ID对应的 ABI 兼容标识，实际只校验是否存在、是否启用 - Windows 用户常被
ext-xdebug卡住：即使已安装，若xdebug.mode=off或未启用，Composer 仍判定为 missing
如何绕过 ext-xxx 检查（仅限开发/调试）
用 --ignore-platform-reqs 可跳过所有扩展和 PHP 版本检查，但这不解决运行时错误——只是让 Composer 继续执行。后续 php artisan serve 或 php index.php 仍会因扩展缺失而 fatal error。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时跳过全部：
composer install --ignore-platform-reqs - 只跳过某几个扩展：
composer install --ignore-platform-req=ext-gd --ignore-platform-req=ext-redis - 生产环境严禁使用该参数；CI 流水线中若用了，必须配套加
php -m | grep gd等 shell 校验步骤
如何让项目启动前自动报错更明确
Composer 的报错只说 The requested PHP extension ext-gd is missing from your system，但不告诉你哪个包需要它。这时要结合 composer why-not 和手动扫描：
- 先确认当前缺失哪些扩展：
php -m | sort对比你预期的列表 - 查谁在 require 它：
composer depends --tree ext-gd—— 输出会显示类似intervention/image -> ext-gd - 如果输出为空，说明不是直接依赖，而是某包的
require-dev或其子依赖引入的；此时加--with-all-dependencies重试 - 某些私有包把扩展检查写在
post-install-cmd脚本里（非 Composer 原生机制），需看composer.json的scripts字段
真正棘手的是交叉场景：比如你用 Docker，Dockerfile 装了 gd，但 CLI 和 FPM 使用不同 php.ini，导致 Composer 检查通过、Web 请求却报 Call to undefined function imagecreatefrompng()。这种问题不会在 composer install 阶段暴露，得靠运行时日志和 phpinfo() 对齐两套配置。
