Composer卡在Loading状态需换国内镜像源,推荐清华源:composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/,配后必须执行composer clear-cache并验证日志是否出现镜像域名。

Composer 默认源在国外,国内直连经常超时或失败,直接换镜像源就能解决——不是所有镜像都稳定,https://packagist.phpcomposer.com 已停用,现在推荐用清华、阿里或腾讯的镜像。
如何查看当前配置的源
运行命令就能看到当前生效的仓库地址:
composer config -g repo.packagist
如果输出是 {"type": "composer", "url": "https://packagist.org"} 或空,说明还没切源,需要手动设置。
全局切换为清华镜像(推荐)
清华源响应快、同步及时,且支持 HTTPS 和 IPv6,适合绝大多数场景。执行这一条命令即可:
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
注意几个关键点:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repo.packagist是配置项名,不能写成packagist或漏掉repo. - 末尾的
/不能省略,否则会报Invalid repository type - 如果提示
Could not fetch,先确认网络能通ping mirrors.tuna.tsinghua.edu.cn - 该命令修改的是全局配置(
~/.composer/config.json),不影响已有项目本地配置
临时切换源(单个项目用)
有些项目要求必须用官方源做兼容性验证,或者你正在调试镜像问题,可以只对当前目录生效:
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
区别在于去掉了 -g 参数,此时配置写入当前项目的 composer.json 的 repositories 字段。后续运行 composer install 或 update 就会优先走这个源。
想恢复默认?删掉 composer.json 里的 repositories 块,或运行:
composer config --unset repositories.packagist
遇到 “The 'https://mirrors.tuna...' URL could not be accessed” 怎么办
这不是镜像挂了,大概率是 PHP 的 OpenSSL 扩展没启用,或系统 CA 证书过旧。检查方式:
- 运行
php -m | grep openssl,没输出说明没开扩展 - 在
php.ini中确认extension=openssl已取消注释 - Linux/macOS 可尝试更新 CA 包:
sudo update-ca-certificates(Debian/Ubuntu)或brew install ca-certificates(macOS + Homebrew) - Windows 用户若用 XAMPP/MAMP,请确认其自带的
curl.cainfo指向有效的证书路径
镜像地址本身不常变,但证书链或本地环境信任链出问题,会导致“URL cannot be accessed”这类看似网络错误、实为 TLS 握手失败的问题。

















