生产环境需加--no-dev --prefer-dist --optimize-autoloader --classmap-authoritative四参数,否则缓存未固化:Docker/K8s/Serverless中~/.composer/cache/files/为空、vendor/重建、post-install-cmd静默失败,导致autoload未优化、config未缓存、路由未预编译,性能损失超40%。

为什么composer install在生产环境总要重跑一遍
根本不是网络慢或机器差,而是缓存压根没“固化”进运行时环境。Docker 镜像启动、K8s Pod 新建、Serverless 冷启——这些场景下,~/.composer/cache/files/ 是空的,vendor/ 是重建的,连 post-install-cmd 脚本都因缺环境变量静默失败。你看到的“安装完成”,实际只是 ZIP 解压完,autoload 没优化、config 没缓存、路由没预编译。
composer install 必须加的四个参数
少一个,缓存就白配,性能损失至少 40%:
-
--no-dev:跳过所有开发依赖(如phpunit、larastan),减少 vendor 大小和 autoload 扫描路径 -
--prefer-dist:强制走 ZIP 包下载,绕过 git clone + checkout,避免 vcs/ 缓存失效陷阱 -
--optimize-autoloader:生成扁平化类映射数组,Laravel 服务提供者加载快 30%+ -
--classmap-authoritative:告诉 autoloader “只信 classmap,别扫 PSR-4”,彻底杜绝文件系统调用
注意:--no-scripts 要在构建阶段加(防失败),但不能在最终镜像里留着——得靠 entrypoint 或 warmup 脚本补上 php artisan config:cache 等关键步骤。
缓存目录必须可写且路径绝对
很多人设了 cache-dir 却没提速,是因为 Composer 静默 fallback 到 /tmp/composer。验证三步:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行
composer config -g cache-dir,输出必须是类似/home/app/.composer/cache的绝对路径 - 执行
ls -ld $(composer config -g cache-dir),确保属主有读写权限 - 进到该目录,检查
files/下是否有 ZIP 文件(如monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip)
在 Docker 构建中,如果没挂载或没 chown,files/ 就是空的——CI 日志不会报错,但每次都是裸装。
Docker 多阶段构建中 vendor 和缓存怎么一起 baked in
别让 final 镜像自己跑 composer install。标准做法是:
- builder 阶段 COPY
composer.json和composer.lock,然后composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-scripts - COPY
vendor/、bootstrap/cache/(含config.php、routes-v7.php)、以及整个~/.composer/cache/files/到 final 镜像 - final 镜像的 entrypoint 先检查
bootstrap/cache/config.php修改时间是否早于构建时间;如果不是,说明缓存被 runtime 覆盖,需重新生成
最易忽略的一点:bootstrap/cache/ 下文件的 mtime 必须早于镜像构建时间。否则 Laravel 启动时会自动触发重生成,把 baked-in 缓存全废掉。

















