离线环境下composer install仍报platform错误，因其默认校验本地PHP版本及扩展是否满足composer.json或composer.lock中的platform约束；应优先使用--ignore-platform-req=php仅跳过PHP版本检查，保留扩展校验，避免运行时崩溃。
离线环境下 composer install 为什么还会报 platform 错误
因为 composer install 默认仍会校验 PHP 版本、扩展是否存在等平台要求，哪怕所有包都已下载好、网络完全断开。它不依赖网络做版本解析，但依赖本地 PHP 环境是否满足 composer.json 或 composer.lock 中声明的 platform 约束。
离线安装时该用 --ignore-platform-req=php 还是 --ignore-platform-reqs
优先用 --ignore-platform-req=php：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 只跳过 PHP 版本检查（如
"php": "^7.4"），保留对ext-mbstring、ext-zip等扩展的校验，避免运行时报 Class not found -
--ignore-platform-reqs（带复数 s）会一并跳过所有扩展检查，离线环境里更难排查缺失扩展导致的后续崩溃 - 命令必须带等号：
--ignore-platform-req=php，写成--ignore-platform-req php（无等号）等价于--ignore-platform-reqs，容易踩坑
离线安装前必须确认的三件事
忽略平台要求只是绕过校验，不是魔法。以下条件缺一不可：
-
composer.lock文件必须存在且完整——离线安装依赖它锁定的 exact 版本，没有 lock 文件，composer install直接失败 - 所有
vendor/包必须已通过在线环境composer install --no-dev下载并打包好，且路径结构未被破坏 - 目标离线机器的 PHP 版本至少能跑通项目核心语法（比如 PHP 8.0 代码不能扔进 PHP 7.2 运行），
--ignore-platform-req=php不解决运行时 fatal error
CI/CD 或 Docker 构建中离线安装的典型错误
常见报错如 Your lock file does not contain a compatible set of packages 或 Root composer.json requires php ^8.2...，本质是两层问题混在一起：
- 前者是 lock 文件与当前
composer.json的 require 声明冲突，和平台无关，--ignore-platform-req=php完全无效，必须删 lock 后重装（但离线环境做不到） - 后者才是平台问题，可安全用
--ignore-platform-req=php - 真正容易被忽略的是：某些包的
bin/可执行文件（如vendor/bin/phpunit）内部自带 PHP 版本检查，即使安装成功，运行时仍可能因#!/usr/bin/env php解析出的版本不匹配而退出——这和 Composer 安装阶段的 ignore 参数无关
