composer没有“composer-pkg”官方中文镜像，国内可用的是阿里云、腾讯云等维护的packagist镜像；配置必须指定type为composer且url以https://开头并以/结尾，否则静默回退至官方源。
Composer 本身没有叫 “Composer-pkg” 的官方中文镜像，你搜到的大概率是过时或错误名称。国内能用的只有阿里云、腾讯云、华为云等几家维护的 packagist 镜像，不是独立的 “pkg” 镜像。配错名字或地址，composer config -g repo.packagist 看似成功，实际请求仍走官方源，卡在 Loading composer repositories with package information 是常态。
为什么composer config -g repo.packagist必须带composer类型参数
这个composer不是命令名，而是type字段值，告诉 Composer：“这是一个 Composer 协议的仓库”，不是 HTTP 代理或 Git 源。漏掉它，Composer 会静默 fallback 到 packagist.org，配置看似写入成功，实则完全不生效。
-
repo.packagist是固定键名，写成repos.packagist（多一个 s）或repository.packagist都不会报错，但配置无效 - URL 必须以
https://开头且末尾带/，例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠在某些版本下返回 404） - 旧版 Composer（/，但 2.x 和 7.x+ 强制路径匹配，不加斜杠=404
当前（2026年7月）可用的 packagist 中文镜像地址
别再用https://packagist.phpcomposer.com（2023 年已下线）或https://pkg.phpcomposer.com（跳转失效），这些地址现在基本等于 404 或无限重定向。实测稳定、全量同步、HTTPS 强制的只有以下三个：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/
三者任选其一执行即可，不需要改任何文件、不重启终端——但前提是 PHP 没禁用 proc_open 或 putenv（见下一条）。
执行composer config -g报错的常见原因和修复
不是镜像地址问题，而是 PHP 底层函数被禁用导致配置写入失败。典型报错包括：proc_open(): fork failed、putenv() has been disabled、command not found（其实是 PHP 执行失败后 shell 找不到命令）。
- 检查
php.ini中disable_functions是否包含proc_open或putenv，哪怕多一个空格也会失效 - 改完后必须重启 PHP-FPM / Apache / Nginx；CLI 模式需重启终端或重载环境变量
- 验证：
php -r "echo proc_open('echo 1', [], $p) ? 'ok' : 'fail';"输出ok才算通过 - Windows 用户若提示权限错误，先以管理员身份运行 PowerShell/CMD，或改用项目级配置绕过
怎么确认镜像真的在用，而不是“看起来生效”
composer config -g repo.packagist只显示你写了什么，不反映实际行为。真正有效的验证方式只有一种：触发真实网络请求并看域名。
- 运行：
composer clear-cache && composer require monolog/monolog -vvv 2>&1 | grep "Downloading\|GET" - 观察输出里出现的 URL：含
mirrors.aliyun.com或mirrors.cloud.tencent.com✅，含packagist.org或repo.packagist.org❌ - 如果项目根目录有
composer.json且定义了repositories字段，全局配置会被彻底忽略——此时得用composer update --repository-url=https://...临时覆盖 - PHPStorm 等 IDE 会缓存 Composer 配置，改完需重启 IDE 才能识别
镜像配置本质是客户端行为，不依赖系统代理、PHP 扩展或 php.ini 设置，只要 proc_open 可用、URL 格式正确、没被项目级配置覆盖，一行命令就足够。复杂点在于验证环节容易被假象误导，盯着真实请求日志才最可靠。
