还原镜像后仍为旧包，因镜像切换仅更新源地址，不触发依赖更新；需执行composer update或composer require强制刷新依赖树并重装。
Composer 镜像还原后为什么还是旧包？
还原镜像本身不会触发包更新，它只改 composer.json 里配置的源地址；真正拉取新版本得靠 composer update 或 composer require。很多人以为切回官方源（如 https://packagist.org）就能自动用上最新版扩展，结果 vendor/ 里还是旧的——因为 Composer 默认复用已安装的锁定版本（composer.lock 中记录）。
怎么让 Composer 真正获取最新扩展包？
分两步：先确保镜像已切回官方源，再强制刷新依赖树。操作前建议确认当前源：
composer config repo.packagist
若输出不是 {"type": "composer", "url": "https://packagist.org"}，就执行：
composer config --global repo.packagist composer https://packagist.org
然后根据需求选以下一种方式：
- 只更新某一个包（推荐）：
composer update vendor/package-name，比如composer update monolog/monolog - 更新所有包（谨慎）：
composer update，会重算整个依赖图，可能引入不兼容变更 - 仅更新
composer.lock而不重装（极少用）：composer update --lock，适用于改了composer.json但不想动vendor/
注意：composer install 永远按 composer.lock 安装，哪怕镜像已换、远程有新版也不会理会。
常见错误：还原镜像后 require 仍报错或超时
这通常不是镜像问题，而是本地网络无法直连 packagist.org（尤其在国内）。即使配置了官方源，Composer 仍需访问其 API 和 GitHub/GitLab 等上游仓库下载 ZIP 或克隆代码。典型现象包括：
Could not fetch https://api.github.com/repos/xxx/yyyFailed to decode response: file_get_contents(): SSL operation failed- 卡在
Downloading (connecting...)十几秒后失败
此时不能硬切回官方源，应优先检查：
- 是否设置了代理但未配置 Composer 的
http-proxy？可用composer config --global http-proxy http://127.0.0.1:8080补上 - 是否误删了全局配置导致部分请求走默认源？运行
composer config --list --global查看完整配置 - 是否用了老旧 Composer 版本（如 1.x）？v2+ 对 HTTPS 和重定向支持更好，升级命令：
composer self-update
为什么有时 update 还是装不到最新版？
根本原因在 composer.json 的版本约束写死了。比如写的是 "monolog/monolog": "^2.0"，那就算 3.x 已发布，也不会升级——^2.0 只允许 2.x 范围内更新。要获取真正最新版，得放宽约束：
- 临时测试可改成
"monolog/monolog": "*"（不推荐生产环境） - 查清目标包的稳定大版本号（如
3.5.0），显式指定："monolog/monolog": "^3.5" - 用
composer show monolog/monolog查看已知可用版本，再决定如何调整
另外，某些包在 Packagist 上标记为 abandoned（如 guzzlehttp/ringphp），即使镜像还原也找不到新发布，得按提示迁移到替代包。
