应切换php cli版本至8.1+而非降级约束或忽略检查，因composer严格校验php字段且高版本语法在7.4下无法解析。
composer install 报错 “requires php ^8.1” 但本地是 PHP 7.4
这是最典型的版本不匹配：Composer 读取 composer.json 中的 php 约束（比如 "php": "^8.1"），发现当前 CLI 的 PHP 版本不满足，直接中断。不是 Composer 自身版本问题，而是它在替你校验项目依赖的 PHP 环境底线。
实操建议：
- 先确认当前 CLI 使用的 PHP 版本：
php -v，注意不是 apache/nginx 里跑的那个，是终端里执行命令时用的 - 检查
composer.json顶层require下的php字段，例如："php": "^8.1"—— 这表示最低需 PHP 8.1.0，7.4 完全不兼容 - 不要盲目改
composer.json里的 PHP 版本约束，很多包（如 laravel 10+、symfony 6+）已彻底放弃对 7.x 的支持，硬降会引发后续更多报错 - 优先切换系统默认 PHP CLI 版本（macos 用
brew link php@8.2，ubuntu 用update-alternatives --config php），而不是临时加--ignore-platform-reqs
用了 –ignore-platform-reqs 后 composer install 成功，但运行时报 Fatal Error
这个参数只是让 Composer 跳过 PHP 版本、扩展等平台检查，不等于代码真能跑。PHP 8.1 新增的语法（如枚举、只读类）、废弃的函数（create_function）、类型系统变化（联合类型、mixed），在 7.4 下直接解析失败。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
-
ParseError: syntax error, unexpected Token "enum"—— 枚举在 7.4 不支持 -
Fatal error: Uncaught TypeError: ... must be of the type String|int, NULL given—— PHP 8.0+ 更严格的类型推导暴露了旧代码隐患 - 某些包的
autoload规则依赖 PHP 8+ 的特性，自动加载器根本初始化不了
这不是 Composer 的锅，是环境和代码实际能力不匹配。绕过检查 ≠ 解决问题。
多版本 PHP 共存时，composer 用的是哪个 PHP？
Composer 本身是 PHP 脚本，它**完全继承当前 shell 执行 php 命令所指向的二进制文件**。也就是说：which php 返回啥，Composer 就用啥；php -v 输出啥，Composer 就按啥做平台校验。
容易踩的坑：
- Mac 上用 Homebrew 装了多个 PHP（
php@7.4,php@8.2），但brew unlink php@7.4 && brew link php@8.2后忘了重开终端，php -v仍显示旧版 - linux 用
update-alternatives切换了php，但没同步更新php-config和phpize，导致扩展编译失败，间接影响 Composer 安装含扩展依赖的包 - ide（如 phpstorm）内置终端可能缓存了旧 PATH，需要重启 IDE 或手动
source ~/.zshrc
vendor/autoload.php require 失败：class not found 却没报任何 Composer 错误
这往往发生在你用高版本 PHP 装完依赖，却用低版本 PHP 运行脚本。Composer 安装时生成的自动加载映射（vendor/composer/autoload_classmap.php）会根据当前 PHP 版本和扩展情况动态生成。PHP 7.4 加载一个为 PHP 8.2 生成的 classmap，可能因常量/函数不可用而静默失败，最终 class_exists 返回 false。
验证方式：
- 删掉
vendor/和composer.lock，确保干净 - 用目标运行环境的 PHP 版本执行
composer install（比如线上是 8.1，就用 8.1 装） - 检查
vendor/composer/autoload_static.php开头的注释，里面会写明生成时的 PHP 版本和扩展列表
跨版本混用 vendor/ 目录，比跨版本混用 composer.lock 更危险——前者是二进制级不兼容。