Composer报错因PHP版本不匹配，它只检测当前shell调用的PHP版本，需通过切换环境、绝对路径调用或配置platform模拟来解决。
composer install 报错 “This package requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement”
这是最典型的版本冲突信号，composer install 读取 composer.json 中的 php 平台配置（如 "php": "^8.1"），再拿当前 CLI 的 PHP 版本去比对。它不看你系统默认 PHP 是多少，只看执行 composer 命令时背后调用的是哪个 php 可执行文件。
- 先确认 composer 正在用哪个 PHP：
composer --version输出里会带 PHP 版本；或直接运行php -v看当前 CLI 版本 - 如果你装了多个 PHP（比如 via
phpbrew、asdf、brew install php@8.1），得先切到目标版本再跑composer install - 别指望靠
COMPOSER_PHP环境变量临时指定——这个变量不存在，composer 不认 - 常见误操作：改了
PATH但忘了hash -r（bash）或重启终端，导致仍调用旧版php
如何让 composer 固定使用某个 PHP 路径（比如 /usr/local/bin/php81）
composer 本身没有内置“PHP 解释器路径配置”，但它会忠实地调用当前 shell 环境下的 php 命令。所以控制权在你手里，不是 composer 的问题。
- 最稳的方式：用绝对路径调用 composer：
/usr/local/bin/php81 /usr/local/bin/composer install - 或者 alias 一个专用命令：
alias composer81='/usr/local/bin/php81 /usr/local/bin/composer'，然后用composer81 install - 别改
composer脚本头部的#!/usr/bin/env php—— 升级 composer 会覆盖掉，且不跨平台 - 某些 IDE（如 PhpStorm）允许为每个项目单独设置 PHP 解释器路径，这会影响其内嵌 terminal 的
php环境，记得检查设置里的 CLI interpreter
为什么 vendor/autoload.php 在 PHP 8.1 下能跑，换到 8.2 就报错？
autoload 本身不挑 PHP 版本，但依赖包的代码可能用了新版本才支持的语法或废弃了的函数。Composer 的平台配置（config.platform.php）就是干这个的：它骗 composer “我运行在某个 PHP 版本上”，从而影响依赖解析结果。
- 比如你在 PHP 8.2 环境下想装只兼容 8.1 的包，可以加一行：
"config": {"platform": {"php": "8.1.25"}}到composer.json - 注意：这只会改变依赖安装时的版本选择逻辑，不会阻止运行时报错。如果某包用了
match表达式（PHP 8.0+），但在 8.1 下被装进来了，8.2 运行当然没问题；但如果它用了 8.2 新增的random_bytes()参数，在 8.1 下就挂了 -
config.platform.php是开发期的“模拟”，不是运行期的兼容层。真要多版本共存，得靠实际切换 PHP 执行环境
用 asdf 或 phpbrew 管理多 PHP 版本时，composer 总调错版本
这类版本管理器本质是动态修改 PATH，但 composer 往往缓存了 php 的查找路径，或你在不同 shell 里没同步激活状态。
立即学习“PHP免费学习笔记（深入）”；
- 每次切换 PHP 后，务必运行
asdf reshim（asdf）或phpbrew switch xxx（phpbrew），然后验证which php和php -v - 如果用 zsh，检查
~/.zshrc是否漏了asdf plugin-add php或phpbrew init对应的初始化段落 - CI/CD 场景下（如 GitHub Actions），不能依赖交互式激活，得显式用
php81 -d memory_limit=-1 composer install这类写法 - Mac 上通过 Homebrew 安装多个 PHP（
php@8.1,php@8.2）时，注意它们的bin目录是否被正确加入PATH，brew unlink php再brew link php@8.1是常用救急手段
php 是谁。所有“指定版本”的操作，本质都是在控制这个查找过程。 
