不同PHP版本下镜像配置“失效”是因为composer config -g仅写入当前用户$HOME/.composer/config.json，而PHP 8.2 CLI、PHP 7.4 FPM、宝塔等以不同用户运行，读取不同配置路径；phpstudy/XAMPP的composer硬编码路径，无视系统PATH；项目级配置（composer config repo.packagist composer https://mirrors.aliyun.com/composer/）才真正跨版本可靠。
为什么不同PHP版本下镜像配置会“失效”
不是镜像地址变了，而是 Composer 配置被写进了错误的用户上下文。执行 composer config -g repo.packagist 时，它只写入当前用户 $HOME/.composer/config.json；但 PHP 8.2 CLI、PHP 7.4 FPM、宝塔面板里的 PHP 进程，可能分别以 yourname、www-data、www 用户运行——它们各自读取的配置文件路径完全不同。
更隐蔽的是：phpstudy/XAMPP 自带的 composer 可执行文件是硬编码路径的，根本不走系统 PATH，自然无视你配好的全局配置。
- 用
composer --version第一行确认真实 PHP 版本（如PHP 8.2.5 (cli)），别信php -v - 查 shebang：
head -1 $(which composer)，若输出#!/usr/bin/php8.1，说明它被锁死在旧版 PHP，改 PATH 没用 - 多版本共存时，
-g的“全局”仅指“当前用户”，不是“所有 PHP 版本”
项目级配置才是跨 PHP 版本的可靠方案
把镜像声明直接写进 composer.json，所有 PHP 版本、所有用户、所有 CI 环境都会一致读取，完全绕过用户目录差异。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 该命令自动向
composer.json的repositories字段追加，key 必须是packagist，不能写成aliyun或repos.packagist - 已有私有源？命令会安全合并，不会覆盖原有
repositories数组 - 提交
composer.json到 Git，团队成员拉代码后无需任何额外操作
验证镜像是否真生效，别被 composer diagnose 欺骗
composer diagnose 显示 “OK” 不代表镜像在用——它只校验语法和本地连通性，不验证元数据是否完整或是否走对了源。
立即学习“PHP免费学习笔记（深入）”；
- 必须运行：
composer config -g repo.packagist，输出得是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 若返回空、
null或仍是https://packagist.org，说明配置失败（常见原因：漏composertype 值、URL 少末尾/、键名错写成repos.packagist） - 再跑一次
composer install -vvv，看日志里首次请求的 URL 是不是https://mirrors.aliyun.com/composer/packages.json - 手动验证镜像站可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回200 OK
四个当前真实可用的国内镜像源对比
截至 2026 年 8 月，仍在持续同步、支持 Composer 2.9.6+、HTTPS 稳定的只有这四个：
-
https://mirrors.aliyun.com/composer/：同步最快（约 15 分钟）、CDN 覆盖全、南方/北方延迟均低于 60ms，适合绝大多数场景 -
https://mirrors.tuna.tsinghua.edu.cn/composer/：教育网和北方地区极快，但部分私有包索引略滞后，适合学术环境 -
https://mirrors.cloud.tencent.com/composer/：华南地区下载峰值达 9.2MB/s，TLS 证书链已修复 -
https://php.cnpkg.org：Laravel 11 和 PHP 8.5 兼容包入库最快，但文档弱，出问题靠社区反馈
所有 HTTP 地址（无 https://）在 Composer 2.2+ 中默认被拒绝；https://packagist.phpcomposer.com 和 https://packagist.laravel-china.org 已停服或频繁 502。
