将依赖声明文件提前复制并利用层缓存，结合本地缓存挂载与优化参数，可显著提升Docker构建效率。1. 先复制composer.json和composer.lock并安装依赖，利用缓存避免重复下载；2. 再复制应用代码，防止代码变更触发依赖重装；3. 使用--no-dev、--optimize-autoloader等参数减少体积并加速安装；4. 通过--mount挂载宿主机缓存目录复用Composer缓存；5. 采用多阶段构建分离安装与运行环境，确保最终镜像精简。核心在于合理分层与缓存复用。
在使用 Docker 构建 PHP 应用时，Composer 安装依赖通常会成为构建瓶颈。如果每次构建都重新下载依赖，不仅耗时还会浪费网络资源。通过合理设计 Dockerfile 并利用层缓存机制，可以显著提升构建效率。关键在于将依赖声明文件（如 composer.json 和 composer.lock）提前复制并单独执行安装，从而实现缓存复用。
分离依赖声明与安装步骤
Docker 镜像构建采用分层缓存机制，只有当某一层的内容发生变化时，其后的所有层才会重新构建。因此，应将 Composer 依赖的声明文件先于应用代码复制到镜像中，避免因代码变更导致依赖重装。
示例如下：
# 先复制依赖描述文件
COPY composer.json composer.lock ./
# 安装依赖（此层会被缓存）
RUN composer install --no-dev --optimize-autoloader --no-scripts --no-progress --no-suggest
# 再复制应用代码
COPY . .
# 执行需脚本的安装步骤（如生成类映射）
RUN composer run-script post-install-cmd
使用本地 Composer 缓存目录
Composer 在运行时会下载包到全局缓存目录（默认 ~/.composer/cache），若每次构建都从零开始，即使依赖未变也会重复下载。可通过挂载缓存卷或在多阶段构建中复用缓存来加速。
在 CI/CD 环境中，可将宿主机的 Composer 缓存目录挂载到构建容器中：
docker build \\
--mount type=cache,source=composer-cache,target=/tmp/cache/composer \\
--build-arg COMPOSER_CACHE_DIR=/tmp/cache/composer \\
-t my-app .
同时在 Dockerfile 中设置环境变量：
ARG COMPOSER_CACHE_DIR
ENV COMPOSER_CACHE_DIR=${COMPOSER_CACHE_DIR:-/tmp/cache/composer}
优化 Composer 安装参数
减少不必要的操作能加快安装速度并降低镜像体积。建议使用以下参数：
- --no-dev：生产环境无需开发依赖
- --optimize-autoloader：生成优化的类加载器，提升运行性能
- --classmap-authoritative：进一步优化自动加载（可选）
- --no-scripts：延迟脚本执行，避免在缓存层触发如清除缓存等操作
- --no-progress --no-suggest：减少输出干扰，加快构建日志处理
结合多阶段构建清理缓存
某些包在安装过程中会保留测试文件或文档，可在多阶段构建中复制最终代码并剔除无关内容。
例如：
FROM php:8.2-cli as installer
WORKDIR /app
COPY composer.json composer.lock .
RUN composer install --no-dev --optimize-autoloader ...
FROM php:8.2-cli
COPY --from=installer /app/vendor /app/vendor
COPY . /app
这样既能利用缓存快速构建，又能确保最终镜像干净。
基本上就这些。核心是把不变或少变的依赖声明提前，配合缓存挂载和参数优化，就能大幅提升 Docker 构建速度。不复杂但容易忽略细节。
