PHP 8.5 配 Composer 镜像必须满足三条件：键名严格为 repo.packagist（单数小写）、type 值强制写 composer、URL 须 HTTPS 且末尾带 /；推荐项目级配置并补 packagist.org:false，配后需清缓存、删 vendor/ 和 lock、重装依赖，并用 diagnose 或 show 验证实际生效。
PHP 8.5 默认搭配 Composer 2.5+，对镜像源配置格式极其严格——配错一个字符就会静默回退到 packagist.org，且不报错、不提示。这不是网速问题，是配置没生效。
必须满足的三个硬性条件
无论用全局还是项目级方式，以下三点缺一不可：
-
键名必须是
repo.packagist（单数、全小写）：写成repos.packagist或repositories.packagist，Composer 直接忽略 -
composer是强制 type 值，不能省略：命令中必须显式写出这个单词，它不是注释，也不是可选参数 -
URL 必须是 HTTPS 且末尾带
/：例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404，然后自动降级
推荐操作：项目级配置（更可靠）
PHP 8.5 常运行在宝塔、Docker、GitHub Actions 等多用户环境，全局配置（-g）容易因权限隔离失效。直接在项目里配，优先级更高、行为可预期：
- 进入含
composer.json的项目根目录 - 执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 该命令会自动在
composer.json的"repositories"对象下添加"packagist"条目（前提是原repositories是对象{}，不是数组[]） - 务必同步加上：
"packagist.org": false（否则 Composer 2.2+ 仍可能 fallback）
配完必须做的三件事
只改配置不清理，镜像等于白配：
立即学习“PHP免费学习笔记（深入）”；
- 清空缓存：
composer clear-cache - 删掉
vendor/和composer.lock - 重装依赖：
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或tuna.tsinghua.edu.cn
验证是否真在用镜像
别信 composer config -g repo.packagist 的输出，它只告诉你“写了什么”，不等于“正在用”：
- 运行
composer diagnose，看 “Repo packagist.org” 行后显示的 URL 是不是你的镜像地址 - 或临时指定源测试：
composer show laravel/framework --repository-url=https://mirrors.aliyun.com/composer/，能正常输出版本即证明镜像可用 - 日志中关键线索：
Reading packages.json from cache at /https---mir...（路径含镜像域名才对）
