90%的PHP 8.0 Composer依赖冲突源于php版本约束被主动拒绝，而非版本无法解析；只要任一依赖（含dev或间接依赖）声明了高于8.0的php要求，Composer即刻中止并报“Your PHP version does not satisfy that requirement”。
PHP 8.0 的 Composer 依赖冲突，90% 不是版本“解不开”，而是你本地 PHP 版本被某个 composer.json 里的 "php": "^8.2" 或 "php": ">=8.3" 主动拒绝——Composer 连依赖树都不开始算，直接报错退出。
为什么 composer install 直接卡在 “Your PHP version does not satisfy that requirement”
这不是网络、权限或缓存问题，是 Composer 的平台校验机制在起作用。只要任意一个已声明的依赖（包括根项目、require-dev 里的测试工具、甚至某个间接依赖的 composer.json）写了高于 PHP 8.0 的 php 约束，它就会立即中止。
- 运行
composer install -v，看第一行报错里明确出现的php ^8.2或php >=8.3—— 这就是阻断源 -
composer show --platform输出的php行，必须和你实际php -v一致；若不一致，说明config.platform.php被误写进composer.json - 别只查自己项目的
composer.json，用composer why-not php:8.0（注意不是php:^8.0）能定位到具体哪个包在提要求
--ignore-platform-req=php 是最安全的绕过方式
它只跳过 PHP 版本检查，保留所有扩展（ext-mbstring、ext-dom 等）、库（lib-xml）和架构校验，避免运行时爆 Class 'Redis' not found。
- 正确用法：
composer install --ignore-platform-req=php或composer update --ignore-platform-req=php - 多个扩展要忽略？分开写：
--ignore-platform-req=ext-gd --ignore-platform-req=ext-xml，逗号分隔无效 - 千万别用
--ignore-platform-reqs（带 s）：它会一并跳过所有扩展检查，CI 构建后上线必崩 - 拼写必须准确：
--ignore-platform-req（不带 s）会被 Composer 完全忽略，不报错也不生效
锁文件冲突或哈希失败？三件套一起清
Git 合并 composer.lock 出现冲突，或报 hash verification failed，本质是 lock 文件和当前环境/镜像不一致，不能只删 vendor/。
立即学习“PHP免费学习笔记（深入）”；
- 先备份：
cp composer.lock composer.lock.bak - 干净合并
composer.json中的require和require-dev块（去重、排序、保留注释） - 删掉
composer.lock和vendor/ - 再跑：
composer install --ignore-platform-req=php—— 它会重算依赖图并生成新 lock - 如果只想最小变动，加
--minimal-changes（Composer 2.2+）：composer update --minimal-changes --ignore-platform-req=php
长期协作中更稳妥的替代方案
硬跳过只是临时解法。团队共用 PHP 8.0 环境时，应让 composer.lock 反映真实平台能力，而不是靠每次加参数掩盖问题。
- 临时覆盖（不写入文件）：
composer install --platform=php:8.0.30，比全局忽略更可控 - 永久声明（写入
composer.json）："config": {"platform": {"php": "8.0.30"}}—— 注意必须写完整小版本号，"php": "8.0"会解析失败 - 私有包升级了
require却没同步通知？用composer show vendor/package对比它当前requires列表和composer show --tree里实际锁死的版本，差值就是隐患点
真正难处理的永远不是 PHP 版本本身，而是 conflict 字段的硬拦截、replace 声明的隐式覆盖，以及 require-dev 里测试工具拖着老依赖不放——这些和 PHP 版本无关，但会在你加了 --ignore-platform-req=php 后突然暴露出来。
