合理配置Composer可提升Docker缓存利用率，关键在于先复制composer.json和composer.lock再安装依赖，确保仅声明文件变更时才重新安装；通过--mount=type=cache挂载全局缓存加速解压读取；提交composer.lock并使用--prefer-dist提高下载效率；多阶段构建中清除缓存并仅复制vendor目录至最终镜像，减小体积。
在多阶段 Docker 构建中，合理配置 Composer 可以显著提升依赖安装阶段的缓存利用率，避免每次构建都重新下载依赖。关键在于分离依赖声明文件与实际安装过程，使 Composer 缓存仅在 composer.json 或 composer.lock 发生变化时才失效。
确保只在必要时重新安装依赖
Composer 的依赖安装是耗时操作，Docker 构建缓存应尽可能复用已安装的 vendor 目录。为此，先复制声明文件，再运行安装命令：
COPY composer.json composer.lock ./RUN composer install --no-dev --no-scripts --no-progress --prefer-dist
这样只有当 composer.json 或 composer.lock 文件变更时，后续层才会重新执行 composer install，其他代码变更不会影响该层缓存。
使用本地卷缓存 Composer 全局缓存
Composer 会将包缓存在全局目录（如 ~/.composer/cache），可在 Docker 构建时挂载临时卷来复用这些缓存：
Docker BuildKit 支持 --mount=type=cache，自动管理缓存目录生命周期。这能加速包解压和文件读取，尤其在频繁构建时效果明显。
锁定依赖版本并启用 --prefer-dist
始终提交 composer.lock 文件，确保依赖版本一致，并配合 --prefer-dist 优先使用压缩包而非源码克隆：
- 减少网络请求和 Git 克隆开销
- 加快包下载和解压速度
- 提升构建可重复性
清理不必要的文件以减小镜像体积
在生产构建中移除开发依赖和缓存文件：
RUN composer install --no-dev --no-scripts --no-progress --prefer-dist \&& composer clear-cache
也可在多阶段构建中仅复制 vendor 目录到最终镜像，避免携带 Composer 二进制和配置：
COPY composer.json composer.lock /app/
WORKDIR /app
RUN composer install --no-dev --prefer-dist --no-scripts --no-progress \
&& composer clear-cache
FROM php:8.1-cli
COPY --from=builder /app/vendor /app/vendor
基本上就这些。通过分步复制、缓存挂载和多阶段裁剪，能让 Composer 在 Docker 构建中实现最优缓存效果。不复杂但容易忽略细节。
