应使用--ignore-platform-req=ext-gd精准跳过GD扩展检查，参数须严格匹配大小写及ext-前缀，不影响其他扩展和PHP版本校验，也不改变依赖解析逻辑或锁文件内容。
composer install 怎么只跳过 ext-gd 检查
用 --ignore-platform-req=ext-gd 就行，它只绕过对 GD 扩展的校验，其他扩展（如 ext-mbstring、ext-pdo）和 PHP 版本仍会照常检查。常见于本地开发机没装 GD，但你确认项目里压根不调用图像处理功能。
注意大小写和前缀必须完全匹配依赖声明：如果 composer.json 或某个包的 require 里写的是 "ext-imagick": "*"，就得用 --ignore-platform-req=ext-imagick，写成 imagick 或 ext-Imagick 都无效。
-
--ignore-platform-req=ext-gd不影响composer.lock内容，也不改变依赖解析逻辑 - 若同时要跳过 PHP 版本，得叠加使用：
composer install --ignore-platform-req=php --ignore-platform-req=ext-gd - 该参数对
composer require和composer update同样生效
为什么 --ignore-platform-reqs=true 会报错
因为 Composer 不认 =true 这种写法。--ignore-platform-reqs 是布尔开关，有就启用，没有就不启用；加 =true 属于非法参数格式，直接导致命令失败，错误信息类似：Unrecognized option "--ignore-platform-reqs=true"。
同理，--ignore-platform-req=php=true 也是错的——--ignore-platform-req 后面只接受一个标识符（如 php、ext-zip），不能带值。
- 正确写法只有两种：
--ignore-platform-reqs（全局跳过）或--ignore-platform-req=xxx（精准跳过） - 拼写也必须严格：
--ignore-platform-req（少个s）或--ignore-platform-reqs（多写=true）都会被拒绝 - Composer 2.9.6 仍保持该行为，无兼容性松动
CI 中怎么安全忽略缺失的 ext-swoole
在 GitHub Actions 或 GitLab CI 里，别直接上 --ignore-platform-reqs。更稳妥的做法是：先确保运行时镜像已安装 ext-swoole（比如 Dockerfile 里执行 docker-php-ext-install swoole），再用 --ignore-platform-req=php 处理版本微差——这样既避开平台校验卡点，又保留对扩展的真实检查。
如果构建阶段确实还来不及装扩展（例如扩展需在 composer install 后才编译），那就只忽略那个明确知道不影响当前步骤的项：
- 仅构建 vendor 目录？用
composer install --no-scripts --ignore-platform-req=ext-swoole - 后续启动服务前，必须验证
php -m | grep swoole真实存在，否则artisan octane:start一定崩在Class 'Swoole\Http\Server' - 切勿在
composer create-project时不加参数就硬上——它同样受平台检查限制，得显式带上--ignore-platform-req=ext-swoole
ignore-platform-req 和 conflict 规则冲突吗
不冲突。--ignore-platform-req=ext-redis 只跳过“扩展是否存在”的检查，但不会绕过 conflict 声明。比如某个包写了 "conflict": {"php": ">=8.3"}，而你本地是 PHP 8.3.1，即使加了 --ignore-platform-req=php，Composer 依然会拒绝安装。
也就是说：平台要求（platform reqs）和冲突规则（conflict）是两套独立校验机制。前者管“环境有没有”，后者管“能不能共存”。忽略前者，后者照常生效。
-
conflict是包作者写的硬约束，Composer 强制执行，无法用任何 ignore 参数绕过 - 想绕开
conflict，唯一办法是换包、改源码，或联系维护者调整声明 - 运行时报
Class 'Redis' not found，大概率不是没加--ignore-platform-req=ext-redis，而是根本没装扩展，或者 opcache 缓存了旧的 autoloader
真正容易被忽略的点是：这个参数只作用于安装/更新那一刻的校验，它不干预后续任何运行时行为。装完之后，代码里调 imagecreatefrompng() 还是会因缺 GD 而 fatal error——--ignore-platform-req=ext-gd 只是让 Composer 把手松开了一秒，没帮你把扩展补上。
