真离线容器中composer install必失败，因默认强制联网校验元数据；正确做法是多阶段构建预装vendor并设COMPOSER_DISABLE_NETWORK=1，禁用--no-scripts等参数，且严格对齐PHP版本、扩展与OS环境。
容器里跑不了 composer install，根本不是命令没装，而是环境没对齐、网络被掐死、或权限卡在 vendor 目录上——真离线场景下，composer install 本就不该在运行时执行。
容器内执行 composer install 为什么总失败
多数人以为是没装 Composer，其实官方 PHP 镜像（比如 php:8.2-cli）压根不带它；但更深层的问题是：即使装了，composer install 在容器启动时执行，会撞上三类硬限制：
- 网络不可达：
composer diagnose显示Checking HTTP connectivity: FAIL，说明 DNS、代理、防火墙全拦住了，不是换源能解决的 - PHP 环境错配：宿主机生成的
vendor/被挂载进容器，但宿主机 PHP 是 8.1，容器是 8.2，autoload.php里某些扩展 ABI 不兼容，类加载直接静默失败 - UID/GID 权限断裂：macOS 或 Windows 上
chown -R 1001:1001 vendor没用，因为挂载后文件属主变成root，PHP 进程（如 www-data UID=82）读不了，报Class not found却不提示权限问题
多阶段构建里 composer install 的关键参数
第一阶段（builder）必须严格控制行为，否则打包进去的 vendor 就是“带病上岗”：
- 加
--no-scripts：跳过post-install-cmd，避免某些包（如 Laravel Mix）自动触发npm install或远程 fetch 前端资源 - 加
--no-dev --optimize-autoloader --classmap-authoritative：生产镜像不该含测试依赖，且类加载必须走优化路径，否则运行时扫描慢、还可能漏类 - 不加
--ignore-platform-reqs：它会绕过php、ext-zip等平台约束，导致镜像在目标环境跑不起来 -
composer.lock必须和构建环境完全一致：PHP 版本、config.platform.php、OS 架构都得对齐，否则install会重算依赖树，触发网络请求
镜像内配置 composer 二进制的坑点
别用 apt install composer，Ubuntu 源里的版本常是 2.2.x，而项目 composer.json 可能要求 >=2.5；正确做法是用官方安装器：
- 用
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 确认
/usr/local/bin在PATH里：检查Dockerfile是否有ENV PATH="/usr/local/bin:$PATH" - 验证是否生效：加一条
RUN /usr/local/bin/composer --version，别只信creates参数 - 国内环境务必在构建阶段写入镜像源：
RUN composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
CI/CD 中自动检测 composer 状态的实操边界
脚本里调 composer self-update 或 composer validate 不是“加个命令就行”，得守住三条线：
-
composer validate必须在working_dir下执行，且该目录对运行用户可读——Ansible 里要用community.general.composer模块，别用 shell 模块，否则 PATH 和权限容易掉链子 -
composer self-update在容器里大概率失败：非 root 用户无法覆盖/usr/local/bin/composer，应改用--local模式，或直接跳过，靠基础镜像更新来同步 - 自动检测脚本别硬编码
composer --version解析逻辑：v2.5+ 输出含preview后缀，得用composer --version --no-ansi | cut -d' ' -f3 | cut -d'+' -f1提取主版本号
最易被忽略的是 config.platform.php 和实际 PHP 版本的耦合关系：它不光影响依赖解析，还决定 vendor/autoload.php 生成的语法兼容性。容器里 PHP 是 8.2，但 composer.json 写了 "config": {"platform": {"php": "8.0"}}，那生成的 autoload 文件就可能用 ??= 这种 8.1+ 才支持的语法，运行时报 parse error。
