在docker中使用composer应在构建阶段通过多阶段dockerfile执行composer install，需正确配置php扩展、ca证书、国内镜像源（如阿里云）及copy顺序，避免运行时安装导致失败。
直接在 RUN 指令中设置环境变量或全局配置，就能生效——不需要 COPY 宿主机的 auth.json 或修改 ~/.composer/config.json，因为构建过程根本不会读它。
composer install 卡在 “Resolving dependencies” 怎么办
这不是 Composer 本身慢，是默认连 packagist.org 在国内 DNS 和 CDN 路由下几乎必超时。Docker 构建不复用宿主机缓存，每次都是全新连接。
- 最稳方案：在
RUN前加环境变量，比如RUN COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 别用已停用的镜像源，例如
https://packagist.phpcomposer.com（2026 年起不可用） - Alpine 镜像必须先装证书：加上
RUN apk add --no-cache ca-certificates，否则报SSL certificate problem - 如果项目有
composer.lock，就只跑install，别在构建阶段跑update，否则破坏可重现性
docker build 里 composer 命令报 command not found
官方 PHP 镜像（如 php:8.3-cli）并不预装 Composer，得手动装；装完还得确保它在 $PATH 里。
- 推荐安装方式：
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - Debian/Ubuntu 系镜像可直接用上面命令；Alpine 需先装
curl和openssl：RUN apk add --no-cache curl openssl - 别把
composer.phar放进项目目录再php ./composer.phar—— 这会导致不同容器行为不一致，也难统一升级 - 验证是否装好：
RUN composer --version，构建失败就说明路径或权限没对
多阶段构建中怎么安全用国内镜像
builder 阶段要装依赖，但最终镜像不能带 dev 包、源码或缓存，同时又要保证国内镜像配置不丢失。
- 在 builder 阶段的
RUN中显式注入镜像源，比如：RUN COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install --no-dev --optimize-autoloader - 别用
composer config -g写全局配置——Alpine 镜像可能因gnupg缺失导致失败，且多阶段中-g的写入位置不一定被后续阶段继承 - COPY 顺序必须是：先
COPY composer.lock .，再COPY composer.json .，最后RUN composer install；否则会退化成update，版本失控 - builder 阶段装完后，只
COPY --from=builder /app/vendor /app/vendor，不复制~/.composer或缓存目录
最容易被忽略的是 Alpine 镜像的证书和 COPY 顺序——前者导致 HTTPS 握手失败，后者让构建看似成功实则装错包。这两个点一出问题，错误现象都像“网络超时”，但根源完全不同。
