必须用--ignore-platform-req=php精准跳过php版本校验，而非--ignore-platform-reqs（会连扩展一并跳过导致运行时崩溃）；优先确认php -v与composer diagnose | grep "php binary"路径一致，不一致则用完整路径执行如/usr/bin/php8.2 composer install。
composer install 报 “Your PHP version does not satisfy that requirement” 怎么办
这不是网络或权限问题，是 Composer 用当前 php -v 输出的版本，硬校验 composer.json 里 "php": "^8.1" 这类声明，不匹配就直接退出——连依赖树都不算。
常见错误信息里明确带 php ^8.2、php >=8.3 字样 → 纯 PHP 版本冲突，--ignore-platform-req=php 就能精准跳过，不碰 ext-* 校验。
别一上来就加 --ignore-platform-reqs（注意末尾带 s），它会同时跳过所有扩展、lib、架构检查，运行时大概率报 Class 'Redis' not found 或 ParseError: unexpected token "match"。
- 先确认真实 PHP 版本：
php -v和which php（Linux/macOS）或where php（Windows）必须一致 - 再看 Composer 实际用哪个 PHP：
composer diagnose | grep "PHP binary" - 如果路径不一致（比如你切了
php8.2，但 Composer 还调用/usr/bin/php），直接用完整路径执行：/usr/bin/php8.2 composer install
为什么改了系统 PHP 版本，composer install 还报旧版本错误
因为 Composer 不一定读你终端里 php -v 的结果，它可能被 alias、PATH 顺序、宝塔/PhpWebStudy 的 wrapper 脚本劫持，或者 CI 环境里没 reload shell 配置。
config.platform.php 是个“伪装”配置，只影响依赖解析，不改变运行时。本地是 PHP 7.4 却设 "platform": {"php": "8.2"}，composer install 能过，但一跑 match 表达式就 Fatal error。
- 这个配置只该用于 CI 打包或开发机为高版本生产环境预生成 vendor，**不能提交到团队仓库**
- 设了之后必须立刻跑
composer update --lock，否则composer.lock还记着旧平台选的包 - 查 Composer “认为”的 PHP 版本：用
composer show --platform，不是php -v
多个 PHP 版本共存时，怎么让 Composer 明确按目标版本装包
最稳的方式是绕过环境变量干扰，直接指定 PHP 二进制路径执行命令。
Linux/macOS：/usr/bin/php8.2 composer install（路径以 ls /usr/bin/php* 为准）
Windows："C:\php\php82\php.exe" composer install（引号不能少，路径含空格也安全）
- CI 脚本中务必前置
php -v和which php打日志，否则排查成本翻倍 - 别依赖
update-alternatives或 Homebrew 切全局 PHP，容易污染其他项目 - 如果项目已存在
composer.lock，且它是在 PHP 8.2 下生成的，那 PHP 7.4 环境下即使加--ignore-platform-req=php也可能装出不兼容的包（比如用了 PHP 8.2 语法的依赖）
扩展缺失和版本过高/过低混在一起报错，怎么拆解处理
错误日志里如果同时出现 php ^8.1 和 ext-gd is missing，说明问题不止一个。别一股脑上 --ignore-platform-reqs。
先分清主次：运行 composer install -v，看第一行报错卡在哪条约束上。Composer 是从上到下校验的，第一个失败的就是它最先拦住你的点。
- 如果是
php先报错，就先加--ignore-platform-req=php - 如果过了 PHP 校验但卡在
ext-redis，再单独加--ignore-platform-req=ext-redis - 多个扩展要忽略，重复写多次
--ignore-platform-req=，比如：--ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring（逗号分隔无效） - 拼写必须严格：
--ignore-platform-reqs（带s）才合法；--ignore-platform-req（不带s）会被忽略，不报错也不生效
真正麻烦的是那种“PHP 版本刚好卡在边界上”的情况：比如项目 require "php": "^8.0"，你本地是 8.3，但某个依赖的某个小版本只声明支持 "php": " ——这时 <code>--ignore-platform-req=php 只是绕过顶层校验，Composer 还会在内部做兼容性推导，仍可能无解。这种就得去查具体是哪个包拖后腿：composer depends --tree vendor/package，再手动锁版本或换分支。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
