不能直接用 composer install 把依赖“打入”镜像，因为它只是安装依赖而不构建镜像；真正打入镜像靠 docker 构建时的 copy 和 run 指令配合，需先复制 composer.json 和 composer.lock 再执行 composer install，最后复制源码以利用缓存。
不能直接用 composer install 把依赖“打入”镜像——它只是安装依赖，不构建镜像；真正打入镜像靠的是 Docker 构建过程中的 COPY 和 RUN 指令配合使用。
为什么 composer install 本身不生成镜像
composer install 是一个 PHP 包管理命令，运行在宿主机或容器内，只负责解析 composer.lock、下载包、写入 vendor/。它不感知 Docker，也不操作镜像层。所谓“打入镜像”，本质是让这些文件出现在 Docker build 的某一层里。
Dockerfile 中正确执行 composer install 的关键顺序
核心原则：先复制 composer.json 和 composer.lock，再运行 composer install，最后才复制其余源码。否则每次改代码都会失效缓存、重装全部依赖。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
COPY composer.json composer.lock ./—— 必须显式指定目标为当前目录（./），否则可能因路径问题导致找不到 lock 文件 -
RUN composer install --no-dev --no-interaction --optimize-autoloader——--no-dev避免开发依赖混入生产镜像；--optimize-autoloader提升加载性能 -
COPY . .放在composer install之后，确保vendor/不被覆盖
多阶段构建中如何安全复用 vendor 目录
如果项目含编译步骤（如 Laravel Mix），或想彻底隔离构建环境，推荐多阶段构建。常见错误是直接 COPY --from=builder /app/vendor /app/vendor 却没注意权限或 autoloader 路径。
- 构建阶段应使用与运行阶段一致的 PHP 版本和扩展（尤其是
mbstring、xml、zip），否则composer install可能静默失败或 autoload 失效 - 运行阶段 COPY vendor 后，建议加
RUN chown -R www-data:www-data /app/vendor（若以非 root 用户运行） - 避免在运行阶段再次执行
composer install—— 这会覆盖已优化的 autoloader，且无必要
CI/CD 环境下 vendor 缓存失效的典型原因
GitHub Actions 或 GitLab CI 中常出现 “vendor 目录为空” 或 “Class not found”，多数不是命令写错，而是缓存策略或路径错位。
-
composer install前未确认工作目录：Docker 构建上下文默认是.，但 CI 脚本若cd到子目录再docker build，可能导致composer.json未被 COPY - 缓存 key 未包含
composer.lock的 hash（例如cache-key: ${{ hashFiles('**/composer.lock') }}），导致旧缓存被复用，而 lock 已更新 - 使用了
composer install --ignore-platform-reqs：临时绕过扩展检查虽快，但上线后可能因缺少扩展直接报 500
最易被忽略的一点：Docker 构建时若未挂载 ~/.composer/cache，每次都会重新下载 zip 包，拖慢构建；但这个缓存对最终镜像体积无影响，只是加速构建——别把它和 vendor/ 混为一谈。
