为什么你的Composer需要配置国内镜像-composer-PHP中文网

应切换国内镜像源以解决 packagist.org 访问不稳定问题；推荐清华镜像（https://packagist.proxy.tuna.tsinghua.edu.cn），可通过 composer config -g repo.packagist 查看当前配置，支持全局、临时或项目级配置方式。

为什么你的composer需要配置国内镜像

因为默认源 packagist.org 在国内访问极不稳定，常出现超时、连接重置或下载卡死，直接导致 composer install 或 composer update 失败。

运行 composer config -g repo.packagist，如果输出是 {"type": "composer", "url": "https://packagist.org"}，说明没切镜像；如果返回空，说明可能被删过配置，但默认仍走官方源。

注意：composer config -g 只看全局配置，项目级配置（composer.json 同级的 composer.lock 不影响源，但 composer.json 里若有 "repositories" 字段会覆盖全局）。

清华、阿里云、腾讯云镜像目前较稳定，优先选清华（https://packagist.phpcomposer.com 已停用，别再用）。

Composer

Composer 是 PHP 生态常用依赖管理工具，用于安装框架、组件和项目依赖。

下载

全局替换（推荐）：composer config -g repo.packagist composer https://packagist.proxy.tuna.tsinghua.edu.cn
临时单次使用：composer install --repository-url=https://mirrors.cloud.tencent.com/composer

项目级配置：在 composer.json 中加字段：

"repositories": [
  {
    "type": "composer",
    "url": "https://mirrors.aliyun.com/composer/"
  }
]

注意：https://packagist.phpcomposer.com 域名已不可用，且旧版 Composer（file could not be downloaded，先升级 composer self-update。

所有主流镜像都同步 packagist.org 元数据，但同步有延迟（通常 5–30 分钟），所以刚发布的新包可能搜不到；另外部分镜像不提供 dist（压缩包）直链，而是回源代理，遇到大包（如 Laravel Sail 的 Docker 镜像）仍可能慢。

常见问题：

Package xxx not found：不是镜像问题，是包名拼错，或该包未提交到 Packagist（比如私有 Git 仓库没配置 type: vcs）
Could not parse version constraint：多因 composer.json 中 require 的版本写法错误，和镜像无关
换镜像后 composer update 变慢：可能是镜像 DNS 解析失败，可加 --verbose 看实际请求地址，再 ping 或 curl -I 测试连通性