多阶段 Docker 构建中优化 Composer 缓存的核心是精准分层与按需复制：先单独 COPY composer.json 和 composer.lock，紧随其后执行 composer install --no-dev --optimize-autoloader；构建阶段使用 builder 镜像安装依赖并清理冗余文件，最终镜像仅复制 vendor 和应用代码。
在多阶段 Docker 构建中优化 Composer 缓存层，核心是让依赖安装步骤尽可能复用缓存，同时避免把 dev 依赖、源码、临时文件等带入最终镜像。关键不在于“清缓存”，而在于“精准分层”和“按需复制”。
将 vendor 和 composer.lock 锁定在构建阶段独立层
Composer 安装（composer install --no-dev --optimize-autoloader）必须紧随 COPY composer.json composer.lock . 之后，且中间不能插入其他指令。任何额外的 COPY 或 RUN 都会破坏缓存链。
- 确保
composer.json和composer.lock先单独 COPY，再运行 install - 不要在 COPY 之前做 chmod、chown 或 mkdir 等操作（除非必要且稳定）
- 使用
--no-dev和--optimize-autoloader减少体积并提升运行时性能
用多阶段构建剥离构建依赖和临时文件
把 Composer 本身、PHP 扩展编译环境、Git、zip 等只在构建时需要的工具，全部放在 builder 阶段；最终镜像只保留运行时 PHP + vendor + 应用代码。
- builder 阶段用
php:8.2-cli或带扩展的镜像（如php:8.2-cli-bullseye） - 安装完依赖后，用
COPY --from=builder /app/vendor /var/www/html/vendor精确复制，不复制整个工作目录 - 避免在 builder 阶段写入
/tmp、/root/.composer等路径——它们不会被复制，但可能污染缓存层
启用 Composer 的可重现构建与缓存友好配置
在构建前注入环境变量或配置，让 Composer 行为更稳定，减少因隐式变化导致的缓存失效。
- 设置
COMPOSER_CACHE_DIR=/dev/null（禁用内部缓存，依赖全靠 Docker 层缓存） - 或固定使用
--no-scripts --no-plugins，避免钩子执行引入不确定性 - 确保
composer.lock始终提交，并在 CI/CD 中运行composer update --lock后提交，避免本地 lock 差异
检查并精简 vendor 中的冗余内容
即使用了 --no-dev，部分包仍自带测试、文档、bin 脚本等。可在 builder 阶段主动清理。
- 安装后运行：
RUN find vendor/ -name '.git' -prune -exec rm -rf {} + 2>/dev/null || true - 删除测试和文档目录：
RUN find vendor/ -name 'tests' -o -name 'Tests' -o -name 'docs' -o -name 'documentation' | xargs rm -rf 2>/dev/null || true - 慎用
composer install --apcu-autoloader（需运行时支持），它能减小 autoloader 文件体积
