在 jenkins pipeline 中直接执行 composer install 常因容器无 composer、path 不对或权限/缓存路径问题失败；官方镜像不预装 composer，推荐用 curl 下载 composer.phar 本地执行，并设置 composer_home 确保缓存可用。
直接在 Jenkins Pipeline 中执行 composer install 是可行的，但默认环境下大概率失败——因为容器里没有 Composer，或者 PATH 里找不到它，又或者权限/网络/缓存路径不对。
为什么 composer install 在 Jenkins 容器里常报 “command not found”
官方 jenkins/jenkins:lts 镜像（包括 JDK17 版）不预装 Composer。它只带 Java、curl、git 等基础工具。你看到的错误通常是：
/bin/sh: composer: not found- 或
ERROR: Command 'composer' not found
这不是 Jenkins 配置问题，是环境缺失。别急着改 Jenkins 全局工具配置——在容器里装更可控、可复现。
推荐做法：在 Pipeline 中用 curl 下载并本地执行 Composer
绕过系统级安装，避免权限冲突和版本漂移。Jenkins 每次构建都用一致的 Composer 二进制。
示例 stage：
stage('Install dependencies') {
steps {
script {
// 下载 Composer 到 workspace，仅限本次构建使用
sh 'curl -sS https://getcomposer.org/installer | php'
// 执行 install，--no-interaction 和 --prefer-dist 是 CI 必选项
sh 'php composer.phar install --no-interaction --prefer-dist --optimize-autoloader'
}
}
}
关键点：
- 不用
sudo或全局composer命令，规避 PATH 和用户权限问题 -
--no-interaction防止卡在交互式提示（如是否生成 autoload） -
--prefer-dist加速下载（用 zip 包而非 git clone） -
--optimize-autoloader提升生产环境加载性能
composer.lock 必须提交，且 Jenkins 要用它而不是 composer.json 单独解析
Jenkins 构建时若没 composer.lock，composer install 会退化为 composer update 行为——这会导致依赖版本漂移，破坏可重现性。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
检查项：
- 确保
composer.lock已提交到 Git 仓库（不在.gitignore里） - 不要在 Pipeline 里写
composer update，除非你明确要升级依赖（且应配--dry-run预检） - 如果项目首次 CI，先在本地运行
composer install生成composer.lock，再推送到远端
常见误操作：composer install --ignore-platform-reqs —— 仅当 PHP 扩展缺失且无法补全时临时用，不应作为常态。
Docker Compose 部署 Jenkins 时，如何让 composer 命令长期可用
如果你用 docker-compose.yml 自定义 Jenkins 容器（比如挂载 /var/jenkins_home），可以在镜像构建阶段预装 Composer：
FROM jenkins/jenkins:lts-jdk17 USER root RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer USER 1000
注意：
- 必须在
USER 1000（Jenkins 默认 UID）之前安装，否则/usr/local/bin写入失败 - 装完后切回
USER 1000，保持安全基线 - 这样所有 Pipeline 就能直接用
composer install，无需每次下载
但要注意：这个方案要求你维护自定义镜像，CI 环境一致性变强，灵活性略降——适合团队统一规范场景。
最易忽略的一点：Composer 的 HOME 目录默认在 $HOME/.composer，而 Jenkins 容器里 $HOME 往往不可写或为空。若遇到缓存写入失败（如 Failed to write cache file），显式设置 COMPOSER_HOME 更可靠：
sh 'COMPOSER_HOME=$WORKSPACE/.composer php composer.phar install ...'
