应使用 –ignore-platform-req=ext-gd（非 reqs）精准忽略 GD 扩展，或通过 config.platform 伪造其存在；避免用 –ignore-platform-reqs 全局禁用检查，以防掩盖其他兼容风险。
只忽略 ext-gd，别用 –ignore-platform-reqs
它不是“选择性开关”，而是全局断路器：--ignore-platform-reqs 会跳过所有平台检查（PHP 版本、ext-gd、ext-mbstring、lib-* 等），哪怕你只缺一个扩展，它也把其他所有校验一并关掉——这容易掩盖真实兼容风险。
- 真正想“只绕过
ext-gd”，必须用--ignore-platform-req=ext-gd（注意是复数req，不是reqs） - 可叠加多个：例如同时忽略
ext-gd和ext-redis，就写成composer install --ignore-platform-req=ext-gd --ignore-platform-req=ext-redis - 拼错名字会静默失效：写成
gd、ext-GD或php-gd都不生效，必须严格匹配ext-gd
永久伪造扩展存在，用 config.platform 而不是关检查
在 composer.json 的 config 段里加 platform，是更可控、更可追溯的做法。它不跳过检查，而是让 Composer “相信”扩展已安装。
- 示例配置（放在
composer.json的"config"下）：{ "platform": { "ext-gd": "8.1.0", "ext-redis": "5.3.7" } } - 版本号填什么不重要，只要非空且格式合法（比如
"0"、"1"也行），Composer 就不再报缺失 - 这个设置只影响依赖解析阶段，不会让
imagecreate()在没装 GD 的机器上 magically 工作——运行时仍需真实扩展
CI/CD 构建时怎么安全忽略？别改 composer.json
Docker 或 GitHub Actions 里临时绕过，优先用命令行参数，而不是往项目配置里硬塞 platform，避免污染开发环境。
