不能在docker-compose.yml的command里运行composer install，因为command在容器启动时执行，每次docker-compose up都会重复拉取、解包、安装依赖，浪费时间且破坏镜像分层缓存；网络抖动、composer.lock未提交或缓存未清会导致装错版本、class not found或兼容性错误。
为什么不能在 docker-compose.yml 的 command 里跑 composer install
因为 command 是容器启动时才执行，每次 docker-compose up 都会重新拉取、解包、安装依赖，既浪费时间又破坏镜像分层缓存。更严重的是：网络抖动会导致安装中断；composer.lock 本地被改但未提交，容器会装错版本；甚至因缓存未清而复用过期包，引发运行时 Class not found 或版本不兼容错误。
Dockerfile 中预装依赖的正确分层顺序
关键不是“能不能装”，而是“在哪一层装、和什么一起装”。必须把依赖声明和安装拆成独立、靠前的层：
-
COPY composer.json composer.lock ./必须单独成行，且放在所有其他COPY之前 - 紧随其后是
RUN composer install --no-dev --optimize-autoloader --no-scripts，中间不能插入任何其他指令（比如RUN chmod或COPY .env） - 最后才是
COPY . .—— 否则代码变更会让前面所有层缓存失效 - 如果用了多阶段构建，
COPY --from=builder /app/vendor ./vendor要明确路径，避免复制整个/app导致覆盖或权限混乱
Alpine 镜像下 composer install 失败的常见原因
不是 Composer 本身有问题，而是 Alpine 默认缺扩展。典型报错包括：failed to open stream: No such file or directory（实际是缺 zip 扩展）、cannot load the ionCube Loader（其实是 openssl 未启用）。解决方式不是加 --ignore-platform-reqs，而是补全基础能力：
- 先
RUN apk add --no-cache zip unzip openssl - 再
RUN docker-php-ext-install zip openssl（注意顺序，apk add必须在docker-php-ext-install之前） - 别用
apk add php-zip—— Alpine 没这个包名，php8-zip或php7-zip才对，写错就静默失败 - 验证是否生效：
php -m | grep -E "zip|openssl"
如何防止本地 volume 覆盖掉预装好的 vendor
开发时常用 volumes: ["./:/var/www/html"]，但宿主机空的 vendor/ 会直接覆盖镜像里已装好的依赖，导致 composer install 白做。这不是配置错误，而是挂载逻辑冲突：
- 最简方案：用子路径挂载，比如
./src:/var/www/html/src:ro，避开vendor/ - 更稳妥的做法：在
docker-compose.yml中显式声明只读空目录映射：vendor:/var/www/html/vendor:ro - 若必须整目录挂载，提前在宿主机运行
mkdir -p vendor && chown -R 1001:1001 vendor（假设容器用户 UID 是 1001） - CI 构建环境应禁用 volume，只在本地开发叠加
docker-compose.override.yml
RUN、一个提前的 COPY、甚至 composer.lock 文件权限不对（比如 git 误设为 executable），都足以让整个 vendor 层缓存失效。
