Composer配置tp国内镜像源_Composer加速tp扩展下载速度【技巧】-composer-PHP中文网

composer默认不识别“tp”专属镜像，需配置通用php镜像源（如阿里云https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9），且全局配置composer config -g repo.packagist必须严格满足三要素：键名repo.packagist（非repos）、显式type: "composer"、url为https且末尾带/；否则静默失效。

composer配置tp国内镜像源_composer加速tp扩展下载速度【技巧】

composer 默认不识别 “tp”（ThinkPHP）专属镜像源——它没有独立镜像站，所谓“tp国内镜像”本质是配置通用 PHP 包镜像源，让 thinkphp/framework 及其生态包（如 topthink/think-orm、topthink/think-swoole）能从国内服务器下载元数据和 ZIP 包。

`composer config -g repo.packagist` 必须写对三要素

这条命令是生效前提，错一个字符就等于没配：

键名必须是 repo.packagist（不是 repos.packagist，多一个 s 就静默失效）
值里必须带 composer 类型声明（不能省略，否则新版 composer 会 fallback 到官方源）
URL 必须用 HTTPS 且末尾带斜杠：@#@#@#@#@#@#@#@#@#@0 ✅，@#@#@#@#@#@#@#@#@#@1 ❌（少斜杠会导致路径拼接出错，返回 404）

验证是否写入成功：
运行 composer config -g repo.packagist，输出应为完整 JSON 对象，例如：
{"type": "composer", "url": "@#@#@#@#@#@#@#@#@#@0"}
如果为空、null 或报错，说明没生效。

为什么 `composer require topthink/think-orm` 还是从 packagist.org 下载？

不是镜像问题，是优先级或配置覆盖导致的：

项目根目录的 composer.json 里已有 "repositories" 字段 → 全局配置自动被忽略
CI 环境或 Docker 容器中，-g 写的是 root 用户的 ~/.composer/config.json，但实际执行用户（如 www-data）读不到
某些 topthink 包在 composer.json 中硬编码了 GitHub dist URL（如 "url": "@#@#@#@#@#@#@#@#@#@3..."），这类请求绕过镜像，直连 GitHub → 触发 rate limit 时会卡住或报 GithubRateLimitException

排查方法：加 -vvv 看真实请求域名
composer require topthink/think-orm -vvv 2>&1 | grep "Downloading"
若日志里出现 packagist.org 或 github.com，说明没走镜像或被硬编码绕过。

`composer update` 卡在 Resolving dependencies？和镜像无关

这个阶段完全不走网络，只做本地依赖图解析。ThinkPHP 项目常见诱因：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

composer.json 中 "require" 或 "require-dev" 版本约束太宽，比如 "topthink/think-orm": "^3.0 || ^4.0"，触发多轮版本回溯
启用了 xdebug（运行 php -v 可确认），会让解析慢 5–10 倍
config.platform.php 声明的 PHP 版本（如 "8.0"）与当前运行环境（如 PHP 8.2）不匹配，强制降级查找
composer.lock 文件残留已下线包（如旧版 topthink/think-captcha 已废弃），导致回退搜索失败