通过配置Composer缓存机制可显著提升Docker构建效率。1. 开发或CI中挂载宿主机缓存目录，避免重复下载；2. 构建时先复制composer.json和lock文件，利用Docker层缓存，结合--mount=type=cache复用包；3. 显式设置COMPOSER_CACHE_DIR并确保权限正确；4. 生产环境使用--no-dev和composer clear-cache减小镜像体积。核心是利用Docker缓存机制，使依赖安装在文件不变时完全复用。

在 Docker 容器中使用 Composer 时，频繁下载依赖会显著拖慢构建速度。通过合理配置缓存机制，可以大幅提升构建效率。关键是将 Composer 的缓存目录和项目依赖分离，并利用 Docker 的分层缓存特性。

1. 挂载 Composer 缓存目录

在本地开发或 CI 环境中，可以通过挂载宿主机的 Composer 缓存目录，避免重复下载包。

• -v ${COMPOSER_HOME:-$HOME/.composer}:/tmp/composer-cache:delegated 将本地缓存映射到容器内
• 设置环境变量 COMPOSER_CACHE_DIR=/tmp/composer-cache 让 Composer 使用该路径

这样多次运行容器时，已下载的包会直接从缓存读取，大幅减少网络请求。

2. 构建镜像时优化 layer 缓存

Docker 构建时，只有当 COPY 或 ADD 的文件变化时，后续层才会重新构建。利用这一点，先复制 composer.json 和 lock 文件，再安装依赖。

COPY composer.json composer.lock /app/
WORKDIR /app
RUN --mount=type=cache,target=/root/.composer \
    COMPOSER_CACHE_DIR=/root/.composer \
    composer install --no-dev --optimize-autoloader

使用 --mount=type=cache 声明缓存目录，Docker BuildKit 会自动管理该路径，跨构建复用已下载的包。

3. 合理设置缓存位置和权限

默认情况下，Composer 缓存位于 ~/.composer/cache。在容器中建议显式指定路径，避免权限问题。

• 设置 COMPOSER_CACHE_DIR=/tmp/composer-cache 或 /var/cache/composer
• 确保运行用户有读写权限，特别是在多阶段构建或非 root 用户场景下
• CI 环境中可结合 cache key（如 composer.lock 的 hash）提高命中率

4. 生产环境只安装必要依赖

构建生产镜像时，使用 --no-dev 跳过开发依赖，并清除缓存体积：

RUN composer install --no-dev --optimize-autoloader --quiet && \
    composer clear-cache

clear-cache 不影响功能，但能减小最终镜像体积，尤其在未使用外部缓存 mount 时有用。

基本上就这些。核心是利用 Docker 的 cache mount 机制和文件变更触发逻辑，让依赖安装尽可能命中缓存。只要 composer.json 和 lock 不变，install 步骤就能完全复用。不复杂但容易忽略。