镜像本身不参与PHP版本兼容性判断，真正卡住你的是platform配置错位、缓存污染或锁文件残留；需先确认真实PHP版本、检查platform配置、验证扩展是否加载，再决定是否调整镜像源。
镜像本身不参与 PHP 版本兼容性判断，真正卡住你的是 platform 配置错位、缓存污染或锁文件残留 —— 换镜像解决不了依赖解析失败，但可能掩盖真实问题。
composer install 报 “requires php ^8.1” 却卡在镜像请求阶段？先确认真实 PHP 版本和 platform 声明
镜像只是下载通道，requires php ^8.1 这类信息来自包的 metadata，不是镜像生成的。很多人以为换源就能绕过，结果反复失败。
- 运行
php -v确认 CLI 使用的确实是 PHP 8.x（注意：Docker 容器、CI runner、asdf/shim 可能加载不同版本） - 运行
composer config --list | grep platform查是否意外设置了config.platform.php；若输出含platform.php : 7.4.33，说明 Composer 正在假装自己跑在 PHP 7.4 上，哪怕你本地是 8.2 —— 这会让镜像返回的 PHP 8 兼容包被直接过滤掉 - 临时验证：删掉
config.platform.php后运行composer show --platform php，输出应为真实版本；再试composer install -v，看冲突提示是否变化
换了阿里云/腾讯云镜像，composer update 却卡在 “Resolving dependencies” 超过 2 分钟
这不是网络慢，是 Composer 求解器在 PHP 8 约束下陷入组合爆炸。老项目中大量 ^7.2+|| ^8.0 的混用声明，加上镜像返回的完整包列表（含大量已废弃分支），会让求解器反复回溯。
- 删掉
vendor/和composer.lock，再执行composer update --no-plugins --with-dependencies，禁用插件可排除hirak/prestissimo等旧插件在 PHP 8.3 下的反射异常干扰 - 若仍卡住，加
-v后观察输出中是否频繁出现Checking monolog/monolog 2.10.0 → requires php ^7.2 || ^8.0 → backtracking，这是典型求解器震荡 - 此时应手动收紧根依赖的 PHP 约束：
"php": "^8.1"替换掉模糊的"php": ">=7.4"
镜像返回的包元数据中 requires.php 字段缺失或仍是 ^7.2？说明索引未同步
PHP 8.x 要求 Composer 使用新版 metadata schema（含联合类型、static 返回类型等语法），老镜像服务若未升级后端索引逻辑，会返回解析失败的 JSON 或缺失 requires.php 字段。
立即学习“PHP免费学习笔记（深入）”；
- 用
curl访问镜像的包信息接口，例如：https://mirrors.aliyun.com/packagist/p2/monolog/monolog.json（将域名替换为你用的镜像） - 查看返回 JSON 中是否有
requires.php字段，且值类似"^8.0 || ^8.1"—— 若为空、为"^7.2"或字段缺失，说明镜像未更新索引 - 对比官方源同路径返回内容：
https://packagist.org/p2/monolog/monolog.json，差异即为镜像滞后点 - 临时切回官方源验证：
composer config --global repo.packagist.org.url https://packagist.org+composer clear-cache+composer update --dry-run -v
composer require ext-redis 却报 missing，换镜像毫无作用
镜像不校验扩展是否存在，这个报错是 Composer 在本地执行 extension_loaded('redis') 失败所致。换镜像解决不了运行时环境缺失问题。
- 先确认扩展真装上了：
php -m | grep redis，若无输出，说明 PHP 扩展未启用，镜像再快也没用 - Windows 下检查
php.ini是否启用了extension=php_redis.dll；Linux 下确认是否安装了php-redis包（如apt install php-redis） -
ext-redis是运行时依赖，不是镜像能“提供”的东西；它只影响composer install阶段的平台校验，不影响包下载
最常被忽略的点是：镜像配置正确 ≠ 本地环境就 ready。很多“PHP 8 兼容问题”其实发生在 composer install 之后的第一次 php index.php —— 那时才真正暴露语法错误、str_contains() 不存在、或 enum 解析失败。镜像管不到那一步。
