离线执行 composer install 时应使用 --ignore-platform-reqs 参数跳过平台约束检查，该参数直接禁用 php/扩展版本校验，不篡改运行时行为，比伪造 platform 配置更安全可靠。
composer install 时提示 platform-check 失败，离线怎么跳过？
离线环境执行 composer install 报错 Your platform does not meet the minimum requirements，本质是 Composer 2.2+ 默认开启的平台约束检查在联网时会校验 PHP/扩展版本是否匹配 platform 配置，但离线时它仍会尝试验证（哪怕没网络），且不自动降级行为。
关键不是“关掉检查”，而是让 Composer 完全跳过这层校验逻辑 —— 因为离线时你已确认环境可用，不需要它多此一举。
- 加
--ignore-platform-reqs参数：最直接，跳过所有平台依赖检查（PHP 版本、扩展、扩展版本） - 加
--no-scripts可选：避免某些脚本因扩展缺失而失败（比如phpunit或infection的 post-install-cmd） - 不要用
config platform伪造版本：离线时改composer.json的platform字段容易引发运行时错误，比如实际没安装ext-gd却声明了，后续代码崩得更隐蔽
为什么 --ignore-platform-reqs 比修改 platform 更可靠？
platform 是用来“声明当前环境能力”的，不是“欺骗 Composer”。你在离线机器上把 "ext-gd": "8.1.0" 写进 platform，Composer 就真信了，但运行时 gd_info() 不存在，报错会晚到 PHP 执行阶段，调试成本高。
而 --ignore-platform-reqs 是明确告诉 Composer：“别查了，我负责兜底”，它只跳过安装时的静态检查，不篡改任何运行时行为。
- 适用场景：内网构建机、Docker 构建缓存、无外网的生产部署
- 注意：该参数不会跳过
require中的包版本冲突，只影响平台约束（PHP/扩展） - 如果项目用了
config.platform.php且你无法改composer.json，优先用参数而非删配置 —— 否则可能影响其他开发者本地流程
离线时 vendor 已存在，但 composer install 还报 platform 错？
即使 vendor/ 目录完整，composer install 默认仍会重新校验平台兼容性。这不是缓存问题，是设计如此。
- 必须显式加
--ignore-platform-reqs，否则它照常报错 -
composer update离线基本不可行：缺少包元数据，会卡在Loading repositories，别试 - 若想彻底免干扰，可搭配
--no-plugins：某些插件（如hirak/prestissimo）在离线时可能触发额外网络请求或平台检测
PHP 版本不一致但扩展全齐，能只忽略 PHP 版本检查吗？
不能。Composer 没提供细粒度开关，--ignore-platform-reqs 是原子操作，要么全跳，要么全查。
如果你只想绕过 PHP 版本（比如本地开发用 8.2，但目标服务器是 8.1），又不想放弃扩展检查，目前没安全办法 —— 因为扩展可用性本身依赖 PHP 主版本（例如 ext-opcache 在 8.0 和 8.1 行为不同）。硬要拆分，反而增加运行时风险。
真正稳妥的做法，是在离线前就用目标环境的 PHP 版本生成锁文件（composer install --dry-run 验证通过后再 git commit composer.lock），而不是现场妥协检查逻辑。
