必须同时满足键名repo.packagist（单数）、type值显式为composer、URL以https://开头且末尾带/，三者缺一即静默回退官方源；验证需输出完整JSON如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
不能靠 Composer 安装 Phalcon 扩展本身，中文镜像只加速 devtools、ide-stubs 等 PHP 包的下载；但镜像配错，连这些包都拉不下来——所以必须先配对、再验证。
composer config -g repo.packagist 命令为什么总没反应
它不报错，但实际没生效，常见原因就三个：
-
repo.packagist写成repos.packagist（多一个 s），Composer 2.x 会静默忽略 - 漏掉中间的
composertype 值，比如执行的是composer config -g repo.packagist https://mirrors.aliyun.com/composer/，缺了composer这个参数，整条配置被跳过 - URL 少了末尾
/，例如写成https://mirrors.aliyun.com/composer，请求时会拼成/composerpackages.json，返回 404
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写成功。
项目级配置比全局更可靠，但写法有坑
团队协作或 CI 环境中，全局配置（-g）不可靠——Jenkins、GitLab CI、宝塔后台都以不同用户运行，~/.composer/config.json 不共享。推荐直接写进项目 composer.json：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先进入项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令会自动在
composer.json的repositories字段下添加"packagist": {...}条目 - 前提是
repositories当前是对象（{}），不是数组（[]）；如果是数组，需手动改成"repositories": {}再执行 - 必须同时加
"packagist.org": false，否则你配的镜像只是“额外源”，官方源仍会优先尝试
最终 composer.json 片段应类似：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
},
"packagist.org": false
}
换源后还是卡在 “Loading composer repositories”
镜像只改元数据和 ZIP 下载路径，不解决缓存污染和 lock 文件残留问题：
- 先运行
composer clear-cache，否则旧缓存里的 packagist.org 地址还在起作用 - 删掉
vendor/和composer.lock，因为 lock 文件里记录的是旧源的 hash，和镜像元数据不匹配会导致安装中断 - 再执行
composer install -vvv，日志里必须出现mirrors.aliyun.com或mirrors.cloud.tencent.com，而不是packagist.org - 如果还卡住，检查是否用了代理但只配了
http-proxy没配https-proxy——Packagist 全量走 HTTPS，漏掉https-proxy会 fallback 直连，在内网环境等于失败
Phalcon 相关包能用镜像加速，但扩展本身不能
明确边界很重要：
-
phalcon/devtools和phalcon/ide-stubs是纯 PHP 包，走 Packagist，镜像能加速它们的下载 -
ext-phalcon是 C 扩展，不发布在 Packagist，镜像对它完全无效；它只在composer.json中起校验作用："require": { "ext-phalcon": "*" } - 执行
composer require phalcon/phalcon是错的——这个包早已废弃，装完也加载不了扩展，还会干扰 autoloading - 真正要做的只有三步：手动安装
phalcon.so→ 验证php -m | grep phalcon有输出 → 再用 Composer 管理 devtools 和 stubs
最容易被忽略的一点：所有镜像地址现在都强制 HTTPS 且必须以 / 结尾，https://packagist.phpcomposer.com 已下线，http:// 开头的地址会被 Composer 2.5+ 直接拒绝。
