如何利用Composer中文镜像提高生产环境部署速度（部署指南）-composer-PHP中文网

composer全局镜像配置生效需同时满足三个硬性条件：键名必须为单数repo.packagist、type值必须显式指定为composer、url须以https://开头且末尾带/，任一缺失即静默回退官方源，验证输出必须为完整json对象。

如何利用composer中文镜像提高生产环境部署速度（部署指南）

生产环境部署慢，八成卡在 composer install，不是网络差，也不是代码问题，而是镜像没配对、参数漏了、缓存没清——三者缺一，提速就成空谈。

composer config -g repo.packagist 为什么总不生效

这条命令看似简单，但错一个字符就静默回退到 https://packagist.org，且完全不报错：

repo.packagist 不能写成 repos.packagist（多一个 s 就彻底失效）
必须显式带上 composer 这个 type 值：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
URL 必须是 HTTPS 且末尾带 /：https://mirrors.cloud.tencent.com/composer/ ✅，https://mirrors.cloud.tencent.com/composer ❌
漏掉 -g 就只改当前项目，换目录即失效

验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}。空、null、或仍显示官方地址，说明没写进去。

CI/CD 中 composer install 还卡在 Resolving dependencies

镜像只加速下载，不加速依赖解析。这个阶段卡住，和网络无关，典型原因有：

composer.json 里写了过宽的 PHP 版本约束，比如 "php": "^7.4 || ^8.0 || ^8.1"，触发求解器暴力穷举
存在 "minimum-stability": "dev"，强制拉取不稳定分支，候选版本爆炸
composer.lock 被删或未提交，install 实际退化为 update
repositories 字段指向了已下线的私有源，Composer 逐个超时才 fallback

快速排查：进项目根目录，执行 composer config --list | grep repositories 看实际生效源；再跑 composer validate --strict 确认 lock 文件合法。

Discussion Composer

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

下载

部署脚本里必须加的四个参数

光换镜像只是第一步，生产环境必须同时带上这四个参数，缺一不可：

--no-dev：跳过 require-dev 包（如 phpunit），省掉 30–60% 时间，也避免调试入口混入线上
--prefer-dist：强制走 ZIP 包，避免 git clone 的 I/O 和网络开销；但前提是镜像已生效，否则会 fallback 到慢速 source
--optimize-autoloader（或 -o）：生成 vendor/composer/autoload_classmap.php，类加载从平均 1.2ms 降到 0.05ms
--classmap-authoritative（或 -a）：告诉 autoloader “没在映射里 = 真没有”，彻底跳过文件扫描；漏掉它，--optimize-autoloader 几乎无效

CI/CD 推荐完整写法：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类直接 Class not found。

为什么删了 vendor 和 composer.lock 后还要 clear-cache

镜像配置生效后，旧缓存里的元数据（比如 packages.json）仍指向 packagist.org，Composer 会优先读缓存，根本不发新请求：

执行 composer clear-cache 是硬性步骤，否则 install 仍走海外地址
项目级配置可能覆盖全局，用 composer config --list 和 composer config --list --global 对比确认实际生效的是哪个
某些包硬编码 GitHub URL（如 "dist": {"url": "https://github.com/xxx/yyy/archive/"} ），这类不会走镜像，会撞上 GitHub Rate Limit；报错含 GithubRateL 就是它

真正卡住时，唯一能确认镜像是否命中的方式是加 -vvv：日志里出现 GET https://mirrors.cloud.tencent.com/composer/p2/ 才算成功。别信“命令跑完了”，得看 HTTP 请求地址。