Composer实际调用的PHP版本由PATH决定，与php -v不一致通常因环境变量未刷新或存在alias干扰；需用which php和composer diagnose确认实际路径，并通过直接指定php路径（如/usr/bin/php8.2 composer install）强制统一。
Composer 报错说 PHP 版本不满足，但 php -v 显示的版本明明是对的——问题几乎一定出在 Composer 实际调用的 PHP 解释器和你终端里看到的不是同一个。
为什么 composer install 用的不是 php -v 的版本？
Composer 是一个 PHP 脚本（composer.phar），它启动时会找系统里第一个可用的 php 命令。这个“第一个”由 PATH 环境变量顺序决定，和你在当前 shell 执行 php -v 时看到的，可能根本不是同一个可执行文件。
- 运行
which php和phpenv which php（如果你用 phpEnv）对比输出，不一致就说明 PATH 混乱 - Windows 下常见情况：
where php返回C:\Windows\php.exe（旧版），而 phpEnv 激活的是C:\phpenv\versions\8.2.15\php.exe - Composer 启动时不走 phpEnv 的 PATH 注入逻辑，尤其在 GUI 终端或 IDE 内置终端中更易复现
如何强制 Composer 使用指定 PHP 版本？
不依赖环境变量，直接把 PHP 可执行路径塞给 Composer，最稳。
- Linux/macOS：
/usr/bin/php8.2 composer install（路径以ls /usr/bin/php*实际结果为准） - Windows：
"C:\phpenv\versions\8.2.15\php.exe" composer install（注意引号，路径含空格时必须） - 验证是否生效：加
-v参数，输出第一行会显示Running 8.2.15 (loader: ...) with php - 别用
php -d临时改配置——Composer 自身不读这些 ini 设置，只影响后续加载的 PHP 代码
composer config platform.php 是个障眼法，别信它
这个配置只是让 Composer 在解析依赖时“假装”运行在某个 PHP 版本下，它完全不影响实际运行时的 PHP 解释器选择，也不改变 php -v 输出。
立即学习“PHP免费学习笔记（深入）”；
- 设了
"platform": {"php": "8.1.0"}后composer install成功，但运行时报Undefined constant或ParseError？说明真正在跑的还是 PHP 7.4 - CI 脚本里写这个配置，却没同步切换系统 PHP 版本，等于埋雷
- 真正要改的是运行环境：Dockerfile 用
FROM php:8.2-cli，GitHub Actions 用setup-php动作，本地用phpenv use 8.2并确认生效
phpEnv 用户特别注意 PATH 和全局 bin-dir
phpEnv 的 PATH 注入只对它自己启动的 CMD 有效；手动打开的终端、IDE、Git Bash 都不受控。
- 检查
echo $PATH（Linux/macOS）或echo %PATH%（Windows）是否包含 phpEnv 的versions/8.2.15目录 - 全局命令（如
laravel new）失效？先看composer global config bin-dir返回路径是否可写，再确认该路径已加入系统 PATH（不是用户 PATH） - 推荐做法：删掉
composer global config -g bin-dir的旧值，重设为%USERPROFILE%\bin，并把它加进系统 PATH
最常被忽略的一点：Web 服务器（Apache/Nginx）和 CLI 的 PHP 是两套独立进程，php -v 正确不代表 phpinfo() 也正确；Composer 错误只反映 CLI 层，但类加载失败可能跨层发生——务必分开验证。
