推荐在 Docker 构建早期 COPY composer.json 和 composer.lock 后立即运行 composer install --no-dev --optimize-autoloader，以利用层缓存；生产镜像宜用多阶段构建分离依赖，开发环境可通过卷挂载复用宿主机 vendor，并注意扩展缺失导致的静默失败。
在 Docker 容器中直接运行 composer install 是可行的，但不推荐作为常规开发或生产流程 —— 容器层缓存失效、重复下载、镜像体积膨胀和依赖锁定不一致是高频问题。
为什么不能每次构建都跑 composer install？
因为 Docker build 的每一层都是只读快照，而 composer install 会把 vendor/ 目录写入当前层。一旦 composer.json 或 composer.lock 有微小变更（比如换行符、注释），Docker 就无法复用之前的缓存层，导致从 composer install 开始全部重新执行，耗时飙升且浪费带宽。
- PHP 镜像里没预装 Composer？
apt-get install -y curl && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 用
ADD或COPY复制composer.lock后再RUN composer install --no-dev --optimize-autoloader，才能让缓存生效 - 若
composer.lock不存在，composer install会降级为composer update，结果不可控
如何让 vendor/ 缓存真正生效？
关键不是“跳过安装”，而是“把依赖安装过程拆进构建早期、并让它尽可能稳定”。最可靠的做法是：先复制 composer.json 和 composer.lock，立即运行安装，再复制应用代码。
FROM php:8.2-cli WORKDIR /app COPY composer.json composer.lock ./ RUN composer install --no-dev --optimize-autoloader --no-progress COPY . . CMD ["php", "index.php"]
- 必须同时
COPYcomposer.json和composer.lock，否则composer install会报错或忽略 lock 文件 -
--no-progress减少日志干扰，避免某些 CI 环境因 ANSI 控制字符失败 - 不要用
composer create-project替代install，它会触发额外的初始化逻辑，破坏缓存边界
开发环境需要热重载，还能用缓存吗？
能，但得换思路：把 vendor/ 挂载为命名卷或绑定挂载，让容器启动时复用宿主机已安装的依赖，而不是每次重建镜像。
- 本地开发时，在
docker-compose.yml中加：volumes: - ./src:/app/src - vendor:/app/vendor
- 确保宿主机已运行过
composer install（例如在php:8.2-cli容器外用docker run --rm -v $(pwd):/app -w /app php:8.2-cli composer install） - 禁用
composer install的自动脚本（如post-install-cmd），避免挂载后重复执行 —— 加--no-scripts
多阶段构建是否必要？
对生产镜像有必要；对调试或 CI 中间产物没必要。多阶段的核心价值是分离构建依赖（如 git、unzip）和运行时依赖，最终镜像里不残留 Composer 二进制或 dev-only 包。
FROM php:8.2-cli AS builder WORKDIR /app COPY composer.json composer.lock ./ RUN composer install --no-dev --no-scripts --optimize-autoloader <p>FROM php:8.2-apache COPY --from=builder /app/vendor /var/www/html/vendor COPY . /var/www/html/
- 注意路径一致性：
--from=builder复制的是构建阶段的绝对路径，不是工作目录相对路径 - 如果项目用了
composer bin（如phpstan），它们默认装在vendor/bin/，需一并复制或改用全局安装 - Apache 镜像默认 DocumentRoot 是
/var/www/html，别漏掉COPY入口文件（如index.php）
最常被忽略的一点：Composer 的 platform 配置（比如 "ext-zip": "0"）在容器内可能不成立 —— 如果镜像没装对应扩展，composer install 会静默跳过该包，但不会报错，直到运行时报 Class not found。
