packagist.phpcomposer.com已于2022年下线，该命令失效；当前推荐使用阿里云或腾讯云镜像，需严格满足repo.packagist键名、composer类型、https且末尾带/三要素。
为什么 composer config -g repo.packagist composer https://packagist.phpcomposer.com 不再有效
这个命令曾经能快速切换国内镜像，但现在会报错或安装失败，因为 packagist.phpcomposer.com 已于 2022 年下线。不少老教程还在沿用，直接执行只会让 composer install 卡在 “Loading composer repositories” 或提示 Connection refused。
当前稳定可用的主流镜像是阿里云和腾讯云，二者都支持 HTTPS、同步及时（通常延迟
- 阿里云镜像地址：
https://mirrors.aliyun.com/composer/ - 腾讯云镜像地址：
https://mirrors.cloud.tencent.com/composer/ - 切记不要加末尾斜杠（
/）——加了会导致composer.json解析失败
全局配置镜像的推荐方式：用 composer config -g repo.packagist
这是最干净、影响范围可控的做法。它只修改全局配置文件 ~/.composer/config.json，不会污染项目级配置，也避免了环境变量误覆盖的风险。
执行以下任一命令即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer
验证是否生效：
composer config -g repo.packagist
输出应为：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer"}
- 如果返回空或报错，说明配置未写入，常见原因是用户家目录权限异常或
~/.composer被误删 - 若已存在其他镜像配置（比如之前设过华为云），该命令会直接覆盖，无需先删除
- 不建议用
composer config -g repos.packagist（少了个o），那是旧版写法，新版会静默忽略
项目级临时覆盖：在 composer.json 里写死 repositories
适用于 CI/CD 构建、多团队协作或需要锁定镜像源的场景。这种方式优先级高于全局配置，但必须手动维护，容易遗漏更新。
在项目根目录的 composer.json 中添加：
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer"
}
]
- 务必放在顶层 JSON 对象内，不能嵌套在
require或autoload下 - 如果已有
repositories数组，直接追加对象即可，不要覆盖原有内容（比如私有包源） - 执行
composer update后，Composer 会重新生成composer.lock，其中packages的下载 URL 会体现镜像地址，可用于排查是否真正走镜像
遇到 Invalid repository type: composer 怎么办
这个错误通常出现在 PHP 版本较低（
- 先检查版本：
composer --version—— 若显示Composer version 1.x，请升级：curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer - 升级后若仍报错，可能是系统 OpenSSL 版本过低，导致无法验证 HTTPS 证书；可临时加
--no-secure-http（仅调试用，不推荐长期启用） - 另一种情况是镜像 URL 多写了协议头，比如写成
https://https://mirrors.aliyun.com/composer—— 这种低级拼接错误在脚本自动化中很常见
镜像本身没问题，问题几乎总出在客户端环境或配置拼写上。别急着换源，先看 composer diagnose 输出里的 Checking https connectivity to packagist 行。
