离线环境执行composer install必须提前在相同PHP环境预装vendor并禁用网络，否则因强制校验远程元数据必然失败；真离线需确认composer diagnose中HTTP connectivity为FAIL，且须严格对齐PHP版本、扩展、OS及lock文件生成上下文。
离线环境里根本装不上 composer install？先确认是不是真离线
很多所谓“离线”其实是内网有代理或镜像源，但没配对。运行 composer diagnose 看输出里 Checking composer.json 和 Checking HTTP connectivity 两行——如果后者显示 FAIL 或超时，才是真离线；如果只是 Warning: The xdebug extension is loaded 这类，问题不在网络。
真离线场景常见于金融、政务等强隔离网络，或 CI 构建节点禁止外连。此时不能依赖 curl https://getcomposer.org/installer 或 composer install 自动拉包，必须把所有依赖提前“打包带进去”。
Dockerfile 多阶段构建：把 vendor 打进镜像，不碰网络
这是最稳妥的离线方案：所有依赖在有网环境预装，只把 vendor/ 目录复制进最终镜像。关键点不是“怎么装”，而是“在哪装、装完怎么用”。
- 第一阶段用带网络的 builder 镜像（比如
php:8.2-cli），COPY composer.json composer.lock ./后直接composer install --no-dev --no-scripts --optimize-autoloader - 第二阶段用精简运行镜像（如
php:8.2-fpm-alpine），COPY --from=builder /app/vendor /var/www/html/vendor - 务必加
--no-scripts：避免执行post-install-cmd时触发网络请求（比如某些包会自动 fetch 前端资源） - 不要
COPY . .再跑composer install—— 这等于把网络依赖又拖回离线环境
宿主机离线打包 vendor，再挂载进容器？小心权限和 autoload 失效
如果构建流程不允许多阶段（比如旧版 CI 工具不支持 --from），就得在宿主机预先生成 vendor/，然后挂载进容器。但这步极易出错：
- 宿主机是 macOS/Windows，容器是 Linux：UID/GID 不匹配 →
vendor/文件属主变成root，PHP 进程读不了 → 报Class not found - 宿主机 PHP 版本和容器不一致：比如宿主机 PHP 8.1 生成的
vendor/autoload.php，在容器 PHP 8.2 下可能因扩展 ABI 变更失效 - 没运行
composer dump-autoload --optimize --classmap-authoritative→ 容器里文件系统缓存导致类路径没刷新 - 解决方案：在与目标容器完全一致的 PHP 环境中（同版本、同扩展、同 OS）执行打包；挂载时用
chown -R 82:82 vendor（假设容器内 www-data UID=82）
离线部署时 composer.lock 的校验和锁定逻辑不能跳过
composer install 在离线模式下仍会校验 composer.lock 里的 hash，哪怕所有包都本地有了。如果 lock 文件被手动改过、或生成环境 PHP 版本和当前不一致，就会报 Your lock file does not contain a compatible set of packages。
实操要点：
- 确保构建时用的 PHP 版本和目标容器完全一致，否则
config.platform.php设置无效 - 不要用
composer update生成 lock 文件——它需要网络校验远程包信息；必须用composer install --dry-run在目标环境预检通过后，再正式打包 - CI 流水线里加一步：
composer validate --no-check-publish，提前发现 lock 文件和当前环境的兼容性问题
离线部署真正的复杂点不在“怎么装”，而在于环境链路的严格对齐：PHP 版本、扩展 ABI、OS 用户模型、lock 文件生成上下文，漏掉任一环，容器起来就报 autoload 错误，且很难定位。
