ThinkPHP项目怎么使用Composer国内镜像加速下载？-composer-PHP中文网

composer install卡在downloading主因是镜像配置错误：键名必须为repo.packagist、命令中必须含composer type、url末尾必须带/，且需验证config -g输出为完整json或正确url；项目级配置更可靠，换源后须删vendor和composer.lock重装。

thinkphp项目怎么使用composer国内镜像加速下载？

composer install 卡在 Downloading，八成没配对国内镜像——不是网络差，是命令写错、配置没生效，或者项目里已有 repositories 覆盖了全局设置。

为什么 `composer config -g repo.packagist` 没生效？

这条命令静默失败太常见，错一个字符就等于白配：

键名必须是 repo.packagist（不是 repos.packagist、packagist.org 或 repositories）
命令里必须带 composer 这个 type 值：正确写法是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间的 composer 就 fallback 到官方源
URL 必须以 / 结尾：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（少斜杠会导致路径拼接错误，返回 404）

验证是否写入成功，只看这一行输出：
composer config -g repo.packagist
结果必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象，或者至少是那个带斜杠的 URL 字符串。空、null、报错、或仍显示 https://packagist.org，说明根本没写进去。

项目级配置比全局更可靠，尤其 CI 和宝塔环境

全局配置只对当前用户生效，而宝塔用 www 用户、Docker 容器用 root 或 app 用户，它们读不到你本地的 ~/.composer/config.json。项目级配置写进 composer.json，拉代码即生效：

进入 ThinkPHP 项目根目录（有 composer.json 的那层），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）
这条命令会自动向 composer.json 的 "repositories" 数组追加 packagist 条目，不覆盖已有的私有源
如果项目已有 "repositories": {} 或 "repositories": []，手动编辑极易格式出错，务必用命令追加
改完后必须删掉 vendor/ 和 composer.lock，再跑 composer install ——旧 lock 文件记录的是 packagist.org 的包哈希，和镜像源不兼容

换源后还是慢？别只盯着下载环节

镜像只加速 Downloading 阶段，解决不了依赖解析卡顿。如果 composer update 卡在 Resolving dependencies，和镜像无关：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

检查 PHP 内存限制：COMPOSER_MEMORY_LIMIT=-1 composer update 临时放开限制
Xdebug 启用中会让解析慢 5–10 倍：php -d xdebug.mode=off $(which composer) update
composer.json 里的 "config": {"platform": {"php": "8.1"}} 和实际 PHP 版本不一致，会触发大量版本降级查找
某些 topthink 包硬编码了 GitHub dist URL（比如 "url": "https://github.com/top-think/think/releases/download/v8.0.0/think-8.0.0.zip"），这类请求绕过镜像，直连 GitHub → 触发 rate limit 时会卡住或报 GithubRateLimitException

真要确认当前走的是哪个源，加 -vvv 看日志：
composer require topthink/think-orm -vvv 2>&1 | grep "Downloading"
眼见为实，别信“命令跑完了”。

阿里云镜像 URL 必须用 HTTPS 且末尾带斜杠

别用已停更的旧地址（如 https://packagist.phpcomposer.com），它 2022 年就下线了；也别抄错 URL。目前稳定可用的有：

阿里云：https://mirrors.aliyun.com/composer/
腾讯云：https://mirrors.cloud.tencent.com/composer/

新版 Composer 2.2+ 默认开启官方源 fallback：镜像返回 404 或 503 时会自动切回 packagist.org 查一次。别轻易关掉这个机制——比如执行 composer config -g repos.packagist false，否则缺失包直接报错，而不是兜底尝试。