Composer如何配置并使用清华大学开源镜像（图文步骤）-composer-PHP中文网

清华镜像站需配合 secure-http: true 使用，否则因 composer 2.0 默认强制 https 且 http 重定向被拦截而静默回退官方源；项目级 repositories 会覆盖全局配置；证书、dns 或代理问题亦可能导致连接失败。

composer如何配置并使用清华大学开源镜像（图文步骤）

清华镜像站的 https://mirrors.tuna.tsinghua.edu.cn/composer/ 目前仍可用，但必须配合 secure-http: true 使用——这是最容易被忽略、导致配置后仍走国外源的关键点。

为什么 `composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/` 有时不生效

Composer 从 2.0 起默认强制启用 secure-http，而清华镜像站的 HTTP 重定向（如从 http:// 自动跳转到 https://）在某些网络环境或旧版 Composer 中会被拦截或拒绝。直接配 http:// 地址会静默 fallback 到官方源，且无明确报错。

必须显式开启 HTTPS 支持并使用完整 HTTPS 地址：

composer config -g secure-http true
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/

执行后可通过 composer config -g -l 检查输出中是否包含：

secure-http* true
repos.packagist* {"type":"composer","url":"https://mirrors.tuna.tsinghua.edu.cn/composer/"}

若 url 值仍是 http:// 或缺失 secure-http 行，说明配置未落盘或被项目级配置覆盖。

Discussion Composer

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

下载

项目级配置优先于全局，`composer.json` 里有 `repositories` 就会绕过全局镜像

很多团队在 composer.json 中手动写了 repositories 字段（比如私有包或测试源），这会完全屏蔽全局 repo.packagist 设置。运行 composer install 时，Composer 会按顺序查找：项目 repositories → 全局 repo.packagist → 官方源。

检查方法：

运行 composer config repos 查看当前生效的仓库列表
若输出中第一项是 packagist.org 或自定义 URL，说明项目级配置已接管
临时禁用项目级仓库：加 --no-plugins --no-scripts 并确认是否提速；长期建议删掉冗余 repositories 或改用 packagist.org 的 allow-plugins 白名单机制

`composer diagnose` 报 `curl error 60` 或连接超时？大概率是证书或 DNS 问题

清华镜像本身不提供 CDN 加速节点，全量同步依赖上游，部分地区（尤其是教育网出口）偶尔出现 TLS 握手失败或 DNS 解析缓慢。这不是镜像源故障，而是本地环境问题。

可快速验证和缓解：

用 curl -I https://mirrors.tuna.tsinghua.edu.cn/composer/packages.json 测试直连是否返回 200 OK
若失败，尝试 composer config -g cafile /etc/ssl/certs/ca-certificates.crt（Linux）或指定系统证书路径
临时换 DNS：echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf（仅测试用）
避免混用代理：export http_proxy= 和 https_proxy= 环境变量会干扰 Composer 对镜像站的直连判断

清华镜像不支持 ZIP 包加速分发（DIST_URL 单独配置无效），所有 .zip 下载仍走官方 dist 服务器。如果项目大量依赖含 dist 的包（如 Laravel），实际下载速度提升有限——这点常被宣传忽略。