PHP开发者必备工具，Composer中文镜像助你加速！-composer-PHP中文网

composer在国内不配镜像基本无法安装依赖，配错则静默失效；正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，需确保键名单数、type显式写出、url为https且末尾带斜杠，并执行clear-cache验证生效。

php开发者必备工具，composer中文镜像助你加速！

不配镜像，Composer 在国内基本装不了依赖——不是慢，是大概率卡死或 403。 配错比不配更糟：静默失效、日志无提示、你以为好了其实还在直连 packagist.org。

composer config -g repo.packagist 命令必须写对这三处

90% 的“配了没用”源于命令敲错，且 Composer 不报错，只默默 fallback 回官方源：

repo.packagist 不能写成 repos.packagist（多一个 s 就彻底失效）
中间的 composer 是 type 值，不可省：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ ✅；漏掉就白配
URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅；https://mirrors.aliyun.com/composer ❌（缺斜杠会导致部分 Composer 2.2+ 版本请求 404）

验证是否生效：运行 composer config -g repo.packagist，输出必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串。空、null、或仍是 https://packagist.org，说明没写进去。

宝塔、CI、Docker 里镜像不生效？用户身份没对上

全局配置写在当前用户的 ~/.composer/config.json，但宝塔「一键部署」默认用 www 用户跑，CI 流水线用 runner 用户，它们根本读不到你 root 下配的镜像：

在宝塔终端里先执行 whoami，确认实际用户（通常是 www）
切到对应用户下重配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 脚本中别依赖全局配置，改用临时参数更可靠：composer install --repository-url=https://mirrors.aliyun.com/composer/

别指望 sudo composer config -g 写进 root 配置后，其他用户能自动继承——Composer 不共享跨用户配置。

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

项目级配置 safer，但别用命令覆盖已有 repositories

进项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会**全量替换** composer.json 中的 repositories 字段，不是追加：

如果项目已配私有 Git 源（如 "my-vcs": {"type": "vcs", "url": "..."} ），这条命令会直接清空它们
已有 "repositories": {}（空对象）？命令能安全 merge；但如果是 "repositories": []（数组），会报错，得先手动改成对象
更稳妥的做法：手动编辑 composer.json，在 repositories 里加一条 "packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并确保根节点有 "packagist.org": false（注意：不是放在 repositories 里）