OpenShift 不提供 Composer 运行时环境，必须在构建阶段（BuildConfig/DockerStrategy）执行 composer install；禁止在 Pod 启动时运行，否则会导致网络失败、扩展缺失、权限错误、autoload 缓存写入失败及版本不一致。
OpenShift 容器平台本身不提供 Composer 运行时环境，也不支持在集群层面“集成 Composer 驱动”——Composer 是 PHP 应用的依赖管理工具，必须嵌入到应用构建流程中，而非平台级插件或驱动。你在 OpenShift 上真正需要做的，是让 PHP 应用镜像在构建阶段正确安装 vendor 依赖，且与运行时环境严格一致。
为什么不能在 OpenShift Pod 启动时执行 composer install
OpenShift 的构建（BuildConfig / ImageStream）和部署（DeploymentConfig / Deployment）是分离的。如果把 composer install 放在容器启动命令（如 entrypoint.sh）里：
- 每次 Pod 重启都触发网络拉包，极易因超时、证书错误（
SSL certificate problem）或国内源不可达失败 - Pod 使用的 runtime 镜像通常不带
unzip、git或完整 PHP 扩展（如ext-zip），直接报Could not fetch或Package manifest could not be loaded -
composer.lock是在开发者本地 PHP 8.2 环境生成的，而 OpenShift 中的php:8.1-fpm镜像可能装入不兼容语法的包（例如含readonly属性的类），导致运行时报ParseError - 挂载的
vendor/目录属主为root，但 OpenShift 默认以非 root 用户（如 UID 1001）运行容器，写 autoload cache 失败，出现Failed to write cache file
如何在 OpenShift BuildConfig 中安全运行 composer install
OpenShift 的 Source-to-Image（S2I）或自定义 DockerStrategy 构建，才是 Composer 的唯一合法执行位置。关键不是“怎么调用”，而是环境是否可控：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须使用
dockerStrategy（而非s2iStrategy），因为 S2I 的 PHP builder 镜像已过时，不支持 Composer v2 lock 文件格式 -
Dockerfile中安装 Composer 必须校验签名：RUN curl -sS https://getcomposer.org/installer -o composer-setup.php && curl -sS https://getcomposer.org/installer.sig -o composer-setup.php.sig && sha384sum -c composer-setup.php.sig && php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 构建前设国内镜像源：
RUN COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ -
COPY顺序必须是：先COPY composer.lock .，再COPY composer.json .，最后RUN composer install --no-dev --optimize-autoloader --classmap-authoritative；否则会退化成update，破坏可重现性 - 务必在
composer.json中显式锁定平台版本："config": {"platform": {"php": "8.2.15"}}，避免 Composer 根据构建镜像推测能力而装入高版本依赖
oc new-build 构建时常见权限与缓存问题
OpenShift 构建容器默认以随机 UID 运行，这会导致 Composer 缓存写入失败或 vendor 目录权限混乱：
- 构建日志出现
Permission denied写~/.composer/cache？这是正常现象——不要试图挂载宿主机缓存，OpenShift 构建是隔离的，应依赖层缓存而非本地 cache - 若你用
oc new-build --strategy=docker并引用私有 Git 仓库，确保.dockercfg或imagePullSecrets已配置，否则composer install卡在私有包拉取 - Alpine 基础镜像需提前安装证书：
RUN apk add --no-cache ca-certificates，否则报SSL certificate problem: unable to get local issuer certificate - 别在构建后保留
/usr/local/bin/composer—— 构建完成即删，运行镜像只需vendor/和应用代码，精简攻击面
最易被忽略的一点：OpenShift 的 BuildConfig 不会自动继承开发机的 config.platform.php 设置，哪怕你本地 composer.json 写了 platform，也必须确保该文件被完整 COPY 进构建上下文——漏掉它，就等于没锁版本。
