如何打破PHP组件获取的速度瓶颈？启用Composer镜像服务就行！-composer-PHP中文网

composer install卡在downloading主因是直连packagist.org导致dns/tls慢和防火墙干扰，必须切换国内镜像源；config -g repo.packagist生效需满足三条件：字段名无s、第二参数为composer、url以https://开头且结尾带/，否则静默失效。

如何打破php组件获取的速度瓶颈？启用composer镜像服务就行！

composer install 卡在 Downloading 不是网络差，是默认还在直连 packagist.org——物理距离 + TLS 握手慢 + 防火墙干扰，导致请求超时或降速到几 KB/s。启用镜像不是“试试看”，而是必须做的第一步。

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

90% 的失败不是镜像站问题，是你命令敲错了三个硬性条件：

repo.packagist 不能写成 repos.packagist（多一个 s 就静默失效）
第二个参数必须是 composer（这是仓库类型声明，漏掉会 fallback 到官方源）
URL 必须以 https:// 开头，且末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）

验证是否写入成功：composer config -g repo.packagist 输出应为完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没生效。

宝塔面板或 CI 脚本里换源后依然卡住

宝塔的「PHP 管理器」、「一键部署」、「计划任务」默认以 www 用户身份运行，而 composer config -g 默认写的是当前登录用户（如 root）的配置文件（路径为 /root/.composer/config.json），www 用户读不到。

Discussion Composer

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

下载

查实际执行用户：在宝塔【终端】中运行 whoami 或看计划任务设置
给 www 用户单独配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI/CD 构建中更稳妥的做法是项目级配置（写进 composer.json），或每次用临时参数：composer install --repository=https://mirrors.aliyun.com/composer/

项目级配置如何避免清空私有仓库

执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会向 composer.json 的 repositories 字段追加条目，但前提是该字段已存在且格式合法。否则可能被全量替换，导致已有的私有 Git 源丢失。

若 composer.json 中已有 "repositories": {}，推荐手动编辑，在数组内显式添加：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}
根节点需加 "packagist.org": false（注意：不在 repositories 内部，而在最外层）
已有 composer.lock 的项目，首次换源后建议删掉 vendor/ 和 composer.lock，再重新 composer install，否则易出现 hash 不匹配错误

换源后仍卡在 Resolving dependencies 怎么办

镜像只加速下载环节；如果卡在 Resolving dependencies，和网络无关，是本地约束太宽导致求解器指数级爆炸。

检查 composer.json 是否写了模糊版本号，比如 "monolog/monolog": "*" 或 "^6.0" 跨度过大
禁用 xdebug（它会让依赖解析慢数倍）：php -d xdebug.mode=off composer install
收紧 PHP 版本约束（如把 "php": "^7.4 || ^8.0" 改为 "php": "^8.2"）
清理缓存：composer clear-cache，并确认没启用 packagist.org 回退（composer config -g repos.packagist 若输出含 packagist.org，说明镜像未覆盖）