宿主机 composer config 对 Docker 构建无效，因构建在隔离容器中执行；必须在 Dockerfile 中显式配置镜像源，推荐 RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
为什么改宿主机 composer config 没用
容器构建是隔离环境，composer install 在临时构建容器中执行，它完全不读取你本机 ~/.composer/config.json。你在终端里执行的 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 只影响宿主机 CLI，对 Docker 构建零作用。
典型错误现象：构建日志卡在 Loading composer repositories 或反复下载 https://packagist.org/packages.json，耗时数分钟——这不是网络慢，是根本没走镜像源。
Dockerfile 中必须显式配置镜像源的三种写法
只有把镜像源“写进构建流程”，才能生效。推荐按优先级排序：
-
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（全局生效，最稳） -
RUN composer install --repository=https://mirrors.aliyun.com/composer/ --no-dev --optimize-autoloader（参数覆盖，语义清晰，适合 CI 多源切换） -
COPY config.json /root/.composer/config.json（需提前生成含"repositories"字段的 JSON 文件，注意路径和权限）
注意：repo.packagist 拼写不能错；URL 末尾必须带 /；验证是否生效可加 RUN composer config -g repo.packagist 查看输出是否为完整 JSON 对象。
并发下载数设太高反而会失败
http-max-concurrent-downloads 不是越大越好。设成 15 容易触发 file_put_contents(/tmp/): failed to open stream 错误——不是磁盘满，而是容器 tmpfs 的 inode 耗尽或临时文件竞争。
实操建议：
- CI 环境建议设为
6（稳定兼容） - 本地构建可试
8，但必须配合COMPOSER_CACHE_DIR=/root/.composer/cache - 别用已弃用的
parallel-downloads，Composer 2.2+ 会静默忽略
正确写法：RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ && composer config -g http-max-concurrent-downloads 6
镜像源只是下载快，绕过它的依赖仍会卡住
如果 composer.lock 里锁的是 dev-master、git@github.com 或 https://github.com/xxx/xxx.git 这类地址，Composer 会直接走 Git 协议或 HTTPS 克隆，完全绕过 packagist 镜像源。
这类依赖无法靠换源解决，必须：
- 检查
composer.lock中"source"字段是否含"type": "git" - 对关键包改用
dist方式发布（如要求维护者打 tag） - 必要时在
composer.json中显式指定"preferred-install": "dist"
最容易被忽略的是：你以为换源就万事大吉，结果一半包还在直连 GitHub，构建时间纹丝不动。
