必须在构建阶段完成，不能留到docker run时执行——否则镜像不可复现、启动慢、权限错、网络失败率高；因每次启动重装依赖、缓存失效、外网受限、扩展缺失等问题会直接破坏部署稳定性。
容器里跑 composer install 必须在构建阶段完成，不能留到 docker run 时执行——否则镜像不可复现、启动慢、权限错、网络失败率高。
为什么不能在容器启动时运行 composer install
这是反模式，不是“不推荐”，而是会直接破坏部署稳定性：
-
ENTRYPOINT或CMD里调用composer install，每次docker run都重拉包，国内网络下大概率卡在Resolving dependencies - vendor 目录不进镜像层，Docker 构建缓存完全失效，改一行代码就重装全部依赖
- 生产环境常禁外网，
composer install启动失败，服务起不来 - PHP 扩展（如
ext-zip）若没提前启用，此时报错已无法修复
多阶段构建中怎么写 composer install 才稳
核心是分层 + 提前复制锁文件 + 禁 dev + 权限隔离：
- 第一阶段用完整 PHP 镜像（如
php:8.3-cli），别用 Alpine 除非你确认所有扩展都装齐（比如zip、mbstring、openssl） -
COPY composer.json composer.lock ./必须放在COPY . .之前，否则任何代码变更都会让这层缓存失效 - 安装 Composer：用官方脚本
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 运行安装命令：
RUN composer install --no-dev --no-scripts --no-progress --no-interaction --optimize-autoloader - 加
--no-scripts是防某些包的 post-install-cmd 依赖宿主机工具（如 npm）
Alpine 镜像下 composer install 报 SSL 错误怎么办
不是网络问题，是证书缺失。Alpine 默认没装 CA 根证书：
- 必须加
RUN apk add --no-cache ca-certificates，否则报SSL certificate problem - 如果还报
ext-zip missing，得补上RUN apk add --no-cache zip && docker-php-ext-install zip - 别用已停用的镜像源，比如
https://packagist.phpcomposer.com（2026 年起不可用） - 国内加速请设环境变量：
RUN COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
构建后 vendor 权限和路径对不上，运行时报 “failed to open stream”
常见于多阶段构建或挂载卷场景，本质是用户 UID 和 autoload 路径不匹配：
- 第二阶段运行镜像里，
COPY --from=builder /app/vendor /app/vendor后，务必加--chown=www-data:www-data（或你实际运行用户） - 确保
WORKDIR和autoload.php路径一致；比如WORKDIR /app，那require __DIR__.'/vendor/autoload.php';才有效 - 别把
composer.json或composer.lock复制进最终镜像——它们不是运行必需，反而可能被误触发composer dump-autoload - 如果用非 root 用户（如
USER www-data），构建阶段也要提前创建该用户，并在COPY时指定属主
最易被忽略的一点：composer.lock 文件必须提交进 Git，且构建时严格按它还原——composer install 不带 --ignore-platform-reqs，否则 PHP 版本或扩展不匹配会在运行时才暴露。
