单纯换 Composer 镜像源对 Docker 构建加速效果有限，因容器内默认不读取宿主机配置；须在 Dockerfile 中显式配置镜像源、复制预设 config.json 或使用 --repository 参数，并配合分层缓存与合理参数优化。
直接结论：单纯换 Composer 镜像源（比如阿里云、腾讯云）对 Docker 构建速度的提升非常有限，甚至可能没效果——因为 composer install 在容器内执行时，默认根本不会走宿主机的镜像源配置。
为什么改宿主机 composer config 没用？
Docker 构建是隔离环境，容器启动后是一个全新上下文。你在本地 composer config -g repo.packagist 设置的镜像源，只影响宿主机 CLI，不会自动透传进构建中的容器。
- 构建阶段的
composer install运行在临时容器里，它不读取你本机~/.composer/config.json - 除非你在
Dockerfile里显式执行composer config或挂载配置文件，否则它始终走官方 packagist.org（国内访问极慢） - 错误现象：构建日志里反复卡在
Downloading https://packagist.org/packages.json或某个包的.zip下载，耗时数分钟
真正有效的 Composer 镜像加速方式
必须把镜像源配置“写进构建流程”，而不是依赖宿主机。有且仅有以下三种可靠做法：
- 在
RUN composer install前，插入RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/（注意--global在容器内生效） - 用
COPY把预配置好的composer.json或config.json复制进镜像，其中已含"repositories"字段指向国内源 - 更推荐：改用
composer install --repository=https://mirrors.aliyun.com/composer/参数直连，不依赖全局配置，语义清晰且可复现
别忘了配合分层缓存，否则镜像源再快也白搭
即使用了国内源，如果 Dockerfile 写法不当，每次代码变更仍会触发全量重装——这时镜像源优化就完全失效了。
立即学习“PHP免费学习笔记（深入）”；
- 必须把
COPY composer.json composer.lock ./放在RUN composer install之前，且位置尽量靠前 - 避免
COPY . .出现在依赖安装之前，否则任何源码改动都会让composer install层缓存失效 - 加上
--no-dev --optimize-autoloader --no-scripts参数，减少非必要操作，缩短单次执行时间
最易被忽略的一点：Composer 镜像源只是“下载快”，但若 composer.lock 里锁的是 dev 分支或 git 仓库地址，依然可能绕过镜像源直连 GitHub —— 这类依赖需单独处理，不能只指望换源。
