Jenkins中Composer需显式指定绝对路径调用、必须提交composer.lock文件、composer install应放在phpunit前并加--no-dev参数。
Composer 在 Jenkins 中不是“装了就能用”，关键在于路径、权限和锁文件三者是否对齐——多数构建失败，其实卡在 composer 命令根本没调到你期望的版本，或者 composer.lock 被忽略导致环境不一致。
如何让 Jenkins 找到并执行正确的 composer 二进制
Jenkins 默认用系统 PATH 查找 composer，但你本地开发用的是 COMPOSER_HOME/bin/composer（比如通过 curl -sS https://getcomposer.org/installer | php -- --install-dir=/opt/composer/bin 安装），Jenkins 用户（通常是 jenkins 或 UID 1000）很可能没读取你的 shell profile，也压根不知道 COMPOSER_HOME 是啥。
- 最稳的做法：在 Jenkins Pipeline 的
shell步骤里，**显式调用绝对路径**，例如/opt/composer/bin/composer install，而不是裸写composer install - 若想全局生效，可在 Jenkins 全局工具配置中添加 Composer：进入
Manage Jenkins → Global Tool Configuration → Add Composer，指定安装路径（如/opt/composer/bin/composer），然后在 Pipeline 中用tool 'my-composer'引用 - 别依赖
source ~/.bashrc或export COMPOSER_HOME=...—— Jenkins agent 启动时通常是非交互式 shell，不会加载这些配置
为什么必须 commit composer.lock？光有 composer.json 不够
CI 环境里跑 composer install 却没 composer.lock，等于让 Composer 自己“猜”该装哪个版本——它会按 composer.json 的约束拉最新兼容版，结果可能跟本地开发或上一次部署完全不一样，轻则测试通过线上报错，重则引入 BC break。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.lock是确定性交付的契约：它锁定每个包的 exact version + hash + source URL - Jenkins 构建前务必确认该文件已提交到 Git；若项目首次 CI 或 lock 文件缺失，先在本地运行
composer lock（不是composer update）生成，再推送到仓库 - Pipeline 中不要用
composer update—— 它会改写composer.lock，而 Jenkins 一般没权限 push 回 Git，强行运行只会导致下次构建又回到“猜版本”状态
PHP 项目 CI 流程里，composer install 放哪一步最安全
顺序错了，轻则浪费时间，重则因扩展缺失直接中断构建。典型错误是把 composer install 放在 phpunit 之后，或者没清理 vendor 就复用缓存。
- 推荐阶段顺序：
checkout→composer install --no-dev --optimize-autoloader（生产环境构建用）→vendor/bin/phpunit（开发环境 CI 可加--dev） - 务必加
--no-dev：避免把phpunit、phpdocumentor这类 dev-only 包装进生产镜像，减小体积、规避安全扫描误报 - 如果用了 Jenkins Workspace 缓存，注意
composer install前加rm -rf vendor composer.lock或启用cleanWs()，否则旧 lock 文件残留会导致依赖解析错乱
真正难的不是写对那几行 Pipeline 代码，而是确保 Jenkins agent 的用户能读 COMPOSER_HOME、Git 拉下来的代码带对的 composer.lock、以及每次 composer install 都跑在干净且可重现的上下文里——这三个点只要漏一个，CI 就从“自动化”退化成“手动排查定时任务”。
