PHP微版本升级后composer install报错根源是Composer未感知版本变化，需执行composer clear-cache、删除composer.lock、再运行composer install以重建依赖图。
PHP微版本升级后composer install报错的根源
不是 Composer 故意找茬，而是它根本没“感知”到 PHP 版本变了。composer install 严格按 composer.lock 还原依赖，而 lock 文件里只存包版本和哈希，不记录 PHP 微版本（比如 8.1.22 → 8.1.23）。只要 lock 文件没变，Composer 就默认环境一致，直接跳过平台兼容性重校验。
常见错误现象与真实原因
你刚用 phpbrew switch php-8.1.23 或 update-alternatives --config php 切到新微版本，执行 composer install 却报：Your requirements could not be resolved to an installable set of packages.
- 表面是依赖冲突，实际是某个已锁死的包（比如
symfony/console v5.4.30）在 PHP 8.1.23 中触发了废弃警告（Deprecated: Function mcrypt_*() is deprecated），而该包的维护者已在新版本中移除对ext-mcrypt的调用——但 lock 文件仍指向旧版 -
composer diagnose显示PHP version: 8.1.23，但composer install -vvv日志末尾却出现Reading /home/user/.composer/cache/repo/https---packagist-org/p/provider-2025-07%24.json——说明 Composer 正从缓存读取为旧 PHP 版本生成的 provider 元数据 - 某些扩展（如
ext-opcache）在微版本间 ABI 可能有细微变动，导致vendor/autoload.php加载时Class 'Opcache' not found，但 Composer 安装阶段完全不检查这个
必须执行的三步清理操作
不能只跑 composer update，那会复用旧缓存继续错。要让 Composer 重新“睁眼”看当前环境：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer clear-cache—— 清掉 provider 缓存和 dist 包缓存，否则它仍会加载为 PHP 8.1.22 构建的provider-*.json - 删掉项目根目录下的
composer.lock—— 微版本升级本身不改composer.json，但 lock 文件已失效，必须重建 - 执行
composer install（不是update）—— 因为install会基于当前 PHP 版本 + 清空后的缓存，重新解析整个依赖图并生成新 lock 文件
为什么不用--ignore-platform-reqs
加 --ignore-platform-reqs 能让 composer install 成功，但代价是掩盖问题：
立即学习“PHP免费学习笔记（深入）”；
- 它跳过所有平台检查，包括
ext-xml、ext-json是否可用 —— 某些包（如spatie/laravel-backup）在缺少ext-zip时安装成功，运行时才报Class 'ZipArchive' not found - 微版本间函数签名可能有变更（比如
mb_strcut()在 PHP 8.1.23 中新增$encoding参数默认值），--ignore-platform-reqs不阻止装上依赖，但运行时ArgumentCountError更难定位 - CI 流水线里用这个参数，等于把环境缺陷打包进镜像，上线后才发现
真正需要关注的是：PHP 微版本升级后，composer.lock 已不是“确定性还原”的依据，它成了过期快照。每次微版本变动，都得把它当垃圾扔掉重来。
