因为Composer默认调用PATH中第一个php而非项目运行时PHP，导致版本校验错配；应使用PHP_BINARY环境变量指定绝对路径，如PHP_BINARY=/opt/homebrew/bin/php composer install --dry-run，该变量被Composer原生识别且仅作用于当前命令。
为什么 composer install 报错说 PHP 版本不匹配？
因为 Composer 默认调用系统 PATH 中第一个 php，而不是你项目实际运行时用的那个。比如你在终端里 which php 看到的是 /usr/local/bin/php（8.2），但 Web 服务器跑的是 /opt/homebrew/bin/php（8.1）——Composer 检查时就按前者来，结果 platform.php 配置或依赖的 php 版本约束就可能被绕过或误判。
如何让 Composer 用指定 PHP 二进制执行自检？
直接在命令前加 PHP_BINARY 环境变量，它会覆盖 Composer 内部所有对 PHP 的调用（包括 composer validate、composer install --dry-run、甚至插件里的 exec('php ...')）：
PHP_BINARY=/opt/homebrew/bin/php composer install --dry-run
这个变量只影响当前命令，不污染全局，比改 PATH 安全得多。注意：不是 PHP_PATH 或 PHP_EXECUTABLE，只有 PHP_BINARY 被 Composer 原生识别。
- 必须是完整绝对路径，相对路径或别名（如
php81）无效 - 路径下文件需有执行权限，且
php -v能正常输出版本号 - 如果脚本里用了
proc_open或shell_exec调用 PHP，它们不受PHP_BINARY影响，得手动替换
composer diagnose 为啥没报 PHP 版本问题？
因为 composer diagnose 只检查 Composer 自身环境（如网络、cache、git），并不解析 composer.json 中的 platform.php 或校验依赖兼容性。真正做 PHP 版本校验的是 install、update、validate 这几个命令。
立即学习“PHP免费学习笔记（深入）”；
-
composer validate --strict会检查platform.php是否与当前 PHP 匹配，此时PHP_BINARY同样生效 -
composer show --platform显示的是当前实际运行的 PHP 版本，不是platform.php配置值 - CI 场景下建议把
PHP_BINARY写进.env或 CI 脚本，避免本地和远程行为不一致
Windows 下怎么指定 PHP 路径？
语法一样，但路径要用反斜杠或正斜杠都行，关键是不能带空格或需要引号——Windows 的 cmd 对引号处理很脆，推荐用 PowerShell 或 Git Bash：
$env:PHP_BINARY="C:\php\php-8.1.22\php.exe"; composer install --dry-run
或者更稳妥的写法（Git Bash / WSL）：
PHP_BINARY="/c/php/php-8.1.22/php.exe" composer install --dry-run
- PowerShell 中变量赋值后需在同一行执行命令，否则变量作用域仅限当前语句
- 如果 PHP 路径含空格（如
C:\Program Files\php\php.exe），PHP_BINARY会失败，必须重装到无空格路径 - WSL 用户注意：Windows 的 PHP 二进制不能在 WSL 里直接运行，得用 WSL 自己装的 PHP
-vvv 看日志里有没有 Running xdebug-check with /path/to/php 这类输出，不然你以为生效了，其实还是在用旧版本。 
