单元测试构建卡在downloading阶段，主因是未配中文镜像导致仍直连packagist.org，其dns解析慢、tls握手不稳定、cdn节点少且受网络策略干扰；ci环境必须用--repository-url显式指定镜像源，因全局配置无效，且需配合--no-dev、--optimize-autoloader及清理lock和vendor才能真正加速。
不配中文镜像，PHP单元测试套件的composer install阶段大概率卡死或超时——不是测试本身慢，是依赖根本下不来。
为什么单元测试构建总卡在Downloading阶段
CI流水线（如GitHub Actions、GitLab CI）里跑phpunit前必须装依赖，而默认走https://packagist.org。该域名解析慢、TLS握手不稳定、CDN节点少，且受网络策略干扰，导致composer install长时间停在Downloading xxx.zip或Resolving dependencies。这不是phpunit的问题，是源站不可达。
- 现象：日志里反复出现
GET https://packagist.org/packages.json失败，或Downloading vendor/symfony/console/...卡住超过2分钟 - 本质：单元测试套件往往依赖
phpunit、symfony/var-dumper、mockery等包，这些包体积小但数量多，高频请求放大网络延迟 - 关键点：
composer.lock里锁的是包元数据URL，不是下载地址；一旦镜像没生效，所有包仍会回源到packagist.org
CI环境必须用--repository参数直连镜像
全局配置composer config -g在CI容器里基本无效——runner用户无权读宿主机配置，且每次构建都是干净环境。唯一可靠方式是在composer install命令中显式指定镜像源。
- 正确写法：
composer install --no-dev --optimize-autoloader --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/ -
--no-dev跳过require-dev里的测试工具（如phpstan），加快安装；若需运行静态分析，可单独加步骤 -
--repository-url优先级高于全局和项目配置，确保100%走镜像，且不污染composer.json - 避免用
--repository（少-url），该参数已废弃，Composer 2.9.6+会报错
项目级配置要小心覆盖已有repositories
有些测试套件依赖私有包（如内部SDK），composer.json里已有"repositories"字段。直接执行composer config repo.packagist ...可能破坏结构，导致私有源失效。
- 安全做法：先检查
composer.json中"repositories"类型——若是对象（{}），命令会自动合并；若是数组（[]），命令会报错，需手动编辑 - 手动添加时，确保格式为：
"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}, {"type": "package", "package": {...}}] - 绝对不要写
"packagist": false——这会让php扩展、ext-*等基础约束校验失败，composer install直接退出 - 改完立刻删掉
composer.lock和vendor/，再跑composer install，否则旧lock文件仍指向官方源
Docker构建中镜像源配置容易漏掉分层缓存
在Dockerfile里加了RUN composer config --global ...，但构建速度没提升，问题常出在缓存层级错位。
- 必须把
COPY composer.json composer.lock ./放在RUN composer install之前，且紧挨着WORKDIR - 禁止在
composer install前COPY . .——任何代码变更都会让依赖层缓存失效，镜像再快也白搭 - 推荐组合：
RUN composer install --no-dev --optimize-autoloader --repository-url=https://mirrors.cloud.tencent.com/composer/ - 注意：
composer.lock若含git型依赖（如"type": "vcs"），镜像源对其无效，这类包仍直连GitHub，需单独处理
最易被忽略的是：镜像源只加速HTTP下载，不解决Resolving dependencies阶段的性能瓶颈——如果composer.json里版本约束太宽（比如"phpunit/phpunit": "*"），Composer仍需遍历大量版本做兼容性计算，此时换镜像毫无意义。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
